環境設定配置 link

環境設定配置存儲在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 link

Ren’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 link

If 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”設置。

混音器函數 link

preferences.set_volume(mixer, volume) link

將混音器 mixer 的音量值設置為 volume

mixer
表示混音器名稱的字串。預設的混音器名稱包括“music”、“sfx”和“voice”。
volume
介於0.0到1.0之間的數值。
preferences.get_volume(mixer):

獲取混音器 mixer 的音量。如果該混音器被靜音了,則返回0.0。

preferences.set_mute(mixer, mute):

設置混音器 mixer 靜音狀態。如果 mute 的值是True,則將混音器 mixer 靜音。

preferences.get_mute(mute):

獲取混音器 mixer 的靜音設置。

音訊通道默認配置 link

這些配置項設置了各種音訊混合器(mixer)的默認音量。

define config.default_music_volume = 1.0 link

音樂混合器的默認音量,用於音樂和影片中的音訊通道。這項值位於0.0和1.0的閉區間內,1.0表示最大音量。

define config.default_sfx_volume = 1.0 link

sfx混合器的默認音量,用於音效的音訊通道。這項值位於0.0和1.0的閉區間內,1.0表示最大音量。

define config.default_voice_volume = 1.0 link

語音混合器的默認音量,用於語音的音訊通道(包括voice語句和自動語音)。這項值位於0.0和1.0的閉區間內,1.0表示最大音量。