Script Graph

使用指南

数学运算 / 几何 / Rect节点

数学运算 / 几何 / Rect 节点手册,包含 17 个节点的用途、引脚、使用场景和注意事项。

16

学习目标

处理数值、向量、矩阵、颜色、矩形和旋转等游戏开发高频数学数据。

覆盖范围

  • 节点数量:17
  • 分类路径:数学运算 / 几何 / Rect

典型使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

通用注意事项

  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

节点索引

节点节点 ID输入/输出执行方式
拆分矩形rectBreak1 / 4立即继续
创建矩形rectCreate4 / 1立即继续
获取矩形 xMaxrectGetXMax1 / 1立即继续
获取矩形 yMaxrectGetYMax1 / 1立即继续
获取矩形尺寸rectGetSize1 / 1立即继续
获取矩形原点rectGetOrigin1 / 1立即继续
获取矩形中心rectGetCenter1 / 1立即继续
矩形包含点rectContainsPoint2 / 1立即继续
矩形包含矩形rectContainsRect2 / 1立即继续
矩形并集rectUnion2 / 1立即继续
矩形插值rectLerp3 / 1立即继续
矩形交集rectIntersection2 / 1立即继续
矩形相等rectEquals2 / 1立即继续
矩形相交rectIntersects2 / 1立即继续
克隆矩形rectClone1 / 1立即继续
两点构建矩形rectFromMinMax2 / 1立即继续
设置矩形rectSet6 / 2立即继续

拆分矩形

拆分轴对齐矩形:将矩形拆解为左下角坐标与宽高四个独立数值。 输出字段为 x、y、width 与 height,对应矩形的四个主属性。

节点信息

字段
节点 IDrectBreak
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect要拆分的轴对齐矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
xX数据number矩形左下角 x 坐标-可选
yY数据number矩形左下角 y 坐标-可选
widthW数据number矩形宽度(width)-可选
heightH数据number矩形高度(height)-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

创建矩形

创建轴对齐矩形:根据左下角坐标与宽高构造一个新的 Rect 实例。 字段顺序为 x / y / width / height,与 Rect 构造器参数顺序一致。2D 游戏开发中常用于定义碰撞区域、点击热区或UI 元素的边界框。 x / y 表示矩形左下角坐标,width / height 表示矩形尺寸。

节点信息

字段
节点 IDrectCreate
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
xX数据number矩形左下角 x 坐标输入框
默认值:0
必填
yY数据number矩形左下角 y 坐标输入框
默认值:0
必填
widthW数据number矩形宽度(width)输入框
默认值:0
必填
heightH数据number矩形高度(height)输入框
默认值:0
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect构造出的轴对齐矩形-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

获取矩形 xMax

获取矩形最大 x 边界:返回矩形右侧边界的 x 坐标。 等于 x + width。

节点信息

字段
节点 IDrectGetXMax
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect要读取 xMax 的矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
xMaxxMax数据number矩形右侧边界 x 坐标 (x + width)-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

获取矩形 yMax

获取矩形最大 y 边界:返回矩形顶部边界的 y 坐标。 等于 y + height。

节点信息

字段
节点 IDrectGetYMax
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect要读取 yMax 的矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
yMaxyMax数据number矩形顶部边界 y 坐标 (y + height)-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

获取矩形尺寸

获取矩形尺寸:返回轴对齐矩形的宽高尺寸。 返回值为 Size(width, height),表示矩形的宽度和高度,不是中心点或右上角坐标。

节点信息

字段
节点 IDrectGetSize
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect要读取尺寸的矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
size尺寸数据size矩形尺寸 Size(width, height)-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

获取矩形原点

获取矩形原点:返回轴对齐矩形的左下角原点坐标。 原点坐标为 (x, y)。输出类型为 Vec2。

节点信息

字段
节点 IDrectGetOrigin
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect要读取原点的矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
origin原点数据vector2矩形左下角原点坐标 (Vec2)-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

获取矩形中心

获取矩形中心点:返回轴对齐矩形的几何中心坐标。 中心点坐标为 (x + width/2, y + height/2)。输出类型为 Vec2。

节点信息

字段
节点 IDrectGetCenter
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect要读取中心点的矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
center中心数据vector2矩形中心点坐标 (Vec2)-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

矩形包含点

判断点是否在矩形内:判断给定的二维点是否位于轴对齐矩形的范围内。 返回 true 表示点在矩形内部(含边界),返回 false 表示点在矩形外部。 游戏开发中常用于鼠标点击检测或触摸判断——例如检测玩家是否点击了某个按钮或图标。注意这是点包含判断,不是矩形包含判断。

节点信息

字段
节点 IDrectContainsPoint
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect用于判断的矩形可编辑控件
默认值:[0,0,0,0]
必填
point数据vector2要判断的二维点可编辑控件
默认值:[0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
contains包含数据boolean点是否在矩形内-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

矩形包含矩形

判断矩形是否完全包含另一矩形:判断第二个矩形是否完全位于第一个矩形的范围内。 返回 true 表示内部矩形完全被外部矩形包含,返回 false 表示存在超出部分。 这是完全包含判断,不是相交判断。如需判断两个矩形是否有任何重叠,请使用 矩形相交 节点。

节点信息

字段
节点 IDrectContainsRect
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect外部矩形数据rect外部矩形(容器)可编辑控件
默认值:[0,0,0,0]
必填
other内部矩形数据rect要判断是否被包含的矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
contains包含数据boolean内部矩形是否完全位于外部矩形内-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

矩形并集

矩形并集:返回同时包住两个矩形的最小轴对齐矩形。 结果矩形是能完整覆盖两个输入矩形的最小包围矩形。游戏开发中常用于计算多个物体的整体包围区域。 该节点返回新的结果矩形,不会原地修改输入。底层 out 参数由系统自动管理。

节点信息

字段
节点 IDrectUnion
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
one矩形 A数据rect第一个矩形可编辑控件
默认值:[0,0,0,0]
必填
other矩形 B数据rect第二个矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result并集数据rect同时包住两个矩形的最小矩形-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

矩形插值

矩形线性插值:在两个矩形之间按比例进行线性插值,返回新的结果矩形。 当 ratio = 0 时返回起始矩形 from,当 ratio = 1 时返回目标矩形 to,中间值按比例平滑过渡。适合实现 UI 元素大小渐变或位置动画效果。 该节点返回新的结果矩形,不会原地修改输入的 from 和 to。底层 out 参数由系统自动管理,不暴露给用户。

节点信息

字段
节点 IDrectLerp
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
from起始数据rect起始矩形可编辑控件
默认值:[0,0,0,0]
必填
to目标数据rect目标矩形可编辑控件
默认值:[0,0,0,0]
必填
ratio比例数据number插值比例,0 = 起始矩形,1 = 目标矩形输入框
默认值:0
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果数据rect插值后的矩形-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

矩形交集

矩形交集:返回两个矩形重叠部分的轴对齐矩形。 如果两个矩形没有重叠区域,返回的矩形宽高可能为零或负值。 该节点返回新的结果矩形,不会原地修改输入。底层 out 参数由系统自动管理。

节点信息

字段
节点 IDrectIntersection
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
one矩形 A数据rect第一个矩形可编辑控件
默认值:[0,0,0,0]
必填
other矩形 B数据rect第二个矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result交集数据rect两个矩形的重叠区域-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

矩形相等

矩形精确相等:判断两个矩形的 x、y、width、height 是否逐项严格相等。 注意:这是精确比较(===),不是 epsilon 近似比较。对于浮点运算结果,微小的精度差异可能导致判定为不相等。

节点信息

字段
节点 IDrectEquals
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
aA数据rect矩形 A可编辑控件
默认值:[0,0,0,0]
必填
bB数据rect矩形 B可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
isEqual相等数据boolean两个矩形是否完全相等-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

矩形相交

矩形相交判断:判断两个轴对齐矩形是否存在重叠区域。 只要两个矩形有任何重叠面积,返回 true;完全不重叠返回 false。 游戏开发中常用于碰撞检测,判断两个 UI 元素或 2D 碰撞体是否接触。注意这是”是否相交”的布尔判断,不是交集区域的计算。如需获取重叠区域,请使用 矩形交集 节点。

节点信息

字段
节点 IDrectIntersects
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect当前矩形可编辑控件
默认值:[0,0,0,0]
必填
other另一矩形数据rect另一个矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
intersects相交数据boolean两个矩形是否有重叠区域-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

克隆矩形

克隆轴对齐矩形:创建输入矩形的深拷贝副本。 返回一个新的 Rect 实例,内容与输入相同但引用不同。不会修改输入矩形。

节点信息

字段
节点 IDrectClone
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect要克隆的轴对齐矩形可编辑控件
默认值:[0,0,0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect克隆出的新矩形-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

两点构建矩形

由两点生成包围矩形:根据两个二维点在 x/y 方向的最小值与最大值,生成最小轴对齐包围矩形。 输入的两个点可以是任意顺序,节点会自动取各分量的最小/最大值来确定矩形范围。适合实现框选或拖选功能。 该节点返回新的结果矩形,不会原地修改输入。底层 out 参数由系统自动管理,不暴露给用户。

节点信息

字段
节点 IDrectFromMinMax
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
minPoint点 A数据vector2第一个二维点可编辑控件
默认值:[0,0]
必填
maxPoint点 B数据vector2第二个二维点可编辑控件
默认值:[0,0]
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
rect矩形数据rect由两点生成的最小轴对齐包围矩形-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。

设置矩形

设置矩形:将目标矩形的坐标与尺寸设置为指定的数值。 注意: 副作用节点:此节点会直接更新目标 rect 实例。通过执行流端口串接以确保执行顺序。

节点信息

字段
节点 IDrectSet
分类数学运算
二级分类几何
分组Rect
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
rect目标矩形数据rect目标矩形
要被设置的 Rect 实例
可编辑控件
默认值:[0,0,0,0]
必填
xX数据numberx 坐标
要设置的左下角 x 值
输入框
默认值:0
可选
yY数据numbery 坐标
要设置的左下角 y 值
输入框
默认值:0
可选
widthW数据number宽度
要设置的宽度值
输入框
默认值:0
可选
heightH数据number高度
要设置的高度值
输入框
默认值:0
可选

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
rect目标矩形数据rect目标矩形
已被更新的目标 Rect 实例(透传)
-可选

使用场景

  • 计算角色移动方向、距离和插值
  • 处理 UI 尺寸、碰撞范围和颜色变化
  • 组合旋转、矩阵和仿射变换

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 向量和矩阵节点要确认维度匹配。
  • 角度、弧度、归一化等概念在不同节点中可能有不同约束。