头像

许多视觉小说会在角色发言时，在对话内容旁边显示一张该角色的头像。Ren’Py把这个头像称作side image，并支持自动选择和显示对话的头像。

使用头像的前提是，定义 Character() 时使用一个关联的图像标签(tag)：

define e = Character("艾琳", image="eileen")

当某个角色发言时，Ren’Py会搜索并显示该角色的头像。显示头像遵守以下规则：

图像名带有“side”标签(tag)。
发言角色有对应的图像属性(样例中为“eileen”)。
发言角色的头像属性尽可能多的匹配立绘属性。

Ren’Py会根据以上规则搜索唯一图像。若找到则用作头像；如果没有找到或找到多个图像，则不显示头像。

例如，假设我们有如下脚本：

define e = Character("艾琳", image="eileen")

image eileen happy = "eileen_happy.png"
image eileen concerned = "eileen_concerned.png"
image eileen space suit = "eileen_space_suit.png"

image side eileen happy = "side_eileen_happy.png"
image side eileen = "side_eileen.png"
image side eileen space = "side_eileen_space.png"
image side eileen suit = "side_eileen_suit.png"

label start:

    show eileen happy

    e "我们这行称作A点。"

    e concerned "而这行称作B点。"

    e space suit "还有这行称作C点。"

在A点，角色 e 正在发言，关联的图像标签是“eileen”。当“eileen happy”图像显示时，图像标签“eileen”是必须包含的，而“happy”则不一定。我们寻找带有“side”图像标签的图像，以及尽可能多的属性，能匹配到“side eileen happy”，最终显示为头像。

在B点，显示的图像是“eileen concerned”。图像标签“eileen”是必须包含的，而“concerned”则不一定。。我们寻找带有“side”图像标签的图像，以及尽可能多的属性，能匹配到“side eileen”，因为不存在“side eileen concerned”图像。

最后，在C点，显示的图像是“eileen space suit”。图像标签“eileen”是必须包含的，而“space”和“suit”则不一定。我们寻找带有“side”图像标签的图像，以及尽可能多的属性，能匹配到“side eileen space”和“side eileen suit”。由于这个图像拥有相同数量的属性，Ren’Py不做进一步选择，也就不显示头像。

不可视角色

另一个头像的用处，是当用户角色的对话内容，显示一个头像。做法是将某个图像与角色关联，然后使用带图形结构的say语句选择显示的头像。

举例：

define p = Character("Player", image="player")

image side player happy = "side_player_happy.png"
image side player concerned = "side_player_concerned.png"

label start:

    p happy "这里会显示 'side player happy' 图像。"

    p "这里会显示 'side player happy' 。"

    p concerned "这里会显示 'side player concerned' 。"

配置和存储区变量

有一些头像的属性由配置项控制。

_side_image_tag = None

define config.side_image_tag = None

若非None，头像会追踪给定的图像标签(tag)，而不是追踪当前发言角色的关联图像。例如：

define e = Character("艾琳", image="eileen")

define config.side_image_tag = "eileen"

会让头像追踪图像标签“eileen”。这个标签与角色 e 关联。

define config.side_image_only_not_showing = False: 当设置为True时，只在带这个标签的某个图像还没有显示在界面上，才会显示头像。

_side_image_prefix_tag = None

define config.side_image_prefix_tag = 'side': 若 _side_image_prefix_tag不是None，其使用 config.side_image_prefix_tag 的设置。前缀用于搜索搜索头像。

define config.side_image_null = Null(): 不显示头像时，显示空的可视组件。空的头像也可以改变，只不过变为其他的空可视组件。一个这样做的原因是，设置了空组件的边界后(例如，Null(width=200, height=150))，能够防止dissolve效果被中途割裂。

define config.side_image_same_transform = None: 若非None，当新的头像与前一个头像共享同一个图像标签时，这个transform就会使用。

define config.side_image_change_transform = None: 若非None，当新的头像与前一个头像不共享图像标签(或新旧头像之一不存在)时，这个transform就会使用。

变换和转场

config.side_image_same_transform 和 config.side_image_change_transform 使用两个参数——新旧两个头像可视组件——调用时，每次显示的图像。可以是让头像运行或者使用转场效果。

下面是一个例子，当关联图像改变时，让头像滑入和滑出：

transform change_transform(old, new):
    contains:
        old
        yalign 1.0
        xpos 0.0 xanchor 0.0
        linear 0.2 xanchor 1.0
    contains:
        new
        yalign 1.0
        xpos 0.0 xanchor 1.0
        linear 0.2 xanchor 0.0

define config.side_image_change_transform = change_transform

当 SideImage() 缩小时，最好启用 Dissolve() 的mipmap功能。

transform same_transform(old, new):
    old
    new with Dissolve(0.2, alpha=True, mipmap=True)

define config.side_image_same_transform = same_transform

头像

不可视角色

配置和存储区变量

变换和转场

相关函数