命名空间

Ren’Py使用命名空间(namespace)来组织各种变量、函数和方法。本页包含Ren’Py已经定义的各种命名空间，主要用于帮助文档编辑者。

achievement

该命名空间的函数用于解锁和管理 成就，同时集成了Steamworks库的很多内容。

bubble:

该命名空间包含的变量，用于控制 气泡式对话 的显示效果。

build:

该命名空间包含的变量，用于控制 构建发行版流程。

config:

该命名空间包含的变量，用于控制Ren’Py的 配置信息。 这些变量应该在游戏启动的初始化阶段(在 init python 语句块或使用 define 语句)进行修改。

define:

该命名空间包含的函数，用于定义新的变量，例如转场的族群。

director:

该命名空间包含的函数，用于控制 交互式编导器，可以让创作者在游戏中直接添加图片和音乐。

define gui

该命名空间包含的函数，用于控制 默认GUI系统。该命名空间中的变量仅在使用默认GUI系统时才会表现出效果。 如果创作者替换了GUI则不会使用。当游戏中的多语言类型发生改变时，与gui命名空间有关的define语句会重新运行一遍。

iap

该命名空间包含的函数，用于控制 游戏内购系统。

im

注意：该命名空间内的大部分函数都已弃用。

该命名空间包含所有图像控制器，可以使用CPU加载和控制图像。此处的大多数函数都可以使用 Transform 在GPU上实现。

layeredimage

层叠式图像 可以将多个图像合成为单一图像，使用属性(attribute)和条件语句控制具体显示的内容。 该命名空间包含了所有的类，可以使用Python创建和控制层叠式图像，等效于 layerdedimage 语句。

persistent

持久化对象中的字段初始值为None，只要游戏运行就始终保留值的修改结果，甚至读档都不影响持久化对象。

持久化对象中字段的数据类型应该是Python支持的类型，比如布尔型、数值、字符串、列表、元组和集合。 自定义类不能声明为持久化对象。

preferences

该命名空间包含环境设定用到的各种变量。所有变量可读可写，因此常用 default 语句设置值，比如：

default preferences.fullscreen = True

preferences.volume

该命名空间包含各混音器的默认音量值。常用 default 语句设置值，比如：

default preferences.volume.music = 0.5

renpy

该命名空间包含Ren’Py引擎自带的各种函数和类。这些函数和类基本都有等效的Ren’Py脚本语言语句。 也存在少量没有Ren’Py语言语句，只能以Python函数形式使用的函数和类。

renpy.audio.filter

该命名空间包含的类和函数，用于创建 音频滤波器。

renpy.music

该命名空间包含的函数，用于控制 音频系统。这些函数默认用于music音频通道。

renpy.sound

该命名空间包含的函数，用于控制 音频系统。这些函数默认用于sound音频通道。 大多数函数与renpy.music命名空间中的函数名称和功能一样。

style

该命名空间包含的样式和函数，用于控制样式(style)。样式自身用于控制Ren’Py的文本、图像等元素。 相比直接使用sytle命名空间中的函数，更推荐使用 style 语句。

ui

注意：该命名空间内的大部分函数都已弃用。

该命名空间包含的陈旧函数和类型，用于显示UI元素。 除了ui.adjustment、ui.interact、ui.callsinnewcontext和ui.invokesinnewcontext，所有函数都已废弃。

updater

该命名空间包含的函数、类和变量，用于控制 HTTPS/HTTP更新器。