환경 변수
Ren'Py는 동작을 조정하는 여러 환경 변수를 지원합니다. 이 변수들은 Ren'Py 버전에 따라 변경되거나 제거될 수 있습니다.
다음 환경 변수로 Ren'Py의 동작을 제어합니다.
- RENPY_DEBUG_SOUND
설정하면 오디오 오류가 발생할 때 예외를 발생시킵니다.
- RENPY_DISABLE_JOYSTICK
설정하면 조이스틱 감지를 비활성화합니다. 조이스틱의 오작동으로 게임이 원치 않게 진행될 때 사용하세요.
- RENPY_DISABLE_FULLSCREEN
설정하면 전체 화면 모드로 전환하지 않습니다.
- RENPY_DISABLE_SOUND
소리 재생을 막습니다. 값에 "pss"가 들어 있으면 소리가 재생되지 않습니다.
- RENPY_DRAWABLE_RESOLUTION_TEXT
0으로 설정하면 화면의 실제 해상도로 텍스트를 그리지 않습니다.
- RENPY_EDIT_PY
텍스트 편집기를 실행하는 방법을 정의한 .edit.py 파일의 경로입니다. 자세한 내용은 텍스트 편집기 연동을 참고하세요.
- RENPY_GL_ENVIRON
OpenGL 텍스처 환경을 설정합니다.
- RENPY_GL_RTT
OpenGL의 텍스처 렌더링 방식을 설정합니다.
- RENPY_GL_VSYNC
디스플레이의 수직 주사율에 동기화할지 정합니다. 동기화하면 화면 찢어짐을 방지하지만 프레임 속도가 낮아질 수 있습니다. "0"이면 동기화를 끄고, "1"이면 매 수직 갱신에 동기화합니다.
- RENPY_LANGUAGE
설정하면 Ren'Py에서 사용할 번역 언어를 지정합니다.
- RENPY_LESS_MEMORY
실행 속도를 일부 낮추는 대신 메모리 사용량을 줄입니다.
- RENPY_LESS_MOUSE
마우스를 항상 비활성화합니다.
- RENPY_LESS_PAUSES
{p}와 {w} 텍스트 태그에 의한 대기를 비활성화합니다.
- RENPY_LESS_UPDATES
화면 갱신 횟수를 줄입니다.
- RENPY_LOG_EVENTS
설정하면 pygame 형식의 이벤트를 log.txt에 기록합니다. 성능은 저하되지만 일부 문제를 디버깅할 때 도움이 될 수 있습니다.
- RENPY_MULTIPERSISTENT
여러 게임에서 공유하는 영구 데이터를 저장할 디렉터리 경로입니다.
- RENPY_NO_STEAM
환경에 이 변수가 있으면 Steamworks를 초기화하지 않습니다.
- RENPY_OPEN_FILE_ENCODING
renpy.open_file()의 기본 인코딩을 설정합니다. 주로 Python 2 게임을 Python 3 기반 Ren'Py에서 실행할 때 사용합니다. "utf-8"이나 "latin-1"을 지정해 도움이 되는지 확인해 보세요. 최신 게임을 실행할 때는 원래대로 되돌려야 합니다.
- RENPY_PATH_TO_SAVES
Ren'Py 저장 파일을 보관할 디렉터리 경로입니다. 각 게임의 실제 저장 파일은 그 아래 게임별 하위 경로에 저장됩니다.
- RENPY_SCREENSHOT_PATTERN
스크린샷 파일 이름을 만드는 패턴입니다. %d 치환 항목을 정확히 하나 포함해야 합니다. 예를 들어 "screenshot%04d.jpg"로 설정하면 기본 PNG 대신 JPEG 형식으로 저장합니다.
기본적으로 게임의 기본 디렉터리를 기준으로 해석합니다. 절대 경로를 지정하면 파일 시스템의 다른 위치에도 저장할 수 있습니다.
- RENPY_SEARCHPATH
설정하면 이중 콜론(::)으로 구분한 추가 경로를
config.searchpath에 넣습니다.
- RENPY_SIMPLE_EXCEPTIONS
설정하면 Ren'Py의 그래픽 예외 처리 화면을 비활성화합니다.
- RENPY_SKIP_MAIN_MENU
설정하면 메인 메뉴를 건너뜁니다.
- RENPY_SKIP_SPLASHSCREEN
설정하면 스플래시 화면을 건너뜁니다.
- RENPY_SOUND_BUFSIZE
오디오 버퍼 크기를 지정합니다. 기본값 2048보다 크게 설정하면 소리 끊김을 줄일 수 있지만, 재생 요청부터 실제 소리가 나기까지의 지연이 길어집니다.
- RENPY_TEST_VC_REVISION
자동화 테스트 프레임워크에 속한
_test.vc_revision의 기본값으로 사용합니다.
- RENPY_TIMEWARP
시간의 진행 속도를 바꿉니다. 예를 들어 0.5이면 절반 속도, 2.0이면 두 배 속도로 동작합니다.
- RENPY_USE_DRAWABLE_RESOLUTION
0으로 설정하면 디졸브 트랜스폼과 텍스트 렌더링 등을 화면의 실제 해상도 대신 게임의 가상 해상도로 처리합니다.
- RENPY_VARIANT
Ren'Py가 사용할 스크린 변형의 목록을 공백으로 구분해 지정합니다.
Ren'Py는 SDL을 사용하므로 SDL의 환경 변수로도 동작을 제어할 수 있습니다.
시작 시 Ren'Py는 renpy.exe나 renpy.py가 있는 디렉터리에서 environment.txt를 찾습니다. 파일이 있으면 Python 코드로 실행하고, 그 안에 정의한 값을 환경 변수의 기본값으로 사용합니다.