SurfaceGuiSizingMode

概览

字段	值
Kind	Enum · 枚举 Enum
Realm	common

• Inherit: Int
• 继承链: Int → SurfaceGuiSizingMode

SurfaceGuiSizingMode 是用于描述 SurfaceGui 画布尺寸确定方式的枚举，成员包括 FixedSize 与 PixelsPerWorldUnit，分别对应固定的画布尺寸与按世界单位换算像素的尺寸策略。它通常与 SurfaceGui 的 SizingMode 属性配合使用，并影响 CanvasSize、PixelsPerWorldUnit 与 WorldScale 这几个尺寸相关属性的生效方式。

适用场景

当需要在三维空间中的表面挂接界面并控制其画布缩放行为时使用，例如为 SurfaceGui 指定按固定像素尺寸渲染，或让画布随世界单位比例自动换算，从而在不同观察距离下保持期望的显示效果。

使用要点

先用 game:CreateUnit("SurfaceGui", {...}) 获取 SurfaceGui 实例，再把它的 SizingMode 赋值为 Enums.SurfaceGuiSizingMode.FixedSize 或 Enums.SurfaceGuiSizingMode.PixelsPerWorldUnit，然后按所选模式调整 CanvasSize、PixelsPerWorldUnit 与 WorldScale 属性以匹配目标尺寸。

注意事项

该枚举只能作为属性取值使用，必须写成 Enums.SurfaceGuiSizingMode.xxx 的完整形式，不要用数字替代；SurfaceGui 实例只能通过 CreateUnit 或公开接口返回值获取，不要尝试自行构造。切换 SizingMode 时，另一模式的尺寸属性不会自动转换，需要按当前模式同步设置对应属性。

枚举值

值	名称	说明
0	FixedSize	固定逻辑尺寸
1	PixelsPerWorldUnit	像素密度锚定