使用指南
Cocos 组件 / 2D / Graphics节点
Cocos 组件 / 2D / Graphics 节点手册，包含 30 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：30
- 分类路径：Cocos 组件 / 2D / Graphics
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 闭合路径 | graphicsClose | 2 / 2 | 立即继续 |
| 二次贝塞尔曲线 | graphicsQuadraticCurveTo | 6 / 2 | 立即继续 |
| 画直线到 | graphicsLineTo | 4 / 2 | 立即继续 |
| 获取拐角样式 | graphicsGetLineJoin | 1 / 1 | 立即继续 |
| 获取描边颜色 | graphicsGetStrokeColor | 1 / 1 | 立即继续 |
| 获取末端样式 | graphicsGetLineCap | 1 / 1 | 立即继续 |
| 获取所有属性 | graphicsGetProperties | 1 / 7 | 立即继续 |
| 获取填充颜色 | graphicsGetFillColor | 1 / 1 | 立即继续 |
| 获取线宽 | graphicsGetLineWidth | 1 / 1 | 立即继续 |
| 获取斜接限制 | graphicsGetMiterLimit | 1 / 1 | 立即继续 |
| 获取整体渲染颜色 | graphicsGetColor | 1 / 1 | 立即继续 |
| 矩形 | graphicsRect | 6 / 2 | 立即继续 |
| 描边 | graphicsStroke | 2 / 2 | 立即继续 |
| 清空画布 | graphicsClear | 2 / 2 | 立即继续 |
| 三次贝塞尔曲线 | graphicsBezierCurveTo | 8 / 2 | 立即继续 |
| 设置拐角样式 | graphicsSetLineJoin | 3 / 2 | 立即继续 |
| 设置描边颜色 | graphicsSetStrokeColor | 3 / 2 | 立即继续 |
| 设置末端样式 | graphicsSetLineCap | 3 / 2 | 立即继续 |
| 设置所有属性 | graphicsSetProperties | 9 / 2 | 立即继续 |
| 设置填充颜色 | graphicsSetFillColor | 3 / 2 | 立即继续 |
| 设置线宽 | graphicsSetLineWidth | 3 / 2 | 立即继续 |
| 设置斜接限制 | graphicsSetMiterLimit | 3 / 2 | 立即继续 |
| 设置整体渲染颜色 | graphicsSetColor | 3 / 2 | 立即继续 |
| 填充 | graphicsFill | 2 / 2 | 立即继续 |
| 填充矩形 | graphicsFillRect | 6 / 2 | 立即继续 |
| 椭圆 | graphicsEllipse | 6 / 2 | 立即继续 |
| 移动到 | graphicsMoveTo | 4 / 2 | 立即继续 |
| 圆弧 | graphicsArc | 8 / 2 | 立即继续 |
| 圆角矩形 | graphicsRoundRect | 7 / 2 | 立即继续 |
| 圆形 | graphicsCircle | 5 / 2 | 立即继续 |
闭合路径
闭合路径：闭合当前路径，将最后一点与路径起点连接。 用途：通常与多边形或复杂路径的描边/填充配合使用，确保路径首尾相连。 注意：该节点只负责闭合路径，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsClose |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
二次贝塞尔曲线
二次贝塞尔曲线：从当前画笔位置绘制一条二次贝塞尔曲线到指定终点。 参数：需要一个控制点 (cx, cy) 和一个终点 (x, y)。 注意：该节点只负责追加路径，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsQuadraticCurveTo |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
cx | 控制点 X | 数据 | number | 控制点 X 控制点的 X 坐标。 | 输入框 默认值：0 | 必填 |
cy | 控制点 Y | 数据 | number | 控制点 Y 控制点的 Y 坐标。 | 输入框 默认值：0 | 必填 |
x | 终点 X | 数据 | number | 终点 X 曲线终点的 X 坐标。 | 输入框 默认值：0 | 必填 |
y | 终点 Y | 数据 | number | 终点 Y 曲线终点的 Y 坐标。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
画直线到
画直线到：从当前画笔位置画一条直线到指定坐标。 注意：该节点只负责追加路径，不会立即在屏幕上绘制出可见线段。真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsLineTo |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
x | X | 数据 | number | X 坐标 Graphics 本地 2D 坐标系中的目标 X 坐标值。 | 输入框 默认值：0 | 必填 |
y | Y | 数据 | number | Y 坐标 Graphics 本地 2D 坐标系中的目标 Y 坐标值。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取拐角样式
获取拐角样式：返回 Graphics 组件的线段拐角连接样式。 枚举值：BEVEL（=0）：斜切拐角、ROUND（=1）：圆角拐角、MITER（=2）：尖角斜接。 注意：拐角样式影响后续路径描边的拐点表现，修改不会自动回溯已绘制结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsGetLineJoin |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
lineJoin | 拐角样式 | 数据 | number | 拐角样式 BEVEL（=0）：斜切拐角 ROUND（=1）：圆角拐角 MITER（=2）：尖角斜接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取描边颜色
获取描边颜色：返回 Graphics 组件的当前描边颜色。 作用范围：描边颜色仅影响后续 描边 节点的颜色，不影响 填充 节点的填充颜色。 区分：strokeColor 是描边色，fillColor 是填充色，color 是整体渲染色，三者各自独立，不应混用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsGetStrokeColor |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
strokeColor | 描边颜色 | 数据 | color | 描边颜色 影响后续 描边 节点的颜色。 不等价于填充色 fillColor 或整体渲染色 color。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取末端样式
获取末端样式：返回 Graphics 组件的线段末端样式。 枚举值：BUTT（=0）：平直末端、ROUND（=1）：圆形末端、SQUARE（=2）：方形延伸末端。 注意：末端样式影响后续路径描边的线段末端表现，修改不会自动回溯已绘制结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsGetLineCap |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
lineCap | 末端样式 | 数据 | number | 末端样式 BUTT（=0）：平直末端 ROUND（=1）：圆形末端 SQUARE（=2）：方形延伸末端 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取所有属性
一次性读出 Graphics 组件的全部样式属性：lineWidth、lineJoin、lineCap、strokeColor、fillColor、miterLimit、color。等同于连接多个 获取类节点，但只用一个节点即可。适合调试、批量比较等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsGetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
lineWidth | 线宽 | 数据 | number | 线宽 描边线宽数值。 | - | 可选 |
lineJoin | 拐角样式 | 数据 | number | 拐角样式 BEVEL（=0）：斜切拐角、ROUND（=1）：圆角拐角、MITER（=2）：尖角斜接 | - | 可选 |
lineCap | 末端样式 | 数据 | number | 末端样式 BUTT（=0）：平直末端、ROUND（=1）：圆形末端、SQUARE（=2）：方形延伸末端 | - | 可选 |
strokeColor | 描边颜色 | 数据 | color | 描边颜色 影响后续 描边 节点的颜色。 | - | 可选 |
fillColor | 填充颜色 | 数据 | color | 填充颜色 影响后续 填充 与 填充矩形 节点的颜色。 | - | 可选 |
miterLimit | 斜接限制 | 数据 | number | 斜接限制 尖角斜接长度限制比例。 | - | 可选 |
color | 整体渲染颜色 | 数据 | color | 整体渲染颜色 继承自 UIRenderer 的整体渲染色调。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取填充颜色
获取填充颜色：返回 Graphics 组件的当前填充颜色。 作用范围：填充颜色影响后续 填充 与 填充矩形 节点的颜色，不影响 描边 节点的描边颜色。 区分：fillColor 是填充色，strokeColor 是描边色，color 是整体渲染色，三者各自独立，不应混用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsGetFillColor |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
fillColor | 填充颜色 | 数据 | color | 填充颜色 影响后续 填充 与 填充矩形 节点的颜色。 不等价于描边色 strokeColor 或整体渲染色 color。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取线宽
获取线宽：返回 Graphics 组件的当前描边线宽。 默认值：1。 注意：线宽影响后续 描边 节点的描边宽度，修改线宽不会自动回溯重绘已有的绘制结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsGetLineWidth |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
lineWidth | 线宽 | 数据 | number | 线宽 描边线宽数值。 影响后续 描边 节点的描边宽度。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取斜接限制
获取斜接限制：返回 Graphics 组件的尖角斜接长度限制比例。 默认值：10。 适用场景：该值主要在 lineJoin = MITER（尖角斜接）时体现语义，用于限制尖角的最大延伸比例。当拐角过尖时，超出斜接限制的拐角将自动退化为斜切（BEVEL）样式。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsGetMiterLimit |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
miterLimit | 斜接限制 | 数据 | number | 斜接限制 尖角斜接长度限制比例。 主要在 lineJoin = MITER 时体现语义。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取整体渲染颜色
获取整体渲染颜色：返回 Graphics 组件的整体渲染颜色。 重要区分：color 是继承自 UIRenderer 的整体渲染颜色，它会影响最终渲染输出的整体色调，但不等价于 strokeColor（描边色）或 fillColor（填充色）。 三种颜色语义：strokeColor 控制描边颜色，fillColor 控制填充颜色，color 控制整体渲染色调，三者各自独立。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsGetColor |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 整体渲染颜色 | 数据 | color | 整体渲染颜色 继承自 UIRenderer 的整体渲染色调。 不等价于描边色 strokeColor 或填充色 fillColor。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
矩形
矩形：以指定位置和尺寸绘制一个矩形路径。 注意：该节点只负责追加路径，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。如果需要一键绘制填充矩形，请使用填充矩形 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsRect |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
x | X | 数据 | number | X 坐标 矩形左下角的 X 坐标。 | 输入框 默认值：0 | 必填 |
y | Y | 数据 | number | Y 坐标 矩形左下角的 Y 坐标。 | 输入框 默认值：0 | 必填 |
w | 宽度 | 数据 | number | 宽度 矩形的宽度。 | 输入框 默认值：100 | 必填 |
h | 高度 | 数据 | number | 高度 矩形的高度。 | 输入框 默认值：100 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
描边
描边：按当前描边样式（lineWidth、strokeColor、lineJoin、lineCap 等）把已构建路径渲染到屏幕。 重要：路径构建节点（moveTo、lineTo、arc 等）本身通常不会直接产生最终可见结果，它们只是”积累路径”。描边 节点才是真正把路径绘制到屏幕的关键步骤。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsStroke |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
清空画布
清空画布：清除当前 Graphics 组件已有的全部绘制结果。 用途：适合在重绘前调用，先清空已有内容再重新构建路径和绘制。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsClear |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
三次贝塞尔曲线
三次贝塞尔曲线：从当前画笔位置绘制一条三次贝塞尔曲线到指定终点。 参数：需要两个控制点 (c1x, c1y) 和 (c2x, c2y)，以及一个终点 (x, y)。 注意：该节点只负责追加路径，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsBezierCurveTo |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
c1x | 控制点1 X | 数据 | number | 控制点 1 X 第一个控制点的 X 坐标。 | 输入框 默认值：0 | 必填 |
c1y | 控制点1 Y | 数据 | number | 控制点 1 Y 第一个控制点的 Y 坐标。 | 输入框 默认值：0 | 必填 |
c2x | 控制点2 X | 数据 | number | 控制点 2 X 第二个控制点的 X 坐标。 | 输入框 默认值：0 | 必填 |
c2y | 控制点2 Y | 数据 | number | 控制点 2 Y 第二个控制点的 Y 坐标。 | 输入框 默认值：0 | 必填 |
x | 终点 X | 数据 | number | 终点 X 曲线终点的 X 坐标。 | 输入框 默认值：0 | 必填 |
y | 终点 Y | 数据 | number | 终点 Y 曲线终点的 Y 坐标。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置拐角样式
设置拐角样式：设置 Graphics 组件的线段拐角连接样式。 枚举值：BEVEL（=0）：斜切拐角、ROUND（=1）：圆角拐角、MITER（=2）：尖角斜接。 注意：拐角样式影响后续路径描边的拐点表现，修改不会自动回溯已绘制结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsSetLineJoin |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
lineJoin | 拐角样式 | 数据 | number | 拐角样式 BEVEL（斜切拐角）= 0、ROUND（圆角拐角）= 1、MITER（尖角斜接）= 2。 | 下拉选择 默认值：2 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置描边颜色
设置描边颜色：设置 Graphics 组件的描边颜色。 作用范围：描边颜色仅影响后续 描边 节点的颜色，不影响 填充 节点的填充颜色。 区分：strokeColor 是描边色，fillColor 是填充色，color 是整体渲染色，三者各自独立，不应混用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsSetStrokeColor |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
strokeColor | 描边颜色 | 数据 | color | 描边颜色 影响后续 描边 节点的颜色。 不等价于填充色 fillColor 或整体渲染色 color。 | 可编辑控件 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置末端样式
设置末端样式：设置 Graphics 组件的线段末端样式。 枚举值：BUTT（=0）：平直末端、ROUND（=1）：圆形末端、SQUARE（=2）：方形延伸末端。 注意：末端样式影响后续路径描边的线段末端表现，修改不会自动回溯已绘制结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsSetLineCap |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
lineCap | 末端样式 | 数据 | number | 末端样式 BUTT（平直末端）= 0、ROUND（圆形末端）= 1、SQUARE（方形延伸末端）= 2。 | 下拉选择 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置所有属性
一次性批量修改 Graphics 组件的多个样式属性。 公开引脚语义（重要）：除 exe 与 graphics 外，所有可写属性引脚默认不公开（isPublic: false），只有被显式公开的引脚才参与写入。若想保留目标属性原值不变，必须保持引脚不公开——仅断开连线不够，已公开的引脚会用内联控件默认值覆盖原值。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsSetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
lineWidth | 线宽 | 数据 | number | 线宽 描边线宽数值。默认不公开；公开后才参与写入。 | 输入框 默认值：1 | 可选 默认隐藏 |
lineJoin | 拐角样式 | 数据 | number | 拐角样式 BEVEL（=0）：斜切拐角、ROUND（=1）：圆角拐角、MITER（=2）：尖角斜接。默认不公开；公开后才参与写入。 | 下拉选择 默认值：2 | 可选 默认隐藏 |
lineCap | 末端样式 | 数据 | number | 末端样式 BUTT（=0）：平直末端、ROUND（=1）：圆形末端、SQUARE（=2）：方形延伸末端。默认不公开；公开后才参与写入。 | 下拉选择 默认值：0 | 可选 默认隐藏 |
strokeColor | 描边颜色 | 数据 | color | 描边颜色 影响后续 描边 节点的颜色。默认不公开；公开后才参与写入。 | 可编辑控件 | 可选 默认隐藏 |
fillColor | 填充颜色 | 数据 | color | 填充颜色 影响后续 填充 与 填充矩形 节点的颜色。默认不公开；公开后才参与写入。 | 可编辑控件 | 可选 默认隐藏 |
miterLimit | 斜接限制 | 数据 | number | 斜接限制 尖角斜接长度限制比例。默认不公开；公开后才参与写入。 | 输入框 默认值：10 | 可选 默认隐藏 |
color | 整体渲染颜色 | 数据 | color | 整体渲染颜色 继承自 UIRenderer 的整体渲染色调。默认不公开；公开后才参与写入。 | 可编辑控件 | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置填充颜色
设置填充颜色：设置 Graphics 组件的填充颜色。 作用范围：填充颜色影响后续 填充 与 填充矩形 节点的颜色，不影响 描边 节点的描边颜色。 区分：fillColor 是填充色，strokeColor 是描边色，color 是整体渲染色，三者各自独立，不应混用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsSetFillColor |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
fillColor | 填充颜色 | 数据 | color | 填充颜色 影响后续 填充 与 填充矩形 节点的颜色。 不等价于描边色 strokeColor 或整体渲染色 color。 | 可编辑控件 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置线宽
设置线宽：设置 Graphics 组件的描边线宽。 默认值：1。 注意：线宽影响后续 描边 节点的描边宽度，修改线宽不会自动回溯重绘已有的绘制结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsSetLineWidth |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
lineWidth | 线宽 | 数据 | number | 线宽 描边线宽数值。 影响后续 描边 节点的描边宽度。 | 输入框 默认值：1 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置斜接限制
设置斜接限制：设置 Graphics 组件的尖角斜接长度限制比例。 默认值：10。 适用场景：该值主要在 lineJoin = MITER（尖角斜接）时体现语义，用于限制尖角的最大延伸比例。当拐角过尖时，超出斜接限制的拐角将自动退化为斜切（BEVEL）样式。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsSetMiterLimit |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
miterLimit | 斜接限制 | 数据 | number | 斜接限制 尖角斜接长度限制比例。 主要在 lineJoin = MITER 时体现语义。 | 输入框 默认值：10 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置整体渲染颜色
设置整体渲染颜色：设置 Graphics 组件的整体渲染颜色。 重要区分：color 是继承自 UIRenderer 的整体渲染颜色，它会影响最终渲染输出的整体色调，但不等价于 strokeColor（描边色）或 fillColor（填充色）。 三种颜色语义：strokeColor 控制描边颜色，fillColor 控制填充颜色，color 控制整体渲染色调，三者各自独立。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsSetColor |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
color | 整体渲染颜色 | 数据 | color | 整体渲染颜色 继承自 UIRenderer 的整体渲染色调。 不等价于描边色 strokeColor 或填充色 fillColor。 | 可编辑控件 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
填充
填充：按当前填充颜色（fillColor）填充已构建路径的封闭区域。 重要：路径构建节点（moveTo、lineTo、arc 等）本身通常不会直接产生最终可见结果，它们只是”积累路径”。填充 节点才是真正把路径填充绘制到屏幕的关键步骤。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsFill |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
填充矩形
填充矩形：以指定位置和尺寸绘制一个填充矩形。 快捷写法：该节点等价于”先构建矩形路径（rect），再执行填充（fill）“，适合快速绘制填充矩形，减少连线复杂度。 填充颜色：使用当前 fillColor 设定的颜色进行填充。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsFillRect |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
x | X | 数据 | number | X 坐标 填充矩形左下角的 X 坐标。 | 输入框 默认值：0 | 必填 |
y | Y | 数据 | number | Y 坐标 填充矩形左下角的 Y 坐标。 | 输入框 默认值：0 | 必填 |
w | 宽度 | 数据 | number | 宽度 填充矩形的宽度。 | 输入框 默认值：100 | 必填 |
h | 高度 | 数据 | number | 高度 填充矩形的高度。 | 输入框 默认值：100 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
椭圆
椭圆：以指定中心和半径绘制一个椭圆路径。 注意：该节点只负责追加路径，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsEllipse |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
cx | 中心 X | 数据 | number | 中心 X 椭圆中心的 X 坐标。 | 输入框 默认值：0 | 必填 |
cy | 中心 Y | 数据 | number | 中心 Y 椭圆中心的 Y 坐标。 | 输入框 默认值：0 | 必填 |
rx | X 半径 | 数据 | number | X 半径 椭圆的水平半径。 | 输入框 默认值：50 | 必填 |
ry | Y 半径 | 数据 | number | Y 半径 椭圆的垂直半径。 | 输入框 默认值：50 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
移动到
移动到：将画笔移动到指定坐标，作为新路径段的起点。 注意：moveTo 只移动起点位置，不会直接绘制出可见线段。路径构建节点只负责”积累路径”，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsMoveTo |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
x | X | 数据 | number | X 坐标 Graphics 本地 2D 坐标系中的 X 坐标值。 | 输入框 默认值：0 | 必填 |
y | Y | 数据 | number | Y 坐标 Graphics 本地 2D 坐标系中的 Y 坐标值。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
圆弧
圆弧：以指定圆心和半径绘制一段圆弧路径。 角度单位：startAngle 与 endAngle 的单位为弧度，不是角度制。例如半圆为 Math.PI（约 3.14159），整圆为 2 * Math.PI（约 6.28318）。 方向：counterclockwise 为 false 时顺时针绘制，为 true 时逆时针绘制。 注意：该节点只负责追加路径，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsArc |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
cx | 圆心 X | 数据 | number | 圆心 X 圆弧圆心的 X 坐标。 | 输入框 默认值：0 | 必填 |
cy | 圆心 Y | 数据 | number | 圆心 Y 圆弧圆心的 Y 坐标。 | 输入框 默认值：0 | 必填 |
r | 半径 | 数据 | number | 半径 圆弧的半径。 | 输入框 默认值：50 | 必填 |
startAngle | 起始角度 | 数据 | number | 起始角度（弧度） 圆弧的起始角度，单位为弧度，不是角度制。 例如：0 为三点钟方向，Math.PI / 2 为六点钟方向。 | 输入框 默认值：0 | 必填 |
endAngle | 终止角度 | 数据 | number | 终止角度（弧度） 圆弧的终止角度，单位为弧度，不是角度制。 例如：Math.PI 为半圆，2 * Math.PI 为整圆。 | 输入框 默认值：3.141592653589793 | 必填 |
counterclockwise | 逆时针 | 数据 | boolean | 逆时针 false 为顺时针绘制，true 为逆时针绘制。 | 开关 默认值：false | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
圆角矩形
圆角矩形：以指定位置、尺寸和圆角半径绘制一个圆角矩形路径。 注意：该节点只负责追加路径，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsRoundRect |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
x | X | 数据 | number | X 坐标 圆角矩形左下角的 X 坐标。 | 输入框 默认值：0 | 必填 |
y | Y | 数据 | number | Y 坐标 圆角矩形左下角的 Y 坐标。 | 输入框 默认值：0 | 必填 |
w | 宽度 | 数据 | number | 宽度 圆角矩形的宽度。 | 输入框 默认值：100 | 必填 |
h | 高度 | 数据 | number | 高度 圆角矩形的高度。 | 输入框 默认值：100 | 必填 |
r | 圆角半径 | 数据 | number | 圆角半径 四个角的圆角半径。 | 输入框 默认值：10 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
圆形
圆形：以指定中心和半径绘制一个圆形路径。 注意：该节点只负责追加路径，真正把路径绘制到屏幕需要调用 描边 或 填充 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | graphicsCircle |
| 分类 | Cocos 组件 |
| 二级分类 | 2D |
| 分组 | Graphics |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 要操作的 Graphics 组件。 该组件负责在当前节点上生成或清除 2D 绘制结果。 | - | 必填 |
cx | 中心 X | 数据 | number | 中心 X 圆心的 X 坐标。 | 输入框 默认值：0 | 必填 |
cy | 中心 Y | 数据 | number | 中心 Y 圆心的 Y 坐标。 | 输入框 默认值：0 | 必填 |
r | 半径 | 数据 | number | 半径 圆的半径。 | 输入框 默认值：50 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
graphics | Graphics 组件 | 数据 | cc.Component / Graphics | 目标 Graphics 组件 透传当前操作的 Graphics 组件，便于链式绘制。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。