환경설정 변수
환경설정 변수는 Ren'Py 환경설정의 값을 저장합니다. 실행 중에 환경설정 값을 바꿀 때는 Preference() 액션을 사용해야 하지만, 기본값은 환경설정 변수와 default 문으로 설정해야 합니다.
예를 들어 다음 코드는
default preferences.text_cps = 40
기본 텍스트 속도를 초당 40자로 설정합니다. default 문은 환경설정을 설정한 이후 기본값이 바뀐 경우에만 값을 설정합니다. 예를 들어 플레이어가 속도를 50으로 바꾸면 이후 게임을 실행할 때도 50이 유지됩니다. 업데이트에서 기본값을 42로 바꾸면 플레이어의 설정도 42로 바뀝니다. 플레이어는 이후 다시 변경할 수 있습니다.
- preferences.afm_after_click = False
True이면 클릭한 뒤에도 자동 진행 모드를 유지합니다. False이면 클릭 시 자동 진행 모드를 끝냅니다. "auto-forward after click" 환경설정에 해당합니다.
- preferences.afm_enable = False
True이면 자동 진행 모드가 켜져 있고, 그렇지 않으면 False입니다. "auto-forward time" 환경설정에 해당합니다.
- preferences.afm_time = 15
자동 진행 모드에서 기다릴 시간입니다. 숫자가 클수록 느립니다. 대사 길이도 속도 계산에 반영하므로 실제 시간으로 환산하는 과정은 복잡합니다. "auto-forward" 환경설정에 해당합니다.
- preferences.desktop_rollback_side = "disable"
데스크톱 플랫폼에서 창의 이쪽을 터치하거나 클릭하면 롤백합니다. "left", "right", "disable" 중 하나입니다. 데스크톱 플랫폼의 "rollback side" 환경설정에 해당합니다.
- preferences.mobile_rollback_side = "disable"
모바일 플랫폼에서 창의 이쪽을 터치하거나 클릭하면 롤백합니다. "left", "right", "disable" 중 하나입니다. 모바일 플랫폼의 "rollback side" 환경설정에 해당합니다.
- preferences.language = None
플레이어가 게임 실행에 사용하도록 선택한 언어입니다. 기본 언어이면 None이고, 그렇지 않으면 게임이 번역된 언어를 담은 문자열입니다.
기본 언어를 설정하거나 현재 언어를 읽는 데 사용할 수 있습니다. 언어를 바꾸려면
Language()액션을 사용할 수 있습니다.자세한 내용은 번역을 참고하세요.
- preferences.emphasize_audio = False
True이면 다른 채널의 음량을 낮춰
config.emphasize_audio_channels에 지정된 오디오 채널을 강조합니다. 예를 들어 음성이 재생될 때 음악의 음량을 낮춥니다. False이면 이렇게 처리하지 않습니다.
- preferences.fullscreen = False
Ren'Py가 전체 화면 모드이면 True, 창 모드이면 False입니다. "display" 환경설정에 해당합니다.
- preferences.gl_framerate = None
정수 또는 None입니다. None이 아니라면 Ren'Py가 달성하려고 시도할 목표 프레임 속도입니다. 높은 프레임 속도의 모니터, 예를 들어 초당 60프레임 모니터에서 이 값을 30처럼 낮게 설정하면 Ren'Py는 한 프레임씩 건너 그립니다.
None이면 모니터의 최대 프레임 속도로 그리려고 시도합니다.
- preferences.gl_powersave = True
화면 내용이 바뀌지 않을 때 얼마나 자주 다시 그릴지 결정합니다. True이면 초당 5번만 그립니다. False이면 항상 가능한 최대 프레임 속도로 그립니다.
- preferences.gl_tearing = False
게임이 목표 프레임 속도를 유지할 수 없을 때 화면 찢어짐(True)과 프레임 건너뛰기(False) 중 어느 동작을 선호할지 결정합니다.
- preferences.mouse_move = True
True이면 선택된 버튼으로 마우스를 자동 이동합니다. False이면 이동하지 않습니다. "automatic move" 환경설정에 해당합니다.
- preferences.show_empty_window = True
True이면 window show와 window auto 문이 작동합니다. False이면 이 문들을 비활성화합니다. "show empty window" 환경설정에 해당합니다.
- preferences.skip_after_choices = False
True이면 선택지 이후에도 건너뛰기를 재개합니다. False이면 선택지에서 건너뛰기를 중단합니다. "after choices" 환경설정에 해당합니다.
- preferences.skip_unseen = False
True이면 모든 텍스트를 건너뜁니다. False이면 플레이어가 어느 실행에서든 읽은 텍스트만 건너뜁니다. "skip" 환경설정에 해당합니다.
- preferences.text_cps = 0
텍스트 표시 속도입니다. 0이면 제한이 없으며, 그 밖의 값은 초당 표시할 글자 수입니다. "text speed" 환경설정에 해당합니다.
- preferences.transitions = 2
어떤 화면 전환을 표시할지 결정합니다. 2이면 모두 표시하고, 0이면 표시하지 않습니다. 1은 예약되어 있습니다. "transitions" 환경설정에 해당합니다.
- preferences.video_image_fallback = False
True이면 동영상 스프라이트 대신 이미지를 표시합니다. False이면 동영상 스프라이트를 정상적으로 표시합니다. "video sprites" 환경설정의 반대 값에 해당합니다.
- preferences.voice_sustain = False
True이면 음성이 끝나거나 다른 음성으로 대체될 때까지 계속 재생합니다. False이면 다음 대사로 넘어갈 때 음성을 끝냅니다. "voice sustain" 환경설정에 해당합니다.
- preferences.wait_voice = True
True이면 자동 진행 모드가 음성 파일과 자체 음성 출력이 끝날 때까지 기다린 뒤 진행합니다. False이면 기다리지 않습니다. "wait for voice" 환경설정에 해당합니다.
- preferences.system_cursor = False
True이면
config.mouse와config.mouse_displayable값을 무시하고 시스템 커서를 강제로 사용합니다. False이면 강제하지 않습니다. "system cursor" 환경설정에 해당합니다.
- preferences.audio_when_minimized = True
False이면 창을 최소화할 때 오디오 채널을 멈추고 창을 복원하면 재개합니다. True이면 창 상태가 오디오에 영향을 주지 않습니다. "audio when minimized" 환경설정에 해당합니다.
- preferences.audio_when_unfocused = True
False이면 창이 키보드 포커스를 잃을 때 오디오 채널을 멈추고 포커스를 되찾으면 재개합니다. True이면 키보드 포커스가 오디오에 영향을 주지 않습니다. "audio when unfocused" 환경설정에 해당합니다.
- preferences.web_cache_preload = False
True이면 게임 파일을 웹 브라우저 캐시에 불러와 오프라인으로 플레이할 수 있게 합니다. False이면 캐시에 불러오지 않으므로 플레이하려면 인터넷 연결이 필요합니다. "web cache preload" 환경설정에 해당합니다.
True이면 게임 메뉴를 표시한 뒤에도 음성을 계속 재생합니다. False이면 게임 메뉴를 표시할 때 음성을 멈춥니다. "voice after menu" 환경설정에 해당합니다.
- preferences.restore_window_position = True
True이면 게임을 다시 시작할 때 창 위치를 복원하려고 시도합니다. False이면 복원을 시도하지 않습니다. "restore window position" 환경설정에 해당합니다.
- preferences.force_mono = False
True이면 스테레오 오디오를 모노로 혼합한 뒤 재생합니다. False이면 스테레오 오디오를 그대로 재생합니다.
믹서 기본값
이 변수들은 default 문으로만 설정할 수 있습니다.
- preferences.volume.main = 1.0
main 믹서의 기본 음량입니다. 채널별 믹서에 더해 모든 채널에 적용됩니다. 0.0부터 1.0 사이의 숫자여야 하며, 1.0이 최대 음량입니다.
- preferences.volume.music = 1.0
music과 movie 채널에 사용하는 music 믹서의 기본 음량입니다. 0.0부터 1.0 사이의 숫자여야 하며, 1.0이 최대 음량입니다.
- preferences.volume.sfx = 1.0
sound와 audio 채널에 사용하는 sfx 믹서의 기본 음량입니다. 0.0부터 1.0 사이의 숫자여야 하며, 1.0이 최대 음량입니다.
- preferences.volume.voice = 1.0
voice 채널, 즉 voice 문과 자동 음성 등에 사용하는 voice 믹서의 기본 음량입니다. 0.0부터 1.0 사이의 숫자여야 하며, 1.0이 최대 음량입니다.
renpy.music.register_channel()로 정의한 채널을 사용한다면 preferences.volume.`mixer` 문법으로 기본 음량을 설정할 수 있습니다. 여기서 mixer는 믹서 이름입니다.
예를 들어 다음 코드는 music 믹서를 75%, sfx 믹서를 50%로 설정합니다.
default preferences.volume.music = 0.75
default preferences.volume.sfx = 0.5
믹서 함수
믹서에 관한 자세한 내용은 음량을 참고하세요.
- preferences.set_mixer(mixer, volume)
mixer의 음량을 volume으로 설정합니다.
- mixer
믹서 이름을 나타내는 문자열입니다. 기본 믹서는 "main", "music", "sfx", "voice"이며, "main"은 특수 믹서입니다.
- volume
0.0부터 1.0 사이의 숫자입니다. 0.0은 -40 dB(전력), 1.0은 0 dB(전력)입니다.
- preferences.get_mixer(mixer)
mixer의 음량을 가져옵니다. 음소거 상태이면 0.0을 반환합니다. 반환값은 0.0부터 1.0 사이의 숫자이며, 0.0은 -40 dB(전력), 1.0은 0 dB(전력)입니다.
- preferences.set_mute(mixer, mute)
mixer의 음소거 설정을 바꿉니다. mute가 참이면 음소거합니다. mute가 거짓이면 음소거 전의 음량으로 되돌립니다.
- preferences.get_mute(mixer)
mixer의 음소거 설정을 가져옵니다.