Rect

概览

字段	值
Kind	Data · 数据 Data
Realm	common

Rect 表示二维平面上的轴对齐矩形区域，由最小角点和最大角点定义边界，并提供 Width、Height 读取区域尺寸。

适用场景

用于 UI 布局、二维区域配置或需要传递矩形边界的接口参数。

使用要点

使用 Rect.New(minX, minY, maxX, maxY) 或 Rect(minX, minY, maxX, maxY) 构造；通过 Min、Max、Width、Height 读取边界和尺寸。

注意事项

矩形为不可通过游戏世界创建的数据类型，只能自行构造后传递给相关接口。Min 与 Max 的坐标顺序应保持一致，否则读取到的宽度或高度可能与预期相反。该类型只提供构造函数，区域的计算与判定需由调用方自行完成。

代码示例

构造矩形并读取边界

-- @runtime client
local rect = Rect.New(10, 20, 100, 80)
print('Min:', rect.Min, 'Max:', rect.Max)
print('Width:', rect.Width, 'Height:', rect.Height)

属性 (4)

Name	类型	默认值	说明
Min	Vector2	-	Rect 的 Min 属性表示矩形的左上角位置，类型为 Vector2。该属性在 Meta 契约中标记为只读，可通过 Rect 实例读取矩形的左上角坐标。
Max	Vector2	-	Rect 的 Max 属性表示矩形的右下角位置，类型为 Vector2。该属性在 Meta 契约中标记为只读，可通过 Rect 实例读取矩形的右下角坐标。
Width	Float	-	Rect 的 Width 属性表示矩形的宽度，类型为 Float。该属性在 Meta 契约中标记为只读，可通过 Rect 实例读取当前矩形在横向上的尺寸。
Height	Float	-	Rect 的 Height 属性表示矩形的高度，类型为 Float。该属性在 Meta 契约中标记为只读，可通过 Rect 实例读取当前矩形在纵向上的尺寸。

关联类型

• Vector2

函数 (1)

New

签名：New(minX: Float, minY: Float, maxX: Float, maxY: Float) -> Rect

创建一个新的 Rect 实例，通过指定左上角和右下角的坐标来定义矩形区域。

参数	类型	说明
minX	Float	-
minY	Float	-
maxX	Float	-
maxY	Float	-

返回值 Rect

示例代码

构造矩形区域

-- @runtime client
local r = Rect.New(0, 0, 100, 100)  -- Min=(0,0) Max=(100,100)
print(string.format('Min: %s, Max: %s', tostring(r.Min), tostring(r.Max)))