네임스페이스
Ren'Py는 네임스페이스로 변수와 메서드를 정리합니다. 이 문서는 주로 편집기가 자동 완성과 문서를 제공하는 데 도움이 되도록 Ren'Py에서 사용하는 네임스페이스 일부를 설명합니다.
- config:
Ren'Py의 설정을 제어하는 변수가 담긴 네임스페이스입니다. 이 변수는 초기화 시점에
init python블록이나define으로 설정해야 하며, 게임을 시작한 뒤에는 변경하지 않아야 합니다.
- define:
define 네임스페이스에는 화면 전환 모음 등 새로운 변수를 정의하는 함수가 있습니다.
- define gui
gui 네임스페이스에는 기본 GUI 시스템을 제어하는 함수가 있습니다. 이 변수들은 기본 GUI 시스템을 사용할 때만 의미가 있으며, 시스템을 교체했다면 사용되지 않을 수 있습니다. 번역이 바뀌면 gui 네임스페이스에 영향을 주는 define 문이 다시 실행됩니다.
- im
참고: im 네임스페이스의 함수 대부분은 사용이 권장되지 않습니다.
im 네임스페이스에는 CPU에서 이미지를 불러오거나 조작하는 이미지 매니퓰레이터가 있습니다. 여기 있는 함수 대부분의 작업은
Transform을 사용해 GPU에서 수행할 수 있습니다.
- layeredimage
레이어 이미지는 속성과 조건으로 표시할 이미지를 제어하면서 여러 이미지를 하나로 결합하는 방식입니다. layeredimage 네임스페이스에는 Python에서 레이어 이미지를 만들고 조작하는 클래스가 있으며,
layeredimage문과 같은 기능을 제공합니다.
- persistent
persistent 네임스페이스에는 영구 데이터가 들어 있습니다. 이 객체의 필드는 처음에 None이며, 저장 슬롯을 불러오지 않아도 게임 실행 간에 값이 유지됩니다.
persistent 객체 필드의 값은 불리언, 숫자, 문자열, 리스트, 튜플, dict, set과 같은 Python 기본 제공 형식이어야 합니다. 직접 정의한 클래스를 persistent 객체에 대입해서는 안 됩니다.
- preferences
환경설정 변수 네임스페이스에는 환경설정을 담는 변수가 있습니다. 값을 읽고 설정할 수 있지만, 가장 흔한 사용법은 다음과 같은 문법의
default문입니다.default preferences.fullscreen = True
- preferences.volume
환경설정 변수 네임스페이스에는 각 믹서의 기본 음량을 설정하는 변수가 있습니다. 다음과 같이
default문으로 설정해야 합니다.default preferences.volume.music = 0.5
- renpy
renpy 네임스페이스에는 Ren'Py 엔진 자체에 속하는 함수와 클래스가 있습니다. Ren'Py 언어의 문과 같은 기능을 하거나, 별도의 문을 만들 필요까지는 없는 기능을 제공할 수 있습니다.
- renpy.sound
renpy.audio.sound 네임스페이스에는 오디오 시스템을 제어하는 함수가 있습니다. 기본적으로 sound 채널에 작동합니다. 대부분의 함수는 대응하는 renpy.music 함수 아래에 설명되어 있습니다.
- style
style 네임스페이스에는 스타일과 스타일을 조작하는 함수가 있습니다. 스타일은 Ren'Py에서 텍스트, 이미지 등의 모양을 제어합니다. style 네임스페이스에 직접 접근하기보다는
style문을 사용하는 것이 좋습니다.
- ui
참고: ui 네임스페이스의 함수 대부분은 사용이 권장되지 않습니다.
ui 네임스페이스에는 사용자 인터페이스 요소를 표시하는 데 사용하던 이전 함수와 클래스가 있습니다. ui.adjustment, ui.interact, ui.callsinnewcontext, ui.invokesinnewcontext를 제외한 함수들은 더 이상 사용하지 않습니다.
- updater
updater 네임스페이스에는 HTTP/HTTPS를 제어하는 함수, 클래스, 변수가 있습니다.