事件 Events #

这类拼图提供了指针、键盘事件，以及自定义事件和射线，用于处理各种设备下的交互。

事件 #

创建事件 create_custom_event #

创建一个事件。事件分3部分：事件、触发事件和监听事件。

触发事件 dispatch_custom_event #

向事件的监听者发出通知。

数据参数通过接收一个对象，可以在派发事件时携带参数。

监听事件 listen_custom_event #

当事件触发时执行执行插槽中的拼图。

监听指针事件 listen_pointer_event #

用于监听指针事件。

参数忽略背面，勾选表示忽略网格背面。

事件类型：

• 指针双击
• 指针按下
• 指针移动
• 指针单击
• 指针轻击
• 指针抬起
• 指针滚动

点击信息 picking_info #

返回拾取信息，用于pointer_event拼图和ray_intersects_mesh拼图（通过这两个拼图的右键菜单创建 点击信息可快速创建picking_info拼图）。

参数：

• 点击信息
• 点击的网格
• 点击的位置
• 点击的法线

获取法线 get_normal_from_picking_info #

获取点击击中的面的法线。注意，返回的法线始终朝向拾取射线。

• 世界坐标 - 生成的法线是否使用世界坐标
• 顶点法线 - 是否使用顶点法线，而非法线贴图来计算法线
• 点击信息 - 点击事件信息

监听键盘事件 listen_keyboard_event #

用于监听键盘的按下和抬起事件。参数重复勾选时表示当一直按住键盘时，重复触发键盘事件；否则，只触发一次键盘事件。

获取键 get_key_input #

用于返回键盘按键和按键代码。

监听场景事件 listen_scene_event #

监听场景事件。包括：

• 场景渲染前 - 在场景渲染前触发此事件（紧跟在动画和物理之后），用于代替每帧time_every_frame拼图
• 场景就绪 - 当场景就绪时触发此事件

动作 #

创建动作 event_create_action #

用于创建动作。动作是应用到网格，通过事件触发的行为。

动作的类型：

• 无
• 设置值
• 切换布尔
• 插值
• 递增值
• 执行函数
• 合并

事件类型：

• 无
• 当点击
• 当双击
• 当点击按下
• 当点击抬起
• 当点击移出
• 当左键单击
• 当右键单击
• 当中键单击
• 当长按
• 当指针经过
• 当指针移出
• 当相交进入
• 当相交退出

添加动作 event_add_actions #

将动作指定给网格。

动作参数接收一个包含动作的数组。

帧 #

多帧 event_multi_frame #

用于处理跨帧逻辑。

下一帧 event_next_frame #

跳到下一渲染帧。仅用于多帧拼图内部。

等待 event_await_delay #

等待一段时间。仅用于多帧拼图内部。

射线 #

创建射线 create_ray #

创建射线。射线是一条从场景中某点发出的有长度的虚拟射线。通常用于拾取网格。

射线相交网格 ray_intersects_mesh #

检测射线与网格（或一组网格）是否相交，若相交执行完成插槽中的拼图。交点信息可通过picking_info拼图获取。