我们正在将文档迁移到一个新的工具上。由于并非每一个页面都迁移完毕，一些没有明显归类的新功能都放着这里了。
renpy.version(tuple=False) link若 tuple 为False，返回一个带有“Ren’Py”的字符串，字符串后半部分是Ren’Py的当前版本信息。
若 tuple 为True，返回一个元组。元组内每个元素分别表示版本信息的一个整数部分。
renpy.version_string linkRen’Py的版本号，类似于字符串“Ren’Py 1.2.3.456”的格式。
renpy.version_only linkRen’Py的版本号，不带Ren’Py前缀，类似于字符串“1.2.3.456”的格式。
renpy.version_tuple linkRen’Py的版本号，类似于元组(1, 2, 3, 456)的格式。
renpy.version_name link一个人类可能的版本名称，类似“Example Version”的格式。
renpy.license link一个表示许可证文本的字符串，这个字符串应该在游戏的“关于”界面中显示。
Ren’Py包含许多变量需要基于运行的平台进行设置。
renpy.windows link在Windows平台运行时为True。
renpy.macintosh link在macOS平台运行时为True。
renpy.linux link在Linux或者POSIX类操作系统运行时为True。
renpy.android link在安卓平台运行时为True。
renpy.ios link在iOS平台运行时为True。
renpy.emscripten link在浏览器内运行时为True。
renpy.mobile link在安卓、iOS平台或浏览器运行时为True。
只有在实际设备运行而非模拟器上运行时，才会设置这些配置项。 这些配置项对平台敏感的Python是有用的。对显示布局(layout)的问题，详见 界面变种.
renpy.diff_memory(update=True) link分析Ren’Py和游戏使用的对象(object)、贴图(surface)和纹理(texture)内存。将上次调用这个函数时和这次调用这个函数的内容使用差异，并(在memory.txt和stdout)记录下。
计算方式是，按照存储区的名称和Ren’Py实现中所有可达的内存。 如果某个对象通过多个名称可达，就声明为最短可达路径。
由于通过这个函数可以扫描所有Ren’Py使用的内存，所以执行完毕相当耗时。
renpy.profile_memory(fraction=1.0, minimum=0) link分析Ren’Py和游戏使用的对象(object)、贴图(surface)和纹理(texture)内存。将使用的内存总数写入memory.txt和stdout。
计算方式是，按照存储区的名称和Ren’Py实现中所有可达的内存。 如果某个对象通过多个名称可达，就声明为最短可达路径。
由于通过这个函数会扫描所有Ren’Py使用的内存，所以执行完毕相当耗时。
renpy.profile_rollback() link分析回滚系统使用的内存。将回滚系统使用的内存写入到memory.txt和stdout。这个函数尝试计算各种存储变量用于回滚的内存量，以及回滚系统内部使用的内存量。
renpy.context() link返回一个对象，这个对象对当前上下文(context)唯一。进入一个新的上下文时，这个对象会复制一个副本。但对副本的修改不会影响原来的对象。
这个对象在回滚中会被保存和恢复。
renpy.context_nesting_level() link返回当前上下文的嵌套等级。最外层的上下文的等级是0(例如保存、读取和回滚)，非0等级其他上下文有菜单和回放等。
这个对象是一个随机数生成器，实现了 Python随机数生成接口 。调用这个对象衍生的各种方法可以生成需要的随机数。详见Python中的完整列表。最常用的几个如下：
renpy.random.random()renpy.random.randint(a, b)renpy.random.choice(seq)renpy.random.shuffle(seq)与标准的Python随机数生成器不同，这个对象可以与回滚兼容，无论回滚多少次都生成相同的随机数。所以可以使用这个对象代替标准Python随机模块。
# 返回一个介于0到1之间的随机浮点数。
$ randfloat = renpy.random.random()
# 返回一个介于1到20之间的随机整数。
$ d20roll = renpy.random.randint(1, 20)
# 返回列表中的一个随机元素。
$ randfruit = renpy.random.choice(['apple', 'orange', 'plum'])
renpy.random.Random(seed=None)这些函数允许创作者使用Python的ctypes模块调用SDL中dll的函数。 Ren’Py不保证自身的SDL2版本包含所有功能特性。其他地方可以运行的函数也不一定能在Ren’Py里运行，因此在实际使用前需要检查对应函数是否为空。
renpy.get_sdl_dll() link该函数返回一个ctypes.cdll对象，指向Ren’Py正在使用的SDL2实例中的库。
如果无法获取，则返回None。
renpy.get_sdl_window_pointer() link该函数返回(ctypes.c_void_p类型)主窗口坐标。主窗口没有显示或发生问题时，返回None>
init python:
import ctypes
def get_window_position():
"""
通过SDL2检查窗口坐标。返回窗口左上角坐标的(x, y)值。如果是未知坐标也会返回(0, 0)。
"""
sdl = renpy.get_sdl_dll()
if sdl is None:
return (0, 0)
win = renpy.get_sdl_window_pointer()
if win is None:
return (0, 0)
SDL_GetWindowPosition = sdl.SDL_GetWindowPosition
x = ctypes.c_int()
y = ctypes.c_int()
SDL_GetWindowPosition(win, ctypes.byref(x), ctypes.byref(y))
renpy.add_layer(layer, above=None, below=None, menu_clear=True) link向界面添加一个新图层。如果图层已经存在，则不做任何事。
below 和 above 必须提供至少一项。
renpy.add_python_directory(path) link将 path 添加在Python模块(module)和包(package)的路径列表中。这个路劲应该是一个游戏目录相对路劲的字符串。必须在import语句之前调用这个函数。
renpy.call_stack_depth() link返回当前上下文(context)调用栈(stack)的深度——这个数表示调用栈中还没有返回或弹出，但依然在运行的调用数量。
renpy.choice_for_skipping() link告诉Ren’Py即将出现一个选项。这个函数当前有两种影响：
renpy.clear_game_runtime() link重置游戏运行时间计数器。
renpy.clear_keymap_cache() link清空快捷键缓存。这个函数允许对 config.keymap() 的修改立刻生效，而不需要重启Ren’Py。
renpy.context_dynamic(*vars) link这个函数可以将一个或多个变量作为入参。函数让变量根据当前上下文(context)动态调整。当调用返回后，变量会重置为原来的值。
一个调用的样例如下：
$ renpy.context_dynamic("x", "y", "z")
renpy.focus_coordinates() link这个函数会尝试找到当前获得焦点可视组件的坐标。如果成功找到，返回一个(x, y, w, h)元组。如果没有找到，返回一个(None, None, None, None)元组。
renpy.force_autosave(take_screenshot=False) link强制自动存档。
renpy.force_full_redraw() link强制界面完全重绘。直接使用pygame重绘界面之后需要调用这个函数。
renpy.free_memory() link尝试释放一些内存。在运行基于renpy的minigame前很有用。
renpy.full_restart(transition=False, label='_invoke_main_menu', target='_main_menu') link让Ren’Py重启，将用户带回到主菜单。
config.end_game_transition() 。renpy.get_adjustment(bar_value) link传入一个 BarValue 对象 bar_value ， 返回 ui.adjustment() 。adjustment对象定义了下列属性(attribute)：
value link条(bar)的当前值。
range link条(bar)的当前值域。
renpy.get_autoreload() link获得自动加载标识(flag)。
renpy.get_game_runtime() link返回游戏运行时间计数器。
游戏运行时间计数器返回用户从顶层上下文(context)等待用户输入经过的秒数。(在主菜单和游戏菜单消耗的时间不计入。)
renpy.get_image_load_log(age=None) link图像加载激活日志生成器。对最后100项图像加载来说，这个函数返回：
输出结果按从新到旧排序。
在config.developer = True的情况下，才保存图像加载日志。
renpy.get_mouse_pos() link返回一个(x, y)元组，表示鼠标指针或当前触摸位置的坐标。如果设备不支持鼠标并且当前没有被触摸，x和y值无意义。
renpy.get_physical_size() link返回物理窗口的尺寸。
renpy.get_refresh_rate(precision=5) link返回当前屏幕的刷新率，这是一个fps浮点数。
Ren’Py能获得的裸数据，fps向下取整。就是说，如果显示器运行在59.95fps，那么函数返回的就是59fps。 precision参数进一步降低了实际显示的帧数，只能能pricision的整倍数。
由于所有显示器帧率都是5的整倍数(25、30、60、75和120)，这个函数可能会提高准确性。将precision设置为1表示禁用这个功能。
renpy.get_renderer_info() link返回一个字典，表示Ren’Py当前使用的渲染器信息。自定中包含下列键(key)：
"renderer""gl" 或 "sw" ，分别对应OpenGL和软件渲染。"resizable""additive"另外，键值也可能存在特定渲染器。这个字典应该被认为是不能修改的。可视组件启动后(也就是初始化段落已经结束)，这个函数应该只被调用一次。
renpy.get_say_attributes() link获得与当前say语句相关的属性(attribute)，如果没有相关属性(attribute)则返回None。
只有执行或预加载一条say语句时，这个函数才可用。
renpy.get_skipping() link如果Ren’Py跳过中则返回True，如果Ren’Py快速跳过中则返回“fast”，如果Ren’Py不在跳过状态则返回False。
renpy.get_transition(layer=None) link获取 lay 的转场(transition)，如果 layer 为None则获取整个场景(scene)的转场。这个函数返回了在下次交互行为中，队列上层的转场(transition)。如果不存在符合条件的转场则返回None。
renpy.iconify() link游戏窗口最小化。
renpy.invoke_in_thread(fn, *args, **kwargs) link在背景线程调用函数 fn ，传入这个函数收到的所有入参。线程返回后重新启动交互行为。
这个函数创建一个守护线程(daemon thread)，当Ren’Py关闭后这个线程也会自动停止。
renpy.is_init_phase() link当Ren’Py正在执行init代码时返回True，其他情况返回False.
renpy.is_seen(ever=True) link如果用户已经看过当前的行，则返回True。
如果 ever 为True，我们检查用户是否看过该行。如果 ever 为False，我们检查改行是否在当前游戏过程中被看过。
renpy.is_start_interact() link如果在当前交互行为中调用了restart_interaction，就返回True。这个函数可以用于确定是否某个交互行为已经开始，或者已重新开始。
renpy.load_module(name, **kwargs) link这个函数加载名为 name 的Ren’Py模块(module)。Ren’Py模块包含的Ren’Py脚本会加载进通用(存储)命名空间。Ren’Py脚本包含在名为name.rpym或name.rpymc的文件中。如果某个.rpym文件存在，并且比对应的.rpymc文件更新，就加载.rpym文件并创建新的.rpymc文件。
模块中所有的初始化语句块(block)(以及其他初始化代码)都在函数返回前运行。模块名未找到或有歧义的情况下会报错。
应该仅在初始化语句块(init block)中加载模块。
renpy.load_string(s, filename='<string>') link将 s 作为Ren’Py脚本加载。
返回 s 中第一个语句块的名称。
filename is the name of the filename that statements in the string will appear to be from.
renpy.maximum_framerate(t) link强制Ren’Py在 t 秒内以最大帧率重绘界面。如果 t 是None，则不要求使用最大帧率。
renpy.munge(name, filename=None) linkmunge式命名 name ，开头必须是双下划线“__”。
renpy.not_infinite_loop(delay) link将无限循环探测计时器重置为 delay 秒。
renpy.notify(message) link让Ren’Py使用notify界面显示 message 。默认情况下，显示的 message 消息会以dissolve方式出现，显示2秒，最后以dissolve方式消失。
对一些不会产生回调函数的行为(action)，比如截屏和快速保存，这个函数很有效。
一次只能显示一条通知。显示第二条通知时，会直接替换第一条通知。。
renpy.pause(delay=None, music=None, with_none=None, hard=False, checkpoint=None) link让Ren’Py暂停。如果用户点击并结束了这个暂停，暂停超时或被跳过，这个函数会返回True。
renpy.pop_call() link从调用栈(stack)弹出当前调用，并不再返回那个位置。
如果调用方决定不需要返回到那个脚本标签(label)的情况下，可以使用这个函数。
renpy.queue_event(name, up=False, **kwargs) link使用给定的 name 将某个事件放入消息队列。 name 应该是在 config.keymap() 中列出的事件名称之一，或者是这些事件组成的列表。
当调用这个函数时，事件会被同时放入消息队列。这个函数不能替换事件——替换会修改事件的顺序。(替换事件可以使用 config.keymap() 。)
这个函数是线程安全的(threadsafe)。
renpy.quit(relaunch=False, status=0) link这个函数让Ren’Py完全退出。
renpy.quit_event() link触发一个退出(quit)事件，比如用户点击了窗口的退出按钮。
renpy.reload_script() link让Ren’Py保存游戏，重新加载脚本，并加载存档。
renpy.reset_physical_size() link尝试将物理窗口尺寸设置为renpy.config配置的指定值。(就是配置的screen_width和screen_height。)这在全屏模式下超出屏幕的情况有副作用。
renpy.restart_interaction() link重新启动当前交互行为。包括以下内容，将显示的图像添加到场景(scene)，重新规划界面(screen)，并启动所有队列中的转场(transition)。
仅在某个交互行为中，这个函数才会执行所有工作。交互行为之外，这个函数不产生任何效果。
renpy.screenshot(filename) link将截屏保存为 filename 。
如果截屏保存成功就返回True。如果由于某些原因保存失败就返回False。
renpy.screenshot_to_bytes(size) link以二进制对象形式返回一个截屏，可以作为参数传入 im.Data() 。该二进制对象将是一张png格式图片，例如：
$ data = renpy.screenshot_to_bytes((640, 360))
show expression im.Data(data, "screenshot.png"):
align (0, 0)
将显示一个截屏图像。这个二进制对象可以存储到存档文件和持久化数据中。不过这个对象可能很大，注意不要存储太多类似的对象。
该函数运行可能比较慢，通常用在类似存档的截屏需求中，而不应该用在需要实时生效的功能中。
renpy.scry() link返回当前语句的scry对象。
scry对象告知Ren’Py当前语句哪些部分未来必定会是True。目前的版本中，scry对象只有一个字段(field)：
nvl_clearnvl clear 则为True。renpy.set_autoreload(autoreload) link设置自动重新加载标识(flag)。这个标识决定在文件发生变化后游戏是否会自动重新加载。自动重新加载不是完全启用，直到游戏使用 renpy.utter_restart() 重新加载之后。
renpy.set_mouse_pos(x, y, duration=0) link让鼠标指针跳到入参x和y指定的位置。如果设备没有鼠标指针，则没有效果。
renpy.set_physical_size(size) link尝试将物理窗口的尺寸设置为 size 。这对全屏模式下的有显示超出屏幕的副作用。
renpy.shown_window() link调用这个函数确认窗口已经显示。使用“window show”语句的交互行为，会显示一个空窗口，无论这个函数是否被调用。
renpy.split_properties(properties, *prefixes) link将 properties 切割为多个字典，每一个都带上前缀 prefix 。 这个函数轮流使用每一个 prefix 检查 properties 中每一个键(key)。 如果匹配到某个前缀，将就键(key)的前缀部分去掉作为最终字典的键(key)。
如果没有匹配到前缀，会抛出异常。(空字符串，”“，可以用作最后一个前缀，创建一个全匹配字典。)
例如，下面的语句将“text”开头的properties分割：
text_properties, button_properties = renpy.split_properties("text_", "")
renpy.substitute(s, scope=None, translate=True) link对字符串 s 应用多语言支持(translation)和新样式格式。
返回多语言支持和格式的字符串。
renpy.transition(trans, layer=None, always=False) link设置下次交互行为使用的转场(transition)。
renpy.vibrate(duration) link让设备震动 duration 秒。现在只支持安卓。
layout.yesno_screen(message, yes=None, no=None) link这个函数产生一个yes/no提示界面，并显示给定的提示信息。当用于选择了yes或者no之后，就隐藏界面。