環境變數
Ren’Py受一些環境變數的影響。在不同版本的Ren’Py中,這些環境變數可能會消失或者修改。
下列環境變數控制Ren’Py的行為表現:
- RENPY_DEBUG_SOUND
如果設置了該項,Ren’Py遇到音訊錯誤時會拋異常。
- RENPY_DISABLE_FULLSCREEN
如果設置了該項,Ren’Py會拒絕進入全螢幕模式。
- RENPY_DISABLE_SOUND
該項阻止播放聲音。如果變數中包含“pss”,禁用聲音播放功能。
- RENPY_DRAWABLE_RESOLUTION_TEXT
如果該項設為0,Ren’Py不會使用螢幕解析度繪製文本。
- RENPY_GL_ENVIRON
設置OpenGL紋理環境。
- RENPY_GL_RTT
設置OpenGL紋理渲染方法。
- RENPY_GL_VSYNC
該項決定了Ren’Py是否嘗試與顯示器的刷新率同步。(這樣設置可以用盡可能低的幀率防止畫面撕裂。)該項設置為“0”禁用同步,設置為“1”同步每一次刷新。
- RENPY_LANGUAGE
如果設置了該項,表示Ren’Py使用的語言。
- RENPY_LESS_MEMORY
該項讓Ren’Py減少記憶體消耗,代價是降低運行速度。
- RENPY_LESS_MOUSE
該項讓Ren’Py始終禁用滑鼠。
- RENPY_LESS_PAUSES
該項讓Ren’Py禁用文本標籤(tag){p}和{w}創建的暫停。
- RENPY_LESS_UPDATES
該項讓Ren’Py減少界面更新時界面的數量。
- RENPY_LOG_EVENTS
如果設置了該項,Ren’Py會在log.txt中記錄pygame樣式的事件。這樣做會影響性能,但對某些問題的debug可能有用。
- RENPY_MULTIPERSISTENT
Ren’Py多重持久化數據保存的目錄路徑。
- RENPY_NO_STEAM
如果在環境中設置了該項,則Ren’Py不會進行Steam相關的初始化。
- RENPY_OPEN_FILE_ENCODING
renpy.open_file()函數使用的默認編碼。 主要用於Ren’Py基於不同Python版本的文件編碼轉換問題。如果某些基於Python2的遊戲需要運載在Python3上,可以嘗試把該項設置為“utf-8”或“latin-1”。 (記得開發新版本的遊戲要把這項改回去。)
- RENPY_PATH_TO_SAVES
Ren’Py保存存檔的目錄路徑。實際存檔是在該路徑下各不同遊戲的子目錄中。
- RENPY_SCREENSHOT_PATTERN
用於創建截圖檔案名的正則表達式。它應該含有一個%d的替換。例如,該項設為“screenshot%04d.jpg”就能讓Ren’Py將截螢幕保護程式存為jpg文件,而不是常用的png文件。
- RENPY_SEARCHPATH
設置該項後,使用雙斜槓 (::) 分割的額外路徑列表將會被添加到
config.searchpath。
- RENPY_SIMPLE_EXCEPTIONS
設置該項後,禁用Ren’Py的圖形異常處理。
- RENPY_SKIP_MAIN_MENU
設置該項後,跳過主選單。
- RENPY_SKIP_SPLASHSCREEN
設置該項後,跳過splash畫面。
- RENPY_SOUND_BUFSIZE
該項控制聲音快取大小。超過預設值(2048)可以防止由於跳過(skip)而不能播放聲音的情況,代價是播放聲音時存在更大的時延。
- RENPY_TEST_VC_REVISION
該項用於自動化測試框架,是
_test.vc_revision的預設值。
- RENPY_TIMEWARP
該項可以將運行時間加快或減慢。例如,將timewarp設置0.5就能半速運行,而將timewarp設置為2.0就能2倍速運行。
- RENPY_USE_DRAWABLE_RESOLUTION
如果該項設為0,Ren’Py使用遊戲的虛擬解析度而不用螢幕原生解析度執行繪製操作(包括dissolve變換和文本渲染等)。
- RENPY_VARIANT
該項應該設置為Ren’Py希望使用的界面變種列表,列表內元素用空格分隔。
由於Ren’Py使用SDL,所以也受SDL環境變數的控制。
啟動時,Ren’Py會在Ren’Py目錄(包含renpy.exe或renpy.py文件的目錄)中尋找文件 environment.txt。如果找到了那個文件,Ren’Py會將文件以python文件行為解讀,並將文件配置用作環境變數的預設值。