环境设定配置 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表示最大音量。