定制鼠标光标 link

Ren’Py有两套系统可实现定制鼠标光标。 一种是利用硬件鼠标光标,另一种是在Ren’Py中绘制一个可视组件当作鼠标光标。

硬件鼠标光标有两个优点:

  • 非常快。
  • 消耗低。使Ren’Py有更多时间执行其他工作。

同时也有两个限制:

  • 光标只能是小尺寸。至少一个32×32像素的,常用的大尺寸也不过64×64像素.
  • 光标只能使用图像文件序列。

使用Ren’Py绘制一个可视组件用作光标可是跳出这些限制。 光标可以是Ren’Py能绘制的任何东西。当计算机启用图像三重缓存时,Ren’Py绘制光标可能会出现明显的延迟,而硬件光标不会。

硬件鼠标光标 link

硬件贯标由配置项 config.mouse 控制。 该配置项是一个字典型数据,将鼠标名称映射为一个序列帧列表。 每个序列帧都是一个三元元组,依次表示图片文件名、图片内部的X和Y轴偏移量。

例如:

define config.mouse = { }
define config.mouse['default'] = [ ( "gui/arrow.png", 0, 0) ]
define config.mouse['spin' ] = [
    ( "gui/spin0.png", 7, 7 ),
    ( "gui/spin1.png", 7, 7 ),
    ( "gui/spin2.png", 7, 7 ),
    ( "gui/spin3.png", 7, 7 ),
    ( "gui/spin4.png", 7, 7 ),
    ( "gui/spin5.png", 7, 7 ),
    ( "gui/spin6.png", 7, 7 ),
    ( "gui/spin7.png", 7, 7 ),
]

若动画由多帧组成,帧率为20fps。Ren’Py只能修改光标的图片或偏移量。

可视组件鼠标光标 link

可视组件光标使用配置项 config.mouse_displayable 的值,以及MouseDisplayable类型的可视组件。 下面是一个样例:

image "mouse spin":
    "gui/spin0.png"
    rotate 0.0
    linear 1.0 rotate 360.0

    # 暂停,等待图像预加载
    pause 1.0

    repeat

define config.mouse_displayable = MouseDisplayable(
    "gui/arrow.png", 0, 0).add("spin", "spin mouse", 9.9, 9.9)
MouseDisplayable(cursor, x, y) link

用作替换鼠标光标的可视组件。当用户在屏幕内移动鼠标时,该可视组件将跟随鼠标一起移动。

cursor
用作绘制光标的可视组件
x, y
热区(hotspot)坐标,以鼠标左上角的为原点,虚拟像素数。

使用鼠标光标 link

使用鼠标光标的通常方法是,对界面内某个可以获得焦点的组件(按钮或者条)使用 mouse 特性,指定光标名称。 例如:

screen test():
    textbutton "鼠标测试" actiuon NullAction mouse "spin"

还可以使用 default_mouse 设置全局鼠标光标:

$ default_mouse = "spin"