使用指南
数学运算 / 基础 / 标量节点
数学运算 / 基础 / 标量 节点手册，包含 9 个节点的用途、引脚、使用场景和注意事项。
学习目标
处理数值、向量、矩阵、颜色、矩形和旋转等游戏开发高频数学数据。
覆盖范围
- 节点数量：9
- 分类路径：数学运算 / 基础 / 标量
典型使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
通用注意事项
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 截断小数 | mathBasicScalarTrunc | 1 / 1 | 立即继续 |
| 绝对值 | mathBasicScalarAbs | 1 / 1 | 立即继续 |
| 幂运算 | mathBasicScalarPow | 2 / 1 | 立即继续 |
| 平方根 | mathBasicScalarSqrt | 1 / 1 | 立即继续 |
| 四舍五入 | mathBasicScalarRound | 1 / 1 | 立即继续 |
| 吸附到步长 | mathBasicScalarSnap | 2 / 1 | 立即继续 |
| 限制到 0 到 1 | mathBasicScalarClamp01 | 1 / 1 | 立即继续 |
| 向上取整 | mathBasicScalarCeil | 1 / 1 | 立即继续 |
| 向下取整 | mathBasicScalarFloor | 1 / 1 | 立即继续 |
截断小数
截断小数：直接去掉小数部分，只保留整数部分。 这是语言基础里常用的快速裁剪节点，适合把浮点结果变成整数编号、数组索引或显示用的简化数字。 注意：它不会像”向下取整”那样继续朝更小方向移动。比如 -3.9 会得到 -3，而不是 -4。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarTrunc |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 原数字 | 数据 | number | 原数字 需要处理的数字。可以直接输入，也可以连接变量、组件读取结果或其他数值节点输出。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 结果 按当前规则处理后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
绝对值
绝对值：只保留数字的大小，不保留正负方向。 这是语言基础中常见的误差整理节点，适合比较距离差、偏移量、速度差和”离目标还有多远”这类场景。 例如 -8 会得到 8。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarAbs |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 原数字 | 数据 | number | 原数字 需要处理的数字。可以直接输入，也可以连接变量、组件读取结果或其他数值节点输出。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 结果 按当前规则处理后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
幂运算
幂运算：把一个数字提升到指定次方。 这是语言基础里常见的数值放大节点，适合做平方、立方、指数倍率和成长曲线。比如 2 的 3 次方会得到 8。 注意：某些底数与指数组合会得到小数、无穷大或 NaN，如果结果还要继续参与计算，建议配合”是否为有效数字”之类的检查节点一起使用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarPow |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
base | 底数 | 数据 | number | 底数 需要被提升次方的原始数字。 | 输入框 默认值：0 | 必填 |
exponent | 次方 | 数据 | number | 次方 决定要把底数提升到多少次方。默认是 2，表示平方。 | 输入框 默认值：2 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 幂运算结果 底数按指定次方计算后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
平方根
平方根：求一个数字开平方后的结果。 这是语言基础里常见的长度整理节点，适合从平方距离、面积或比例平方值反推出原始长度。 注意：如果输入负数，结果会变成 NaN。这表示当前数字在普通实数范围内没有可用的平方根。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarSqrt |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 原数字 | 数据 | number | 原数字 需要处理的数字。可以直接输入，也可以连接变量、组件读取结果或其他数值节点输出。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 结果 按当前规则处理后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
四舍五入
四舍五入：把数字调整成最接近的整数。 这是语言基础里最常见的显示整理节点，适合做分数展示、计数取整和粗粒度分档。 注意：它只负责把结果变成整数，不是”保留两位小数”这类格式化节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarRound |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 原数字 | 数据 | number | 原数字 需要处理的数字。可以直接输入，也可以连接变量、组件读取结果或其他数值节点输出。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 结果 按当前规则处理后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
吸附到步长
吸附到步长：把输入值对齐到最近的固定步长刻度。 这是语言基础里很常见的对齐节点，适合网格吸附、像素对齐、价格档位、进度分段和离散化数值。 注意：当步长为 0 时，节点会直接返回原值；当步长是负数时，会按对应的正步长理解。例如把 2.26 按 0.5 的步长吸附，会得到 2.5。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarSnap |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 原数字 | 数据 | number | 原数字 需要吸附对齐的原始数值。 | 输入框 默认值：0 | 必填 |
step | 步长 | 数据 | number | 步长 每一个刻度之间的间隔。默认是 1，表示吸附到最近的整数。 | 输入框 默认值：1 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 吸附结果 按当前步长对齐后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
限制到 0 到 1
限制到 0 到 1：把输入值强制压回 0 到 1 的范围。 这是语言基础里很常用的比例整理节点，适合进度、透明度、权重、百分比和归一化结果。 小于 0 的值会变成 0，大于 1 的值会变成 1。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarClamp01 |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 原数字 | 数据 | number | 原数字 需要处理的数字。可以直接输入，也可以连接变量、组件读取结果或其他数值节点输出。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 结果 按当前规则处理后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向上取整
向上取整：把数字的小数部分去掉，并朝更大的方向取最近的整数。 这是语言基础中常见的数值整理节点，适合做分页数量、最少格子数和”只要有余量就补到下一格”的场景。 提示：例如 3.1 会变成 4，-3.9 会变成 -3。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarCeil |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 原数字 | 数据 | number | 原数字 需要处理的数字。可以直接输入，也可以连接变量、组件读取结果或其他数值节点输出。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 结果 按当前规则处理后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
向下取整
向下取整：把数字的小数部分去掉，并朝更小的方向取最近的整数。 这是语言基础里非常常用的数值整理节点，适合做格子索引、页码换算和”不要超过当前整数下界”的场景。 注意：负数时会继续向更小方向移动，例如 -3.1 会得到 -4，它和”截断小数”不是同一种规则。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | mathBasicScalarFloor |
| 分类 | 数学运算 |
| 二级分类 | 基础 |
| 分组 | 标量 |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
value | 原数字 | 数据 | number | 原数字 需要处理的数字。可以直接输入，也可以连接变量、组件读取结果或其他数值节点输出。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | number | 结果 按当前规则处理后的数值结果。 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。