SurfaceGui 允许在 3D 世界中将 UI 对象渲染到零件表面,同时还允许基本用户互动发生。与 和 类似,用户界面对象,例如 和 会面向相同方向的表面,可以通过 属性进行编辑。

请注意,如 和 内的互动用户界面元素只会接收用户输入,如果它们属于 ,通常是通过将 放置在 内( 属性可用于将 3D 世界中的某个部分标记为目标,而 本身仍留在 中)。此外,零件的 CanQuery 属性必须为 true 才能接收输入,以便交互用户界面元素收到输入。
请参阅体验内的用户界面以获取有关使用SurfaceGui的指南。
缓存行为
为了帮助提高性能,SurfaceGui 的外观将被缓存,直到以下情况之一发生,然后其外观将在下一次渲染框中重新计算。
- 子孙被添加到或从 SurfaceGui 中删除。
- 一个 descendant 的 SurfaceGui 变化的属性。
- SurfaceGui 自身的属性发生了变化。
概要
属性
决定是否 SurfaceGui 将始终渲染在其他 3D 对象之上。
确定容器 SurfaceGui 的灯光在 LightInfluence 时被缩放的因子,当 0 时灯光被缩放。
在"虚拟像素"中"虚拟屏幕"的大小,使 SurfaceGuis 像素与 ScreenGuis 兼容。
是否绘制在 GuiObjects 画布边界之外的部分 SurfaceGui 画布。
控制 SurfaceGui 是否受环境照明影响多少。
控制 SurfaceGui 在停止渲染之前可以显示多远。
决定每个世界空间单元用于渲染 SurfaceGui 内容的像素密度。
决定 whether SurfaceGui 是否以固定的尺寸或缩放其尺寸来渲染。
设置左键单击开始在 SurfaceGui 上作用而不是在持有的 Tool 上的距离。
将此 SurfaceGui 层与同一面上的其他 SurfaceGuis 关联。
属性
BasePart 在哪里应用 SurfaceGui , 覆盖默认父联盟。
Enum.NormalId 脸上应用 SurfaceGui .
属性
切换这个 LayerCollector 的可见性。
决定是否重置 LayerCollector (删除自己并重新克隆到玩家角色的 PlayerGui )每次玩家角色重生。
控制 GuiObject.ZIndex 如何在这个 LayerCollector 的所有子孙上行为。
属性
活动
继承自GuiBase2d的活动活动
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
当游戏手柄选择移动到、离开或在连接的 或任何子手柄中更改时,发生火焰。