命名空間

Ren’Py使用命名空間(namespace)來組織各種變數、函數和方法。本頁包含Ren’Py已經定義的各種命名空間，主要用於幫助文件編輯者。

achievement

該命名空間的函數用於解鎖和管理 成就，同時集成了Steamworks庫的很多內容。

bubble:

該命名空間包含的變數，用於控制 氣泡式對話 的顯示效果。

build:

該命名空間包含的變數，用於控制 構建發行版流程。

config:

該命名空間包含的變數，用於控制Ren’Py的 配置資訊。 這些變數應該在遊戲啟動的初始化階段(在 init python 語句塊或使用 define 語句)進行修改。

define:

該命名空間包含的函數，用於定義新的變數，例如轉場的族群。

director:

該命名空間包含的函數，用於控制 互動式編導器，可以讓創作者在遊戲中直接添加圖片和音樂。

define gui

該命名空間包含的函數，用於控制 默認GUI系統。該命名空間中的變數僅在使用默認GUI系統時才會表現出效果。 如果創作者替換了GUI則不會使用。當遊戲中的多語言類型發生改變時，與gui命名空間有關的define語句會重新運行一遍。

iap

該命名空間包含的函數，用於控制 遊戲內購系統。

im

注意：該命名空間內的大部分函數都已棄用。

該命名空間包含所有圖像控制器，可以使用CPU載入和控制圖像。此處的大多數函數都可以使用 Transform 在GPU上實現。

layeredimage

層疊式圖像 可以將多個圖像合成為單一圖像，使用屬性(attribute)和條件語句控制具體顯示的內容。 該命名空間包含了所有的類，可以使用Python創建和控制層疊式圖像，等效於 layerdedimage 語句。

persistent

持久化對象中的欄位初始值為None，只要遊戲運行就始終保留值的修改結果，甚至讀檔都不影響持久化對象。

持久化對象中欄位的數據類型應該是Python支持的類型，比如布爾型、數值、字串、列表、元組和集合。 自訂類不能聲明為持久化對象。

preferences

該命名空間包含環境設定用到的各種變數。所有變數可讀可寫，因此常用 default 語句設置值，比如：

default preferences.fullscreen = True

preferences.volume

該命名空間包含各混音器的默認音量值。常用 default 語句設置值，比如：

default preferences.volume.music = 0.5

renpy

該命名空間包含Ren’Py引擎自帶的各種函數和類。這些函數和類基本都有等效的Ren’Py腳本語言語句。 也存在少量沒有Ren’Py語言語句，只能以Python函數形式使用的函數和類。

renpy.audio.filter

該命名空間包含的類和函數，用於創建 音訊濾波器。

renpy.music

該命名空間包含的函數，用於控制 音訊系統。這些函數預設用於music音訊通道。

renpy.sound

該命名空間包含的函數，用於控制 音訊系統。這些函數預設用於sound音訊通道。 大多數函數與renpy.music命名空間中的函數名稱和功能一樣。

style

該命名空間包含的樣式和函數，用於控制樣式(style)。樣式自身用於控制Ren’Py的文本、圖像等元素。 相比直接使用sytle命名空間中的函數，更推薦使用 style 語句。

ui

注意：該命名空間內的大部分函數都已棄用。

該命名空間包含的陳舊函數和類型，用於顯示UI元素。 除了ui.adjustment、ui.interact、ui.callsinnewcontext和ui.invokesinnewcontext，所有函數都已廢棄。

updater

該命名空間包含的函數、類和變數，用於控制 HTTPS/HTTP更新器。