SurfaceGui

贴附于场景单位表面的世界空间 UI 画布，支持尺寸、光照、渲染距离与显示开关控制。

概览

贴面UI容器是一种可挂载到场景中的界面承载单位，负责把二维画布内容呈现在三维空间里。它通过尺寸模式、画布尺寸与每单位像素密度等属性控制排版基准，并能调整受光照影响程度、亮度与最大渲染距离来适配不同观察条件。

继承自 BasePart；可通过 World:CreateUnit("SurfaceGui", ...) 创建；返回单个单位

属性

名称	类型	默认值	说明
Enabled	Bool	true	总渲染开关。关闭后画布不渲染，子节点与内部结构不受影响。
SizingMode	SurfaceGuiSizingMode	Enums.SurfaceGuiSizingMode.FixedSize	画布尺寸模式，使用 Enums.SurfaceGuiSizingMode.FixedSize 按固定逻辑尺寸布局，或使用 Enums.SurfaceGuiSizingMode.PixelsPerWorldUnit 按每世界单位像素密度布局。
CanvasSize	Vector2	[700.0, 700.0]	画布逻辑尺寸（像素），需非零。仅 FixedSize 模式驱动布局。
PixelsPerWorldUnit	Vector2	[100.0, 100.0]	每轴像素密度，分量需大于 0。仅 PixelsPerWorldUnit 模式生效。
WorldScale	Vector3	[1.0, 1.0, 1.0]	画布在世界中的尺寸（各轴缩放）。
LightInfluence	Float	1.0	受场景光照影响程度，取值范围 0.0～1.0，默认 1.0。
Brightness	Float	1.0	亮度，取值范围 0.0～10.0，默认 1.0。
MaxDistance	Float	0	最大渲染距离，单位为世界单位；超出该距离则剔除不渲染，0 表示不限制。