环境设定配置 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_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.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”。

音频通道默认配置 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表示最大音量。