使用指南
数学运算 / 几何 / Color节点
数学运算 / 几何 / Color 节点手册，包含 28 个节点的用途、引脚、使用场景和注意事项。
学习目标
处理数值、向量、矩阵、颜色、矩形和旋转等游戏开发高频数学数据。
覆盖范围
- 节点数量：28
- 分类路径：数学运算 / 几何 / Color
典型使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
通用注意事项
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 白色 | colorGetWhite | 0 / 1 | 立即继续 |
| 拆分颜色 | colorBreak | 1 / 4 | 立即继续 |
| 创建颜色 | colorCreate | 4 / 1 | 立即继续 |
| 从 HEX 创建颜色 | colorFromHex | 1 / 1 | 立即继续 |
| 从 HSV 创建颜色 | colorFromHSV | 4 / 1 | 立即继续 |
| 从 Vec4 创建颜色 | colorFromVec4 | 1 / 1 | 立即继续 |
| 复制颜色 | colorCopy | 3 / 2 | 立即继续 |
| 黑色 | colorGetBlack | 0 / 1 | 立即继续 |
| 红色 | colorGetRed | 0 / 1 | 立即继续 |
| 黄色 | colorGetYellow | 0 / 1 | 立即继续 |
| 灰色 | colorGetGray | 0 / 1 | 立即继续 |
| 克隆颜色 | colorClone | 1 / 1 | 立即继续 |
| 蓝色 | colorGetBlue | 0 / 1 | 立即继续 |
| 绿色 | colorGetGreen | 0 / 1 | 立即继续 |
| 品红 | colorGetMagenta | 0 / 1 | 立即继续 |
| 青色 | colorGetCyan | 0 / 1 | 立即继续 |
| 设置颜色 | colorSet | 6 / 2 | 立即继续 |
| 透明 | colorGetTransparent | 0 / 1 | 立即继续 |
| 颜色插值 | colorLerp | 3 / 1 | 立即继续 |
| 颜色缩放 | colorScale | 2 / 1 | 立即继续 |
| 颜色相乘 | colorMultiply | 2 / 1 | 立即继续 |
| 颜色相除 | colorDivide | 2 / 1 | 立即继续 |
| 颜色相加 | colorAdd | 2 / 1 | 立即继续 |
| 颜色相减 | colorSubtract | 2 / 1 | 立即继续 |
| 颜色严格相等 | colorStrictEquals | 2 / 1 | 立即继续 |
| 颜色转 CSS | colorToCSS | 2 / 1 | 立即继续 |
| 颜色转 HSV | colorToHSV | 1 / 4 | 立即继续 |
| 颜色转 Vec4 | colorToVec4 | 1 / 1 | 立即继续 |
白色
白色常量：返回白色（255, 255, 255, 255）RGBA 颜色值。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetWhite |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 白色 | 数据 | color | 白色 (255, 255, 255, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
拆分颜色
拆分颜色：将颜色拆解为 R / G / B / A 四个独立数值（0~255）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorBreak |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 要拆分的颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
r | R | 数据 | number | 红色通道（0~255） | - | 可选 |
g | G | 数据 | number | 绿色通道（0~255） | - | 可选 |
b | B | 数据 | number | 蓝色通道（0~255） | - | 可选 |
a | A | 数据 | number | 透明度通道（0~255） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
创建颜色
创建颜色：根据 R / G / B / A 通道值构造一个新的 Color 实例。 通道值范围为 0~255（8-bit），默认值为白色 (255, 255, 255, 255)。 适合制作自定义 UI 颜色、角色配色、粒子颜色等。引擎使用 Uint8ClampedArray 存储颜色通道，超出范围的值将被自动钳制。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorCreate |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
r | R | 数据 | number | 红色通道（0~255） | 输入框 默认值：255 | 必填 |
g | G | 数据 | number | 绿色通道（0~255） | 输入框 默认值：255 | 必填 |
b | B | 数据 | number | 蓝色通道（0~255） | 输入框 默认值：255 | 必填 |
a | A | 数据 | number | 透明度通道（0~255） | 输入框 默认值：255 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 构造出的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
从 HEX 创建颜色
从十六进制字符串创建颜色：将 HEX 格式字符串解析为 Color。 支持 6 位（#rrggbb）和 8 位（#rrggbbaa）格式。6 位格式时 Alpha 默认为 255。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorFromHex |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
hex | HEX | 数据 | string | 十六进制颜色字符串（如 #ff8040 或 #ff804020） | 输入框 默认值：“#ffffff” | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 解析出的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
从 HSV 创建颜色
从 HSV 色彩空间创建颜色：根据色相 (H)、饱和度 (S)、明度 (V) 与透明度 (A) 构造颜色。
h、s、v 范围均为 01（归一化比例），其中 h=0 对应红色、h≈0.33 对应绿色、h≈0.67 对应蓝色。a 范围为 0255。
a 端口用于指定透明度，不是 HSV 本身的组成部分，默认为 255（完全不透明）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorFromHSV |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
h | H | 数据 | number | 色相（0~1，0=红色, ≈0.33=绿色, ≈0.67=蓝色） | 输入框 默认值：0 | 必填 |
s | S | 数据 | number | 饱和度（0~1） | 输入框 默认值：1 | 必填 |
v | V | 数据 | number | 明度（0~1） | 输入框 默认值：1 | 必填 |
a | A | 数据 | number | 透明度（0~255），不是 HSV 的组成部分 | 输入框 默认值：255 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 由 HSV 构造的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
从 Vec4 创建颜色
从归一化 Vec4 创建颜色：将 01 范围的 Vec4(x, y, z, w) 转换为 0255 范围的颜色。
转换关系为 r = x * 255, g = y * 255, b = z * 255, a = w * 255。
注意：此节点的语义是归一化 01 → 0255 转换，与既有 Vec4FromColor 的 0~255 通道直接拷贝语义不同。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorFromVec4 |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vec4 | Vec4 | 数据 | vector4 | 归一化 Vec4（各分量 0~1） | 可编辑控件 默认值：[0,0,0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 转换出的颜色（0~255） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
复制颜色
复制颜色：将源颜色的通道值写入目标颜色实例。 注意： 副作用节点：此节点会直接修改目标 color 实例。通过执行流端口串接以确保执行顺序。 输出为已更新的目标 color 实例（同一引用）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorCopy |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
color | 目标颜色 | 数据 | color | 目标颜色 要被写入的 Color 实例 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
source | 源颜色 | 数据 | color | 源颜色 要复制的 Color | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
color | 目标颜色 | 数据 | color | 目标颜色 已被更新的目标 Color 实例（透传） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
黑色
黑色常量：返回 cc.Color.BLACK 常量，通道值为 (0, 0, 0, 255)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetBlack |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 黑色 | 数据 | color | 黑色 (0, 0, 0, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
红色
红色常量：返回 cc.Color.RED 常量，通道值为 (255, 0, 0, 255)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetRed |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 红色 | 数据 | color | 红色 (255, 0, 0, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
黄色
黄色常量：返回 cc.Color.YELLOW 常量，通道值为 (255, 255, 0, 255)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetYellow |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 黄色 | 数据 | color | 黄色 (255, 255, 0, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
灰色
灰色常量：返回 cc.Color.GRAY 常量，通道值为 (127, 127, 127, 255)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetGray |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 灰色 | 数据 | color | 灰色 (127, 127, 127, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
克隆颜色
克隆颜色：创建输入颜色的深拷贝副本。 返回一个新的 Color 实例，通道值与输入相同但引用不同。不会修改输入颜色。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorClone |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 要克隆的颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 克隆出的新颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
蓝色
蓝色常量：返回 cc.Color.BLUE 常量，通道值为 (0, 0, 255, 255)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetBlue |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 蓝色 | 数据 | color | 蓝色 (0, 0, 255, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
绿色
绿色常量：返回 cc.Color.GREEN 常量，通道值为 (0, 255, 0, 255)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetGreen |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 绿色 | 数据 | color | 绿色 (0, 255, 0, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
品红
品红常量：返回 cc.Color.MAGENTA 常量，通道值为 (255, 0, 255, 255)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetMagenta |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 品红 | 数据 | color | 品红 (255, 0, 255, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
青色
青色常量：返回 cc.Color.CYAN 常量，通道值为 (0, 255, 255, 255)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetCyan |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 青色 | 数据 | color | 青色 (0, 255, 255, 255) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
设置颜色
设置颜色：将目标颜色的 R / G / B / A 通道设置为指定的数值。 注意： 副作用节点：此节点会直接更新目标 color 实例。通过执行流端口串接以确保执行顺序。 通道值范围为 0~255，超出范围会被引擎钳制。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorSet |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
color | 目标颜色 | 数据 | color | 目标颜色 要被设置的 Color 实例 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
r | R | 数据 | number | 红色通道 要设置的 R 值（0~255） | 输入框 默认值：255 | 可选 |
g | G | 数据 | number | 绿色通道 要设置的 G 值（0~255） | 输入框 默认值：255 | 可选 |
b | B | 数据 | number | 蓝色通道 要设置的 B 值（0~255） | 输入框 默认值：255 | 可选 |
a | A | 数据 | number | 透明度通道 要设置的 A 值（0~255） | 输入框 默认值：255 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
color | 目标颜色 | 数据 | color | 目标颜色 已被更新的目标 Color 实例（透传） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
透明
透明常量：返回 cc.Color.TRANSPARENT 常量，通道值为 (0, 0, 0, 0)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorGetTransparent |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 透明 | 数据 | color | 透明 (0, 0, 0, 0) | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色插值
颜色线性插值：在两个颜色之间按比例进行线性插值，返回新的颜色结果。 当 ratio = 0 时返回起始颜色 from，当 ratio = 1 时返回目标颜色 to，中间值按比例平滑过渡。 适合颜色渐变动画（如受伤闪红、状态变色）、UI 过渡效果等。 结果受引擎 8-bit 存储影响，逐通道插值后会被钳制到 0~255 并取整。该节点返回新的结果颜色，不会原地修改输入。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorLerp |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
from | 起始 | 数据 | color | 起始颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
to | 目标 | 数据 | color | 目标颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
ratio | 比例 | 数据 | number | 插值比例，0 = 起始颜色，1 = 目标颜色 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | color | 插值后的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色缩放
颜色通道缩放：将颜色的每个通道乘以一个标量值，返回新的颜色结果。 等效于 rscale, gscale, bscale, ascale。 结果受引擎 8-bit 存储影响，超出范围的值会被钳制。 该节点返回新的结果颜色，不会原地修改输入。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorScale |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 要缩放的颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
scalar | 缩放值 | 数据 | number | 缩放标量 | 输入框 默认值：1 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | color | 缩放后的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色相乘
颜色逐通道相乘：对两个颜色的 r / g / b / a 逐通道进行乘法运算，返回新的颜色结果。 这是静态逐通道原始数值乘法（Color.multiply(out, a, b)），不是实例 color.multiply(other) 的归一化 tint 乘法。 结果受引擎 8-bit 存储影响，超出 0~255 范围的值会被自动钳制。 该节点返回新的结果颜色，不会原地修改输入。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorMultiply |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | color | 颜色 A | 可编辑控件 默认值：[255,255,255,255] | 必填 |
b | B | 数据 | color | 颜色 B | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | color | 逐通道相乘后的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色相除
颜色逐通道相除：对两个颜色的 r / g / b / a 逐通道进行除法运算（A ÷ B），返回新的颜色结果。 这是静态逐通道原始数值除法。当 B 通道为 0 时，结果取决于引擎行为。 结果受引擎 8-bit 存储影响，会被钳制到 0~255 范围。 该节点返回新的结果颜色，不会原地修改输入。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorDivide |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | color | 被除颜色 A | 可编辑控件 默认值：[255,255,255,255] | 必填 |
b | B | 数据 | color | 除数颜色 B | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | color | 逐通道相除后的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色相加
颜色逐通道相加：对两个颜色的 r / g / b / a 逐通道进行加法运算，返回新的颜色结果。 适合叠加光照颜色、混合特效颜色等。结果受引擎 8-bit (Uint8ClampedArray) 存储影响，超出 0~255 范围的值会被自动钳制。 该节点返回新的结果颜色，不会原地修改输入。底层 out 参数由系统自动管理，不暴露给用户。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorAdd |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | color | 颜色 A | 可编辑控件 默认值：[255,255,255,255] | 必填 |
b | B | 数据 | color | 颜色 B | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | color | 逐通道相加后的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色相减
颜色逐通道相减：对两个颜色的 r / g / b / a 逐通道进行减法运算（A - B），返回新的颜色结果。 结果受引擎 8-bit 存储影响，低于 0 的值会被钳制为 0。 该节点返回新的结果颜色，不会原地修改输入。底层 out 参数由系统自动管理。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorSubtract |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | color | 被减颜色 A | 可编辑控件 默认值：[255,255,255,255] | 必填 |
b | B | 数据 | color | 减数颜色 B | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果 | 数据 | color | 逐通道相减后的颜色 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色严格相等
颜色精确相等：判断两个颜色的 r、g、b、a 是否逐项严格相等。 基于 cc.Color 静态 strictEquals 方法，使用 === 比较每个通道。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorStrictEquals |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
a | A | 数据 | color | 颜色 A | 可编辑控件 默认值：[255,255,255,255] | 必填 |
b | B | 数据 | color | 颜色 B | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isEqual | 相等 | 数据 | boolean | 两个颜色是否完全相等 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色转 CSS
颜色转 CSS 字符串：将颜色转换为指定格式的 CSS 字符串。 支持的格式包括：
- rgba → rgba(r, g, b, a)
- rgb → rgb(r, g, b)
- #rrggbb → #ff8040
- #rrggbbaa → #ff804020 该节点不会修改输入颜色对象。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorToCSS |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 要转换的颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
format | 格式 | 数据 | string | 输出格式：rgba / rgb / #rrggbb / #rrggbbaa | 下拉选择 默认值：“rgba” | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
css | CSS | 数据 | string | CSS 格式字符串 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色转 HSV
颜色转 HSV 色彩空间：将颜色的 RGB 通道转换为色相 (H)、饱和度 (S)、明度 (V)，并额外透传 Alpha 通道。
h、s、v 输出范围均为 01，其中 h=0 对应红色、h≈0.33 对应绿色、h≈0.67 对应蓝色。a 输出范围为 0255。
a 端口是透明度的直接透传，不是 HSV 转换的结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorToHSV |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 要转换的颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
h | H | 数据 | number | 色相（0~1，0=红色, ≈0.33=绿色, ≈0.67=蓝色） | - | 可选 |
s | S | 数据 | number | 饱和度（0~1） | - | 可选 |
v | V | 数据 | number | 明度（0~1） | - | 可选 |
a | A | 数据 | number | 透明度（0~255），直接透传 | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。
颜色转 Vec4
颜色转归一化 Vec4：将颜色的 r / g / b / a（0255）转换为 Vec4(x, y, z, w)（01）。
转换关系为 x = r / 255, y = g / 255, z = b / 255, w = a / 255。
注意：此节点的语义是0255 → 归一化 01 转换。与既有 Vec4FromColor（cc.Vec4.fromColor，0255 通道直接映射到 x/y/z/w）语义不同。如需 0255 通道直接映射，请使用 Vec4FromColor 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | colorToVec4 |
| 分类 | 数学运算 |
| 二级分类 | 几何 |
| 分组 | Color |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 要转换的颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vec4 | Vec4 | 数据 | vector4 | 归一化 Vec4（各分量 0~1） | - | 可选 |
使用场景
- 计算角色移动方向、距离和插值
- 处理 UI 尺寸、碰撞范围和颜色变化
- 组合旋转、矩阵和仿射变换
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 向量和矩阵节点要确认维度匹配。
- 角度、弧度、归一化等概念在不同节点中可能有不同约束。