Faces

概览

字段	值
Kind	Data · 数据 Data
Realm	common

Faces 是面集合数据类型，用于用面名称字符串选择 Right、Top、Back、Left、Bottom、Front 六个方向中的一个或多个面。

适用场景

用于在脚本内部组合并检查一组面标记；当前公开 Surface 没有把 Faces 声明为网格编辑、碰撞过滤或效果配置 API 的参数，具体消费入口应以对应 Meta 签名为准。

使用要点

通过 Faces.New(...) 构造实例，参数是面名称字符串可变参数，不是六个布尔值。构造后 Right/Top/Back/Left/Bottom/Front 属性为 Bool，表示对应面是否被选中。

注意事项

Faces.New(...) 接收面名称字符串，例如 Faces.New("Right", "Top")；不要把 Right/Top 等 Bool 属性写成字符串。属性只表示是否选中某个面，不能存放颜色、材质或面名称。

代码示例

用面名称构造 Faces 并读取布尔属性

-- @runtime client
local faces = Faces.New("Right", "Top")
if faces.Right then
    print("选中了 Right 面")
end
if faces.Top then
    print("选中了 Top 面")
end
print("Front 是否选中:", faces.Front)

属性 (6)

Name	类型	默认值	说明
Right	Bool	-	Faces 数据类型的右面布尔属性，标题为“右面”，类型为 Bool，用于描述 Faces 对象中右面这一面的状态。该属性为只读，作者可以读取其值但不能直接修改。
Top	Bool	-	Faces 数据类型的顶面布尔属性，标题为“顶面”，类型为 Bool，用于描述 Faces 对象中顶面这一面的状态。该属性为只读属性，作者可读取其值但不可修改。
Back	Bool	-	Faces 数据类型的背面布尔属性，标题为“背面”，类型为 Bool，用于描述 Faces 对象中背面这一面的状态。该属性为只读属性，作者可在公开契约中读取其值，但不能直接赋值修改。
Left	Bool	-	Faces 数据类型的左面布尔属性，标题为“左面”，类型为 Bool，用于描述 Faces 对象中左面这一面的状态。该属性为只读属性，作者可读取而不可赋值修改。
Bottom	Bool	-	Faces 数据类型的底面布尔属性，标题为“底面”，类型为 Bool，用于描述 Faces 对象中底面这一面的状态。该属性为只读属性，作者可读取但不可直接修改。
Front	Bool	-	Faces 数据类型的正面布尔属性，标题为“正面”，类型为 Bool，用于表示 Faces 对象中正面这一面的状态。该属性为只读，作者可读取其值但不可修改。

函数 (1)

New

签名：New(...: String) -> Faces

创建一个新的 Faces 对象，用于表示一组面名称。

参数	类型	说明
...	String	面名称（可变参数）

返回值 Faces

示例代码

选择多个面

-- @runtime client
local faces = Faces.New("Right", "Top", "Front")
print("Right:", faces.Right)
print("Top:", faces.Top)
print("Front:", faces.Front)