使用指南
数学运算 / 向量 / Vec2节点
数学运算 / 向量 / Vec2 节点手册，包含 38 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
处理数值、向量、矩阵、颜色、矩形和旋转等游戏开发高频数学数据。
覆盖范围
- 节点数量：38
- 分类路径：数学运算 / 向量 / Vec2
典型使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
通用注意事项
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 安全倒数 | vec2InverseSafe | 1 / 1 | 立即继续 |
| 标量乘法 | vec2MultiplyScalar | 2 / 1 | 立即继续 |
| 叉积 | vec2Cross | 2 / 1 | 立即继续 |
| 拆分 Vec2 | vec2Break | 1 / 2 | 立即继续 |
| 点积 | vec2Dot | 2 / 1 | 立即继续 |
| 复制 Vec2 | vec2Copy | 3 / 2 | 立即继续 |
| 构造 Vec2 | vec2Create | 2 / 1 | 立即继续 |
| 归一化 | vec2Normalize | 1 / 1 | 立即继续 |
| 获取 X 轴单位向量 | vec2GetUnitX | 0 / 1 | 立即继续 |
| 获取 Y 轴单位向量 | vec2GetUnitY | 0 / 1 | 立即继续 |
| 获取负一向量 | vec2GetNegOne | 0 / 1 | 立即继续 |
| 获取零向量 | vec2GetZero | 0 / 1 | 立即继续 |
| 获取全一向量 | vec2GetOne | 0 / 1 | 立即继续 |
| 夹角 | vec2Angle | 2 / 1 | 立即继续 |
| 近似相等 | vec2Equals | 3 / 1 | 立即继续 |
| 克隆 Vec2 | vec2Clone | 1 / 1 | 立即继续 |
| 两向量距离 | vec2Distance | 2 / 1 | 立即继续 |
| 两向量距离平方 | vec2SquaredDistance | 2 / 1 | 立即继续 |
| 取负 | vec2Negate | 1 / 1 | 立即继续 |
| 设置 Vec2 | vec2Set | 4 / 2 | 立即继续 |
| 四舍五入 | vec2Round | 1 / 1 | 立即继续 |
| 随机方向 | vec2Random | 1 / 1 | 立即继续 |
| 缩放后相加 | vec2ScaleAndAdd | 3 / 1 | 立即继续 |
| 投影 | vec2Project | 3 / 2 | 立即继续 |
| 线性插值 | vec2Lerp | 3 / 1 | 立即继续 |
| 向量加法 | vec2Add | 2 / 1 | 立即继续 |
| 向量减法 | vec2Subtract | 2 / 1 | 立即继续 |
| 向量长度 | vec2Length | 1 / 1 | 立即继续 |
| 向量长度平方 | vec2LengthSqr | 1 / 1 | 立即继续 |
| 向量逐分量乘法 | vec2Multiply | 2 / 1 | 立即继续 |
| 向量逐分量除法 | vec2Divide | 2 / 1 | 立即继续 |
| 向上取整 | vec2Ceil | 1 / 1 | 立即继续 |
| 向下取整 | vec2Floor | 1 / 1 | 立即继续 |
| 旋转 | vec2Rotate | 3 / 2 | 立即继续 |
| 严格相等 | vec2StrictEquals | 2 / 1 | 立即继续 |
| 有符号夹角 | vec2SignAngle | 3 / 3 | 立即继续 |
| 逐分量最大值 | vec2Max | 2 / 1 | 立即继续 |
| 逐分量最小值 | vec2Min | 2 / 1 | 立即继续 |
安全倒数
安全倒数：对向量的每个分量取倒数，返回新向量。 当分量为 0 时安全返回 0，而不是 Infinity。result = Vec2(1/a.x, 1/a.y)（分量为 0 时对应结果为 0）。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2InverseSafe |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | 向量 | 数据 | vector2 | 输入向量 要取倒数的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 倒数向量 分量安全取倒后的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
标量乘法
标量乘法：将向量的每个分量乘以标量，返回新向量。 result = Vec2(vector.x * scalar, vector.y * scalar)。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2MultiplyScalar |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | 向量 | 数据 | vector2 | 输入向量 要进行标量乘法的向量 | 可编辑控件 默认值：[0,0] | 必填 |
scalar | 标量 | 数据 | number | 标量 乘法因子 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 结果向量 标量乘法后的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
叉积
叉积：计算两个二维向量的叉积，结果是一个数值（不是新向量）。 公式 cross = a.x * b.y - a.y * b.x。通俗理解：二维叉积告诉你 B 在 A 的”哪一侧”。正值 = B 在 A 的逆时针方向（左侧），负值 = 顺时针方向（右侧），零值 = 共线（同一方向）。常用于转向判断、三角形面积、点与多边形的位置关系。 注意：二维叉积返回的是 z 分量的标量值（NUMBER），不是新的向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Cross |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
cross | 叉积 | 数据 | number | 叉积值 二维叉积的 z 分量标量。正值 = B 在 A 逆时针方向 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
拆分 Vec2
拆分 Vec2：将一个二维向量拆分为 x、y 两个数值分量。 纯数据节点，不会修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Break |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | 向量 | 数据 | vector2 | 输入向量 要拆分的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
x | X | 数据 | number | X 分量 向量的 X 坐标值 | - | 可选 |
y | Y | 数据 | number | Y 分量 向量的 Y 坐标值 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
点积
点积：计算两个向量的点积，结果是一个数值。 公式 dot = a.x * b.x + a.y * b.y。通俗理解：点积衡量两个方向之间的”对齐程度”。正值表示方向大致相同（如角色面朝目标），零值表示垂直，负值表示方向相反（如目标在背后）。常用于朝向检测、光照计算、投影长度等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Dot |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
dot | 点积 | 数据 | number | 点积值 两向量的内积结果（标量） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
复制 Vec2
复制 Vec2：将源向量的 x、y 值写入目标向量。 注意： 副作用节点：此节点会修改目标向量实例的值。通过执行流端口串接以确保执行顺序。 如果只需要获取一个独立副本而不修改已有实例，请使用 克隆 Vec2 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Copy |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 要被写入的 Vec2 实例，执行后其值将变为源向量的值 | 可编辑控件 默认值：[0,0] | 必填 |
source | 源向量 | 数据 | vector2 | 源向量 要复制的 Vec2 数据来源 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 已被更新的目标 Vec2 实例（透传） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
构造 Vec2
构造 Vec2：根据给定的 x、y 分量创建一个新的二维向量。 返回一个全新的 Vec2 实例，不会修改任何已有向量。适合从场景坐标或输入数据构造向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Create |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
x | X | 数据 | number | X 分量 新向量的 X 坐标 | 输入框 默认值：0 | 必填 |
y | Y | 数据 | number | Y 分量 新向量的 Y 坐标 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | 向量 | 数据 | vector2 | 新向量 由 x、y 构造的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
归一化
归一化：将向量缩放为单位长度（长度为 1），返回新向量。 保留方向、去掉长度信息。归一化后得到的单位向量只表示方向，常用于移动方向、视线方向、光照方向等只需要方向而不关心距离的场景。 注意：当输入为零向量 Vec2(0, 0) 时，返回的仍然是零向量，而非报错。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Normalize |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | 向量 | 数据 | vector2 | 输入向量 要归一化的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 归一化向量 单位长度的新 Vec2（零向量输入时返回零向量） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
获取 X 轴单位向量
获取 X 轴单位向量：返回 Vec2(1, 0)。 等价于 cc.Vec2.UNIT_X，表示 X 轴正方向。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2GetUnitX |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | X 单位向量 | 数据 | vector2 | X 轴单位向量 返回 Vec2(1, 0) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
获取 Y 轴单位向量
获取 Y 轴单位向量：返回 Vec2(0, 1)。 等价于 cc.Vec2.UNIT_Y，表示 Y 轴正方向。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2GetUnitY |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | Y 单位向量 | 数据 | vector2 | Y 轴单位向量 返回 Vec2(0, 1) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
获取负一向量
获取负一向量：返回 Vec2(-1, -1)。 等价于 cc.Vec2.NEG_ONE，可用于反向缩放或偏移。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2GetNegOne |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | 负一向量 | 数据 | vector2 | 负一向量 返回 Vec2(-1, -1) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
获取零向量
获取零向量：返回 Vec2(0, 0)。 等价于 cc.Vec2.ZERO，常用于初始化位置（如角色出生点）或重置方向。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2GetZero |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | 零向量 | 数据 | vector2 | 零向量 返回 Vec2(0, 0) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
获取全一向量
获取全一向量：返回 Vec2(1, 1)。 等价于 cc.Vec2.ONE，常用于缩放基准或作为初始方向。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2GetOne |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | 全一向量 | 数据 | vector2 | 全一向量 返回 Vec2(1, 1) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
夹角
夹角：计算两个二维向量之间的无符号夹角。 返回值为弧度（NUMBER），范围 [0, π]，不区分方向。如果需要带方向的有符号角度，请使用 有符号夹角 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Angle |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
angle | 夹角 | 数据 | number | 夹角（弧度） 两向量间的无符号夹角，范围 [0, π] | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
近似相等
近似相等：判断两个向量是否近似相等，各分量差值在 epsilon 容差范围内。 epsilon 为可选输入，默认使用引擎内置的 EPSILON（约 0.000001）。适用于浮点数运算结果的比较。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Equals |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
epsilon | 容差 | 数据 | number | 容差 近似比较的容差阈值。可选，默认使用引擎 EPSILON（约 0.000001） | 输入框 默认值：0 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isEqual | 相等 | 数据 | boolean | 是否近似相等 各分量差值在 epsilon 范围内时为 true | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
克隆 Vec2
克隆 Vec2：创建输入向量的一个独立副本。 返回一个全新的 Vec2 实例，与原向量拥有相同的 x、y 值但互不关联。适用于需要避免引用共享的场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Clone |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | 向量 | 数据 | vector2 | 源向量 要克隆的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vector | 向量 | 数据 | vector2 | 克隆向量 与源向量值相同的全新 Vec2 实例 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
两向量距离
两向量距离：计算两个二维向量之间的欧几里得距离。 distance = sqrt((a.x - b.x)² + (a.y - b.y)²)。适合判断角色到目标的距离、攻击范围、拾取范围等游戏逻辑。如果只需比较距离大小，请使用 距离平方 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Distance |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
distance | 距离 | 数据 | number | 距离 A 与 B 之间的欧几里得距离 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
两向量距离平方
两向量距离平方：计算两个二维向量之间距离的平方值。 squaredDistance = (a.x - b.x)² + (a.y - b.y)²。避免开方运算，性能更好，适合距离比较场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2SquaredDistance |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
squaredDistance | 距离平方 | 数据 | number | 距离平方 A 与 B 之间距离的平方值 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
取负
取负：对向量的每个分量取负值，返回新向量。 result = Vec2(-a.x, -a.y)。等价于方向反转。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Negate |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | 向量 | 数据 | vector2 | 输入向量 要取负的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 取负向量 方向反转的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
设置 Vec2
设置 Vec2：将目标向量的 x、y 分量设置为指定的数值。 注意： 副作用节点：此节点会修改目标向量实例的值。通过执行流端口串接以确保执行顺序。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Set |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 要被设置的 Vec2 实例 | 可编辑控件 默认值：[0,0] | 必填 |
x | X | 数据 | number | X 分量 要设置的 X 坐标值 | 输入框 默认值：0 | 可选 |
y | Y | 数据 | number | Y 分量 要设置的 Y 坐标值 | 输入框 默认值：0 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 已被更新的目标 Vec2 实例（透传） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
四舍五入
四舍五入：对向量的每个分量进行四舍五入，返回新向量。 result = Vec2(round(a.x), round(a.y))。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Round |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | 向量 | 数据 | vector2 | 输入向量 要四舍五入的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 四舍五入向量 各分量已四舍五入的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
随机方向
随机方向：生成一个随机方向的二维向量。 默认返回单位圆上的随机方向向量（长度为 1）。通过可选的 scale 输入可以控制向量长度。适合随机弹射角度、随机偏移方向、粒子随机运动等 2D 场景。每次执行产生不同的随机结果。不修改任何已有向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Random |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scale | 缩放 | 数据 | number | 缩放因子 控制随机向量的长度，默认为 1（单位圆） | 输入框 默认值：0 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 随机向量 随机方向的 Vec2，长度由 scale 控制 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
缩放后相加
缩放后相加：先将向量 B 乘以 scale，再与向量 A 相加，返回新向量。 result = A + B * scale。适合速度叠加、加速度累积、冲量计算等物理相关场景。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2ScaleAndAdd |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A 基础向量 | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B 要被缩放的向量 | 可编辑控件 默认值：[0,0] | 必填 |
scale | 缩放 | 数据 | number | 缩放因子 乘以向量 B 的系数 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 结果向量 A + B * scale 的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
投影
投影：将目标向量投影到另一向量上。 通俗理解：计算一个向量在另一个方向上的”影子”。适合速度分解（计算某个方向的分速度）、方向约束（将位置拉回到某条线上）。 注意：此节点是副作用节点，会修改目标向量实例。通过执行流端口串接以确保执行顺序。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Project |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 要被投影的 Vec2 实例（将被修改） | 可编辑控件 默认值：[0,0] | 必填 |
other | 投影方向 | 数据 | vector2 | 投影方向 目标向量将被投影到此向量的方向上 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 已被投影修改的 Vec2 实例（透传） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
线性插值
线性插值：在两个向量之间按 t 进行线性插值，返回新向量。 result = A + (B - A) * t。当 t = 0 时返回 A，t = 1 时返回 B，t = 0.5 时返回中点。适合平滑移动（如相机跟随）、位置过渡动画等场景。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Lerp |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 起始向量 A t = 0 时的值 | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 结束向量 B t = 1 时的值 | 可编辑控件 默认值：[0,0] | 必填 |
t | t | 数据 | number | 插值系数 通常在 [0, 1] 范围内，0 = A，1 = B | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 插值结果 A 与 B 之间的线性插值新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向量加法
向量加法：计算两个二维向量的逐分量之和，返回新向量。 result = Vec2(a.x + b.x, a.y + b.y)。适合计算角色移动（位置 + 方向 × 速度）、合力叠加等场景。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Add |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 结果向量 A + B 的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向量减法
向量减法：计算两个二维向量的逐分量之差，返回新向量。 result = Vec2(a.x - b.x, a.y - b.y)。适合计算两点的方向向量（目标 - 当前位置）或相对偏移。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Subtract |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 结果向量 A - B 的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向量长度
向量长度：计算向量的欧几里得长度（模），即从原点到向量点的距离。 length = sqrt(a.x² + a.y²)。适合计算移动速度大小、力的强度、检测范围半径等。如果只需比较长度大小而不需要精确值，请使用 向量长度平方 节点以获得更好的性能。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Length |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | 向量 | 数据 | vector2 | 输入向量 要计算长度的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
length | 长度 | 数据 | number | 长度 向量的欧几里得长度 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向量长度平方
向量长度平方：计算向量长度的平方值。 lengthSqr = a.x² + a.y²。避免开方运算，性能更好，适合仅用于长度比较的场景（如判断是否在攻击范围内）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2LengthSqr |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | 向量 | 数据 | vector2 | 输入向量 要计算长度平方的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
lengthSqr | 长度平方 | 数据 | number | 长度平方 向量长度的平方值 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向量逐分量乘法
向量逐分量乘法：计算两个二维向量的逐分量乘积，返回新向量。 result = Vec2(a.x * b.x, a.y * b.y)。注意这不是点积也不是叉积，而是 Hadamard 积。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Multiply |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 结果向量 逐分量乘积的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向量逐分量除法
向量逐分量除法：计算两个二维向量的逐分量商，返回新向量。 result = Vec2(a.x / b.x, a.y / b.y)。注意：当 b 的分量为 0 时结果为 Infinity 或 NaN。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Divide |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 被除向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 除向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 结果向量 逐分量除法的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向上取整
向上取整：对向量的每个分量向上取整，返回新向量。 result = Vec2(ceil(a.x), ceil(a.y))。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Ceil |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | 向量 | 数据 | vector2 | 输入向量 要向上取整的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 向上取整向量 各分量已向上取整的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向下取整
向下取整：对向量的每个分量向下取整，返回新向量。 result = Vec2(floor(a.x), floor(a.y))。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Floor |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | 向量 | 数据 | vector2 | 输入向量 要向下取整的 Vec2 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 向下取整向量 各分量已向下取整的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
旋转
旋转：将目标向量绕原点旋转指定弧度。 适合方向向量旋转（如调整角色朝向）、弹道偏转等 2D 旋转场景。 注意：此节点是副作用节点，会修改目标向量实例。输入角度为弧度，正值表示逆时针旋转。通过执行流端口串接以确保执行顺序。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Rotate |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 要被旋转的 Vec2 实例（将被修改） | 可编辑控件 默认值：[0,0] | 必填 |
radians | 弧度 | 数据 | number | 旋转弧度 绕原点旋转的角度（弧度制）。正值 = 逆时针 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 已被旋转的 Vec2 实例（透传） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
严格相等
严格相等：判断两个向量是否完全相等（各分量严格 === 比较）。 对于浮点数运算结果，建议优先使用 近似相等 节点以避免精度误差。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2StrictEquals |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isEqual | 相等 | 数据 | boolean | 是否相等 两向量各分量严格相等时为 true | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
有符号夹角
有符号夹角：计算从目标向量到另一向量的有符号夹角。 返回值为弧度（NUMBER），范围 [-π, π]。正值表示逆时针旋转，负值表示顺时针旋转。适合判断目标在角色的哪一侧、需要转向多少角度等场景。 此节点为实例调用节点（以保持与 Vec2 实例方法族的一致性），但不会修改目标向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2SignAngle |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 起始方向向量（不会被修改） | 可编辑控件 默认值：[0,0] | 必填 |
other | 另一向量 | 数据 | vector2 | 另一向量 要计算夹角的目标方向 | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
vector | 目标向量 | 数据 | vector2 | 目标向量 透传的目标 Vec2 实例（未修改） | - | 可选 |
angle | 夹角 | 数据 | number | 有符号夹角（弧度） 从目标向量到另一向量的旋转角度，范围 [-π, π]。正值 = 逆时针 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
逐分量最大值
逐分量最大值：取两个向量各分量的较大值，返回新向量。 result = Vec2(max(a.x, b.x), max(a.y, b.y))。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Max |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 结果向量 逐分量最大值的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
逐分量最小值
逐分量最小值：取两个向量各分量的较小值，返回新向量。 result = Vec2(min(a.x, b.x), min(a.y, b.y))。不修改输入向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | vec2Min |
| 分类 | 数学运算 |
| 二级分类 | 向量 |
| 分组 | Vec2 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | vector2 | 向量 A | 可编辑控件 默认值：[0,0] | 必填 |
b | B | 数据 | vector2 | 向量 B | 可编辑控件 默认值：[0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | vector2 | 结果向量 逐分量最小值的新 Vec2 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。