環境設定配置存儲在Ren’Py的環境設定(preference)中。由於環境設定的值被設置為即時使用 Preference()
行為,環境設定配置應該使用default語句來設置環境設定的預設值。
舉例:
default preferences.text_cps = 142
設置預設的每秒顯示字元數為40。在環境設定值已經修改過的情況下,使用default語句修改環境設定值才會直接生效。例如,如果用戶將cps設置為50,以後運行時cps將保持為50。如果之後還有使用default語句修改cps為42,那麼用戶的設置就會修改為42。(之後用戶可以再次修改。)
preferences.afm_after_click
= False link若為True,自動前進模式在遇到點擊事件消息會保持。若為False,點擊會終止自動前進模式。等效於“auto-forward after click”環境設定設置。
preferences.afm_enable
= False link若為True,自動前進移動啟用。否則禁用。 等效於“auto-forward”環境設定。
preferences.afm_time
= 15 link自動前進模式的等待時間。這個值越大,等待時間越長。由於文本分段等消耗,轉為時鐘時間(wall time)的機制比較複雜。等效於“auto-forward”環境設定。
preferences.desktop_rollback_side
= “disable” link在桌面平台上,觸摸或點擊窗口邊欄就能觸發回滾。該項可以設置為“left”、“right”或者“disable”。等效於桌面平台上“rollback side”特性。
preferences.mobile_rollback_side
= “disable” link在移動平台上,觸摸或點擊窗口邊欄就能觸發回滾。該項可以設置為“left”、“right”或者“disable”。等效於移動平台上“rollback side”特性。
preferences.language
= None link遊戲運行時供玩家選擇的語言。 該值為None表示預設語言,也可以是字串,表示支持的其他語言。
該項用於設置預設語言類型,也可以讀取該值後決定當前使用語言。行為 Language()
可用於修改語言類型。
preferences.emphasize_audio
= False link若為True,Ren’Py會通過降低 config.emphasize_audio_channels
列表中之外的音訊通道音量,來加強那個列表中的通道。(例如,播放語音時降低音樂的音量)。若為False,就不做加強。
preferences.fullscreen
= False linkRen’Py使用全螢幕模式時設置為True,以窗口模型運行時設置為False。等效於“display”環境設定。
preferences.gl_framerate
= None link這項可能是一個整數,或者None。如果非None,這是Ren’Py希望達到的目標幀率。如果這項設置得比較低(例如,30),而顯示設備使用一個比較高的幀率,Ren’Py會每兩幀繪製一次圖像。
若為None,Ren’Py會嘗試使用顯示設備的當前最高幀率繪製圖像。
preferences.gl_powersave
= “auto” link這項決定了Ren’Py對未改變過的界面的重繪頻率。若為True,Ren’Py會每秒繪製界面5次。若為False,Ren’Py會儘可能以最高幀率繪製。若為“auto”,Ren’Py會在設備接通外置電源時使用最高幀率繪製,在設備使用電池運行時降低繪製頻率到5Hz。
preferences.gl_tearing
= False link這項決定了,無法使用預訂的幀率運行時,是使用拖慢(設置為True)還是跳幀(設置為False)。
preferences.mouse_move
= False link若為True,滑鼠指針會自動移動到選中的按鈕上。若為False,則不執行這種操作。等效於環境設定的“automatic mouse move”。
preferences.show_empty_window
= True link若為True,widown show和window auto語句將起作用。若為False,這些語句將不生效。等效於環境設定的“show empty window”。
preferences.skip_after_choices
= False link若為True,在某個選項之後會恢復跳過(skipping)模式。若為False,選項就會停止Ren’Py的跳過(skipping)模式。等效於環境設定的“after choices”。
preferences.skip_unseen
= False link若為True,Ren’Py會僅跳過未看過的文本。若為False,Ren’Py會跳過所有文本。等效於環境設定的“skip”。
preferences.text_cps
= 0 link文本顯示速度。0表示立刻顯示所有文本,否則表示每秒顯示的字元數。等效於環境設定的“text speed”。
preferences.transitions
= 2 link決定顯示何種轉場(transition)。2表示顯示所有轉場,0表示不顯示轉場。(1是預留值。)等效於環境設定的“transitions”。
preferences.video_image_fallback
= False link若為True,將使用圖片代替影片精靈(videosprite)。若為False,影片精靈會正常顯示。等效於環境設定的video sprites。
preferences.voice_sustain
= False link若為True,語音會保持播放直到結束,或另一句語音播放代替它。若為False,當對話進入下一行則語音播放也結束。等效於環境設定的“voice sustain”。
preferences.wait_voice
= True link若為True,自動前進模式會等待語音文件或自動語音播放之後再進入下一句。若為False,則不等待。等效於環境設定的“wait for voice”。
preferences.system_cursor
= False linkIf True, the system cursor is forced to be used, ignoring the
config.mouse
value. If False, it will not. The equivalent of the
“system cursor” preference.
若為True,強制使用系統滑鼠游標,忽略 config.mouse
的值。
若為False,則不執行這種操作。等效於“system cursor”設置。
preferences.
set_volume
(mixer, volume) link將混音器 mixer 的音量值設置為 volume 。
preferences.get_volume(mixer):
獲取混音器 mixer 的音量。如果該混音器被靜音了,則返回0.0。
preferences.set_mute(mixer, mute):
設置混音器 mixer 靜音狀態。如果 mute 的值是True,則將混音器 mixer 靜音。
preferences.get_mute(mute):
獲取混音器 mixer 的靜音設置。
這些配置項設置了各種音訊混合器(mixer)的默認音量。
config.default_music_volume
= 1.0 link音樂混合器的默認音量,用於音樂和影片中的音訊通道。這項值位於0.0和1.0的閉區間內,1.0表示最大音量。
config.default_sfx_volume
= 1.0 linksfx混合器的默認音量,用於音效的音訊通道。這項值位於0.0和1.0的閉區間內,1.0表示最大音量。
config.default_voice_volume
= 1.0 link語音混合器的默認音量,用於語音的音訊通道(包括voice語句和自動語音)。這項值位於0.0和1.0的閉區間內,1.0表示最大音量。