環境設定配置

環境設定配置儲存在Ren’Py的環境設定(preference)中。由於環境設定的值被設置為即時使用 Preference() 行為，環境設定配置應該使用default語句來設置環境設定的預設值。

舉例：

default preferences.text_cps = 40

設置預設的每秒顯示字元數為40。在環境設定值已經修改過的情況下，使用default語句修改環境設定值才會直接生效。例如，如果用戶將cps設置為50，以後運行時cps將保持為50。如果之後還有使用default語句修改cps為42，那麼用戶的設置就會修改為42。(之後用戶可以再次修改。)

preferences.afm_after_click = False

若為True，自動前進模式在遇到點擊事件消息會保持。若為False，點擊會終止自動前進模式。等效於“auto-forward after click”環境設定設置。

preferences.afm_enable = False

若為True，自動前進移動啟用。否則禁用。 等效於“auto-forward time”環境設置。

preferences.afm_time = 15

自動前進模式的等待時間。這個值越大，等待時間越長。由於文本分段等消耗，轉為時鐘時間(wall time)的機制比較複雜。等效於“auto-forward”環境設定。

preferences.desktop_rollback_side = "disable"

在桌面平台上，觸摸或點擊窗口邊欄就能觸發回滾。該項可以設置為“left”、“right”或者“disable”。等效於桌面平台上“rollback side”特性。

preferences.mobile_rollback_side = "disable"

在移動平台上，觸摸或點擊窗口邊欄就能觸發回滾。該項可以設置為“left”、“right”或者“disable”。等效於移動平台上“rollback side”特性。

preferences.language = None

遊戲運行時供玩家選擇的語言。 該值為None表示預設語言，也可以是字串，表示支持的其他語言。

該項用於設置預設語言類型，也可以讀取該值後決定當前使用語言。行為 Language() 可用於修改語言類型。

詳見 多語言支持。

preferences.emphasize_audio = False

若為True，Ren’Py會通過降低 config.emphasize_audio_channels 列表中之外的音訊通道音量，來加強那個列表中的通道。(例如，播放語音時降低音樂的音量)。若為False，就不做加強。

preferences.fullscreen = False

Ren’Py使用全螢幕模式時設置為True，以窗口模型運行時設置為False。等效於“display”環境設定。

preferences.gl_framerate = None

這項可能是一個整數，或者None。如果非None，這是Ren’Py希望達到的目標幀率。如果這項設置得比較低(例如，30)，而顯示設備使用一個比較高的幀率，Ren’Py會每兩幀繪製一次圖像。

若為None，Ren’Py會嘗試使用顯示設備的當前最高幀率繪製圖像。

preferences.gl_powersave = "auto"

這項決定了Ren’Py對未改變過的界面的重繪頻率。若為True，Ren’Py會每秒繪製界面5次。若為False，Ren’Py會盡可能以最高幀率繪製。若為“auto”，Ren’Py會在設備接通外置電源時使用最高幀率繪製，在設備使用電池運行時降低繪製頻率到5Hz。

preferences.gl_tearing = False

這項決定了，無法使用預訂的幀率運行時，是使用拖慢(設置為True)還是跳幀(設置為False)。

preferences.mouse_move = False

若為True，滑鼠指針會自動移動到選中的按鈕上。若為False，則不執行這種操作。等效於環境設定的“automatic move”。

preferences.show_empty_window = True

若為True，widown show和window auto語句將起作用。若為False，這些語句將不生效。等效於環境設定的“show empty window”。

preferences.skip_after_choices = False

若為True，在某個選項之後會恢復跳過(skipping)模式。若為False，選項就會停止Ren’Py的跳過(skipping)模式。等效於環境設定的“after choices”。

preferences.skip_unseen = False

若為True，Ren’Py會跳過所有文本。若為False，Ren’Py會僅跳過未看過的文本。等效於環境設定的“skip”。

preferences.text_cps = 0

文本顯示速度。0表示立刻顯示所有文本，否則表示每秒顯示的字元數。等效於環境設定的“text speed”。

preferences.transitions = 2

決定顯示何種轉場(transition)。2表示顯示所有轉場，0表示不顯示轉場。(1是預留值。)等效於環境設定的“transitions”。

preferences.video_image_fallback = False

若為True，將使用圖片代替影片精靈(videosprite)。若為False，影片精靈會正常顯示。等效於環境設定的video sprites。

preferences.voice_sustain = False

若為True，語音會保持播放直到結束，或另一句語音播放代替它。若為False，當對話進入下一行則語音播放也結束。等效於環境設定的“voice sustain”。

preferences.wait_voice = True

若為True，自動前進模式會等待語音文件或自動語音播放之後再進入下一句。若為False，則不等待。等效於環境設定的“wait for voice”。

preferences.system_cursor = False

若為True，強制使用系統滑鼠游標，忽略 config.mouse 和 config.mouse_displayable 的值。 若為False，則不執行這種操作。等效於“system cursor”設置。

preferences.audio_when_minimized = True

若為Fasel，窗口最小化後音訊通道停止，當窗口恢復後音訊通道恢復。 若為True，窗口狀態與音訊無關。等效於“audio when minimized”選項。

preferences.audio_when_unfocused = True

若為False，音訊通道會在遊戲窗口失去焦點時停止播放聲音，在重新獲得焦點後恢復。 若為True，遊戲窗口是否獲得焦點都不影響聲音。等效於設置“audio when unfocused”選項。

preferences.web_cache_preload = False

若為True，遊戲文件可以下載到瀏覽器快取中，允許遊戲離線運行。 若為False，遊戲文件不能下載到瀏覽器快取中，必須保持網路連接才能運行遊戲。 等效於設置“web cache preload”選項。

preferences.voice_after_game_menu = False

若為True，顯示遊戲菜單時繼續播放語音。 若為False，顯示遊戲菜單時立刻停止語音。 等效於設置“voice after menu”選項。

混音器函數

廣域混音器的內容詳見 音量。

preferences.set_mixer(mixer, volume)

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

mixer

表示混音器名稱的字串。預設的混音器名稱包括“main”、“music”、“sfx”和“voice”(“main”是個特殊混音器)。

volume

介於0.0到1.0之間的數值。0.0表示-40dB(電平)，1.0表示0dB.

preferences.get_mixer(mixer)

獲取混音器 mixer 的音量。如果該混音器被靜音了，則返回0.0。 返回值是介於0.0到1.0之間的數值。0.0表示-40dB(電平)，1.0表示0dB.

preferences.set_mute(mixer, mute)

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

preferences.get_mute(mixer)

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

音訊通道默認配置

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

define config.default_music_volume = 1.0

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

define config.default_sfx_volume = 1.0

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

define config.default_voice_volume = 1.0

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