label语句#

jump语句#

jump语句用于将主控流程转入指定的脚本标签(label)处。

若出现了 expression (表达式)关键词，关键词后面的表达式将被赋值，而被计算后的对应字符串则会被用作跳转目标的标签语句。若未出现 expression (表达式)关键词，跳转目标的标签名字就必须精确指定。

与call语句不同，jump语句不会将下一个语句放入栈(stack)中。因此，执行完跳转标签对应的语句块之后，主控流程不会回到跳转前的脚本位置。

1
label loop_start:
2

3
    e "哦，不！看起来我们陷入了一个无限循环之中。"
4

5
    jump loop_start

call语句#

call语句用于将主控流程转入给定的脚本标签(label)处。call语句会将下一条语句压入到调用栈(stack)中，并允许主控流程在执行完这次调用后，回到调用发生的脚本位置。

若出现了 expression 关键词，将计算关键词后面的表达式，而计算得到的字符串则会被用作跳转目标的标签语句。若未出现 expression 关键词，跳转目标的标签名字就必须显式指定。

from 分句是可选的，在label语句后面直接添加入参名和值，并直接在该label下直接使用。一个命名直白的标签(lable)有助于我们能利用栈(stack)回到脚本里合适的地方，就算加载的是修改过的脚本。

call语句可以使用参数，详见 PEP 448。

当我们使用一个带入参列表的调用表达式时，必须在表达式和入参列表之间插入关键词 pass 。 否则，入参列表会被当作表达式的一部分，而不是call语句的一部分。

1
label start:
2

3
    e "首先，我们调用一个支线。"
4

5
    call subroutine
6

7
    call subroutine(2)
8

9
    call expression "sub" + "routine" pass (count=3)
10

11
    return
12

13
label subroutine(count=1):
14

15
    e "我来过这里 [count] 次了。"
16
    e "接着，我们会从支线返回。"
17

18
    return

1
label start:
2
    e "开始演示pass的用法"
3

4
    # 1. 静态调用：直接传参，无需pass
5
    call sub(1)
6

7
    # 2. 动态调用：标签名由字符串拼接得到，必须用pass传参
8
    $ target_label = "sub"  # 动态定义要调用的标签名
9
    call expression target_label pass (count=2)
10

11
    # 3. 更典型的动态调用：字符串拼接
12
    call expression "sub" pass (count=3)
13

14
    e "所有调用完成"
15
    return
16

17
# 被调用的支线标签
18
label sub(count=0):
19
    e "我收到的参数是：[count]"
20
    return

1
label start:
2
    e "进入start标签，准备调用支线"
3
    call sub from back_to_here  # 调用sub，并指定return后回到back_to_here标记
4

5
    # 这个位置默认是return的返回点，但被from修改了，所以不会执行
6
    e "这行不会被执行"
7

8
label back_to_here:  # 自定义的返回点（标记）
9
    e "我回到了自定义的返回点！"
10
    return
11

12
label sub:
13
    e "我在支线sub里"
14
    return  # 执行return时，会跳转到from指定的back_to_here，而非call的下一行

return语句#

return语句会在调用栈中弹出最顶层的那条语句，并将主控流程转到那条语句。若调用栈为空，返回语句将重启Ren’Py，将主控流程切换至主菜单。

若返回语句带有可选项表达式，表达式会被计算求值，并且结果会被存储在_return变量中。_return变量依赖于各种场景动态变化。

特殊脚本标签(label)#

以下脚本标签(label)会在Ren’Py中使用：

• start

  默认情况下，Ren’Py在游戏启动后会跳转至这个标签。这个标签最好不要随便改动。

• quit

  若该标签存在，当用户退出游戏时该标签内容会被调用。

• after_load

  若该标签存在，当游戏读档后会调用这个标签内容。其可能被用于游戏内容更新后的数据修复。 如果数据从此标签后发生变化，应该调用 renpy.block_rollback() 函数防止用户从该存档点回滚。

• splashscreen

  若该标签存在，游戏首次运行时，在主菜单出现前，该标签内容会被调用。 详见 添加启动画面 。

• before_main_menu

  若该标签存在，在主菜单出现前，该标签内容会被调用。在少数情况下，其用来设置主菜单，例如背景播放一段影片。

• main_menu

  若该标签存在，标签内容会被调用，用来替代默认的主菜单。若其内容中包含return语句，Ren’Py将从start标签处开始游戏。例如，下面这段脚本在不显示主菜单的情况下开始游戏。label main_menu: return

• after_warp

  若该标签存在，则调用warp语句时，此标签至传送(warp)点前的语句都将被执行。详见 传送至某行

• hide_windows

  若该标签存在，当玩家使用鼠标右键或键盘H键隐藏对话窗口时，将调用此标签。 若标签返回值为True，隐藏对话窗口行为将取消(依然当作隐藏已经发生)。否则，继续隐藏对话窗口。

Ren’Py also uses the following labels to show some of the special screens: Ren’Py还是用下列标签显示某些 特殊界面 ：

• main_menu_screen
• load_screen
• save_screen
• preferences_screen
• joystick_preferences_screen

上下文#

上下文(context)是Ren’Py用于管理游戏中可以修改并且可以存档的各种状态值，具体包括：

• 当前Ren’Py运行状态
• 调用栈，已经上面提到的 renpy.dynamic() 使用的各种动态变量名和变量值。
• 当前显示的所有图像信息(包括图像属性和用到的各种变换等)
• 当前显示的界面和界面中的各种变量
• 正在播放或在播放队列中的音频

大多数时候游戏中仅有一个上下文，上下文中的各项也仅存在一个实例。 进入主菜单或游戏内菜单时，上下文中的各项可能会改变，但在离开菜单后各项会恢复。 其中一些改变是自动处理的，比如screen图层在上下文内容变化时会清空。

使用 回放 功能和 隐藏UI 函数时，Ren’Py会创建新的上下文。

界面语言 的创立，很大程度上就是为了减少频繁创建上下文。

仅在基本上下文(即仅有一个上下文时的那个)中才能使用回滚(rollback)。也只有基本上下文才可以存档，这是游戏菜单会用到上下文。

• renpy.call_in_new_context(label, *args, **kwargs)link

  该函数创建一个新的上下文(context)，并从这个上下文(context)中给定的脚本标签(label)处开始执行Ren’Py脚本。新的上下文(context)中禁用了回滚功能，并且存档/读档会发生在顶层的上下文(context)中。使用该函数可以在原有交互中启动第二层交互。

• renpy.context()link

  返回一个唯一对象，指向当前上下文。进入某个新的上下文时，该对象也将被赋值为新的上下文。但对该对象的修改不会影响其指向的原上下文内容。该对象可以存档，并参与回滚操作。

• context_dynamic(*variables)link

  该函数可以将若干个变量名作为入参，并根据当前上下文调整这些变量。当返回前一个上下文后，变量的值会恢复为该函数调用之前的值。命名存储空间 中的变量都可以支持。调用样例如下：$ renpy.context_dynamic("x", "y", "z") $ renpy.context_dynamic("mystore.serial_number")

• renpy.context_nesting_level()link

  返回当前上下文的嵌套层级(nesting level)。 最外层的上下文的层级为0(该层上下文可以存档、读档和回滚)。其他上下文的嵌套曾经都不是0，比如菜单和回放的上下文。

• renpy.invoke_in_new_context(callable, *args, **kwargs)link

  该函数创建了一个新的上下文(context)，并在上下文(context)中显示调用时指定的python可调用内容(通常是函数)。当函数返回值或者抛出异常时，主控流程会返回到原来的上下文(context)。当我们在同一个句柄(handle)中向玩家展示一些信息(比如确认提示)，就可以调用这个函数。其他额外入参都将传给callable处理。该函数创建的上下文无法执行Ren’Py脚本。能改变Ren’Py脚本执行流程的函数，比如 renpy.jump都会由外层的上下文处理。 如果想要调用Ren’Py脚本而不是Python函数，需要改用 :func:renpy.call_in_new_context().

• renpy.jump_out_of_context(label)link

  调用该函数会使主控流程离开当前上下文(context)，并转换到父层上下文(context)中指定的脚本标签(label)处。

• renpy.reset_all_contexts()link

  该函数会上下文栈中的所有元素都弹出(pop off)，恢复所有动态变量的值。完成以上内容后，再创建一个新的上下文。 当前语句结束，游戏从下一条语句继续执行。遇到异常的数据或起始点时，这样做能将Ren’Py设置为初始状态。该函数可用于重置游戏内的一切——包括显示的图像、播放的音乐等，就像游戏刚开始运行。由于该函数会重置Ren’Py，当前语句会立刻结束。该函数设计用在after_load脚本标签后面，可以将游戏的状态数据重置为初始值。接着游戏可以重新绘制场景、播放音乐等，最后跳转到目标脚本标签并继续。