使用指南
数学运算 / 几何 / Size节点
数学运算 / 几何 / Size 节点手册，包含 9 个节点的用途、引脚、使用场景和注意事项。
学习目标
处理数值、向量、矩阵、颜色、矩形和旋转等游戏开发高频数学数据。
覆盖范围
- 节点数量：9
- 分类路径：数学运算 / 几何 / Size
典型使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
通用注意事项
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 拆分尺寸 | sizeBreak | 1 / 2 | 立即继续 |
| 尺寸插值 | sizeLerp | 3 / 1 | 立即继续 |
| 尺寸相等 | sizeEquals | 2 / 1 | 立即继续 |
| 创建尺寸 | sizeCreate | 2 / 1 | 立即继续 |
| 复制尺寸 | sizeCopy | 3 / 2 | 立即继续 |
| 获取单位尺寸 | sizeGetOne | 0 / 1 | 立即继续 |
| 获取零尺寸 | sizeGetZero | 0 / 1 | 立即继续 |
| 克隆尺寸 | sizeClone | 1 / 1 | 立即继续 |
| 设置尺寸 | sizeSet | 4 / 2 | 立即继续 |
拆分尺寸
拆分二维尺寸：将尺寸拆解为宽度和高度两个独立数值。 输出字段为 width 与 height，对应尺寸的主语义属性。 x / y 是引擎对 width / height 的兼容别名，不是本节点的首选语义。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeBreak |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
size | 尺寸 | 数据 | size | 要拆分的二维尺寸 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
width | W | 数据 | number | 宽度（width） | - | 可选 |
height | H | 数据 | number | 高度（height） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
尺寸插值
尺寸线性插值：在两个尺寸之间按比例进行线性插值，返回新的结果尺寸。 当 ratio = 0 时返回起始尺寸 from，当 ratio = 1 时返回目标尺寸 to，中间值按比例平滑过渡。适合实现 UI 元素的大小渐变动画，例如按钮按下时缩小效果。 该节点返回新的结果尺寸，不会原地修改输入的 from 和 to。底层 out 参数由系统自动管理，不暴露给用户。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeLerp |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
from | 起始 | 数据 | size | 起始尺寸 | 可编辑控件 默认值：[0,0] | 必填 |
to | 目标 | 数据 | size | 目标尺寸 | 可编辑控件 默认值：[0,0] | 必填 |
ratio | 比例 | 数据 | number | 插值比例，0 = 起始尺寸，1 = 目标尺寸 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | size | 插值后的尺寸 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
尺寸相等
尺寸精确相等：判断两个尺寸的宽度和高度是否逐项严格相等。 比较 width 与 height 是否完全一致。 注意：这是精确比较（===），不是 epsilon 近似比较。对于浮点运算结果，微小的精度差异可能导致判定为不相等。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeEquals |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | size | 尺寸 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | size | 尺寸 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isEqual | 相等 | 数据 | boolean | 两个尺寸是否完全相等 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
创建尺寸
创建二维尺寸：根据宽度和高度构造一个新的 Size 实例。 字段顺序为 width / height，与 Size 构造器参数顺序一致。2D 游戏开发中常用于定义 Sprite 或 UI 图片的尺寸。 Size 表示二维尺寸，而不是二维位置坐标。请使用 width / height 语义理解输入，而不是 x / y（x / y 仅为引擎兼容别名）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeCreate |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
width | W | 数据 | number | 宽度（width） | 输入框 默认值：0 | 必填 |
height | H | 数据 | number | 高度（height） | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
size | 尺寸 | 数据 | size | 构造出的二维尺寸 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
复制尺寸
复制尺寸：将源尺寸的宽度和高度写入目标尺寸实例。 注意： 副作用节点：此节点会修改目标尺寸实例的值。通过执行流端口串接以确保执行顺序。 如果只需要获取一个独立副本而不修改已有实例，请使用 克隆尺寸 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeCopy |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
size | 目标尺寸 | 数据 | size | 目标尺寸 要被写入的 Size 实例，执行后其值将变为源尺寸的值 | 可编辑控件 默认值：[0,0] | 必填 |
source | 源尺寸 | 数据 | size | 源尺寸 要复制的 Size 数据来源 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
size | 目标尺寸 | 数据 | size | 目标尺寸 已被更新的目标 Size 实例（透传） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
获取单位尺寸
获取单位尺寸：返回 Size(1, 1)，表示宽度和高度均为 1 的二维尺寸，常用于缩放基准。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeGetOne |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
size | 单位尺寸 | 数据 | size | 单位尺寸 (1, 1) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
获取零尺寸
获取零尺寸：返回 Size(0, 0)，表示宽度和高度均为零的二维尺寸。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeGetZero |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
size | 零尺寸 | 数据 | size | 零尺寸 (0, 0) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
克隆尺寸
克隆二维尺寸：创建输入尺寸的深拷贝副本。 返回一个新的 Size 实例，内容与输入相同但引用不同。不会修改输入尺寸。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeClone |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
size | 尺寸 | 数据 | size | 要克隆的二维尺寸 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
size | 尺寸 | 数据 | size | 克隆出的新尺寸 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
设置尺寸
设置尺寸：将目标尺寸的宽度和高度设置为指定的数值。 注意： 副作用节点：此节点会直接更新目标 size 实例。通过执行流端口串接以确保执行顺序。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sizeSet |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Size |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
size | 目标尺寸 | 数据 | size | 目标尺寸 要被设置的 Size 实例 | 可编辑控件 默认值：[0,0] | 必填 |
width | W | 数据 | number | 宽度 要设置的宽度值 | 输入框 默认值：0 | 可选 |
height | H | 数据 | number | 高度 要设置的高度值 | 输入框 默认值：0 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
size | 目标尺寸 | 数据 | size | 目标尺寸 已被更新的目标 Size 实例（透传） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。