Region3

Region3 表示由两个 Vector3 对角点界定的轴对齐三维区域，并可按指定分辨率向外扩展到网格边界。

概览

Region3 表示由两个 Vector3 对角点界定的轴对齐三维区域，并可按指定分辨率向外扩展到网格边界。

可通过 Region3.New(min, max) 构造

代码示例

构造 Region3 并读取尺寸

-- @runtime client
-- 构造两个对角点，定义三维区域
local minPoint = Vector3.New(0, 0, 0)
local maxPoint = Vector3.New(10, 5, 8)
-- 使用简写构造 Region3 实例
local region = Region3(minPoint, maxPoint)
-- 读取区域的尺寸属性
local size = region.Size
print("区域尺寸: X=" .. size.x .. ", Y=" .. size.y .. ", Z=" .. size.z)

函数

ExpandToGrid

签名：ExpandToGrid(resolution: Float) -> Region3

将当前区域按指定分辨率扩展为对齐网格的更大区域。

参数	类型	说明
resolution	Float

返回值 Region3

按格子大小扩展区域

-- @runtime client
-- 构造一个原始区域
local minVec = Vector3(0, 0, 0)
local maxVec = Vector3(10, 10, 10)
local region = Region3(minVec, maxVec)

-- 按格子大小 2.0 扩展区域，使边界对齐到 2.0 的整数倍
local expanded = region:ExpandToGrid(2.0)

-- 输出扩展后的区域尺寸
print("扩展后区域尺寸:", expanded.Size)

属性

名称	类型	默认值	说明
Size	Vector3	-	获取区域的尺寸，即最大点与最小点的差值。（只读）