BillboardGui 是用于在 3D 空间中显示 UI 对象的容器,但始终面向相镜头。容器的位置相对于父级 BasePart 或 Attachment (或 Adornee )。对于 BaseParts , 使用了 Position 属性,而对于 Attachments , 使用了 WorldPosition 属性。

广告牌的 Size 属性与 GuiObject.Size 有一点不同。虽然 偏移 组件工作相同,但 缩放 组件在 3D 空间中用作螺柱尺寸。
当创建大小比例的 BillboardGui 包含 TextLabel 时,启用标签的 TextScaled 属性有助于使其文本随着镜头距离的变化而缩放。
请注意,像 和 内的互动用户界面元素只会在它们成为父级时才能接收用户输入,通常是通过将 放置在 内来实现的。Adornee 属性可用于在 3D 世界中标记零件或附件,而 BillboardGui 本身仍留在 PlayerGui 中。
请参阅体验内的用户界面以获取有关使用BillboardGui的指南。
缓存行为
为了帮助提高性能,BillboardGui 的外观将被缓存,直到以下情况之一发生,然后其外观将在下一次渲染框中重新计算。
- 子孙被添加到或从 BillboardGui 中删除。
- 一个 descendant 的 BillboardGui 变化的属性。
- BillboardGui 自身的属性发生了变化。
概要
属性
控制子孙是否会接收输入事件。
设置 BillboardGui 定位到的目标零件或附件。
决定是否 BillboardGui 将始终渲染在其他 3D 对象之上。
确定容器 BillboardGui 的灯光在 LightInfluence 时被缩放的因子,当 0 时灯光被缩放。
是否绘制在 GuiObjects 画布边界之外的部分 BillboardGui 画布。
当前距离在螺柱中,BillboardGui 是从玩家的相镜头。
确定在距离单位上的 BillboardGui 将停止扩展更大的尺寸的距离。
决定在玩家的相机靠近或远离 BillboardGui 的距离增加或减少 CurrentDistance 单位大小。
决定在距离单位上的 BillboardGui 将停止缩放变小的距离。
决定如何将 BillboardGui 从其 Adornee 偏移,相对于模型的 Camera 方向,在模型的 Camera 对齐边界方块的一半单位尺寸。
决定如何将 BillboardGui 从其 Adornee 中抵消,相对于全球轴,在模型轴对齐边界方块的尺寸单位的一半。
控制 BillboardGui 是否受环境照明影响多少。
控制 BillboardGui 在停止渲染之前可以显示多远。
由脚本用于隐藏特定玩家的 BillboardGui 。
控制 BillboardGui 在屏幕上的大小。
在尺寸相对单位中的 2D 抵消,具有像锚点一样的作用。
决定如何将 BillboardGui 从其 Adornee 中抵消,相对于 Camera 方向。
决定如何将 BillboardGui 从其 Adornee 中抵消,与全球轴相对。
切换这个 LayerCollector 的可见性。
决定是否重置 LayerCollector (删除自己并重新克隆到玩家角色的 PlayerGui )每次玩家角色重生。
控制 GuiObject.ZIndex 如何在这个 LayerCollector 的所有子孙上行为。
活动
继承自GuiBase2d的活动- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
当游戏手柄选择移动到、离开或在连接的 或任何子手柄中更改时,发生火焰。
属性
Active
控制子孙是否会接收输入事件。如果 包含一个 ,那个按钮只有在 设置为 在 和 按钮上才能成为可点击的。
请注意,像 和 内的互动用户界面元素只会在它们成为父级时才能接收用户输入,通常是通过将 放置在 内来实现的。Adornee 属性可用于在 3D 世界中标记零件或附件,而 BillboardGui 本身仍留在 PlayerGui 中。
AlwaysOnTop
该属性决定 whether BillboardGui 是否总是会在其他 3D 对象上渲染。
当设置为 false (默认) 时,BillboardGui 像其他 3D 内容一样渲染,被其他 3D 对象遮蔽。当设置为 true 时,BillboardGui 总是在 3D 内容上渲染,外观变化显著:
- 颜色与它们在 ScreenGui 内出现的方式匹配。
- 文本可能在高 DPI 设备上显得更锋利。
- LightInfluence 被视为如果它是 0 。
- Brightness 没有效果。
Brightness
该属性决定了当 容器的灯光被缩放时的因子,当 > 时灯光被缩放。默认情况下,此属性为 1 ,可以设置为 0 和 1000 之间的任何数字。通过修改此属性,BillboardGui 的显示亮度可以更好地匹配其环境。例实例,一个视频广告牌可以在黑暗房间内亮起,通过将 Brightness 提高到 10 来实现。
请注意, 在 Studio 无法访问,且当 或 是 时没有效果。
ClipsDescendants
当设置为 true (默认) 时,那些落在 GuiObjects 画布边界之外的 BillboardGui 部分不会被绘制。
即使当这个属性是 false , GuiObjects 那些在画布外完全 **** 的东西也不会渲染。
DistanceStep
决定在玩家的相机靠近或远离 BillboardGui 的距离增加或减少 CurrentDistance 单位大小。属性默认为 0 并从 DistanceLowerLimit 开始回合。
DistanceUpperLimit
确定在距离单位上的 BillboardGui 将停止缩放较小尺寸相对于玩家当前摄像镜头的距离。如果 的 大于此值,它将不会比在这个距离小于它。
如果值小于 0 ,该属性将被忽略。默认值是 -1,即属性默认忽略。
ExtentsOffset
该属性决定了 BillboardGui 如何从其 Adornee 偏移,相对于模型的 Camera 方向,在模型的 Camera 对齐边界方块的一半单位尺寸。
还见到 StudsOffset 它的工作方式类似,但使用了学位单位,或 ExtentsOffsetWorldSpace 它的工作方式类似,但偏移方向与全球轴相对。
ExtentsOffsetWorldSpace
该属性决定了 BillboardGui 如何从其 Adornee 偏移,相对于全球轴,在模型轴对齐边界方块的尺寸单位的一半。
还见到 StudsOffset ,它类似于工作,但使用了螺柱单位,或 ExtentsOffset ,它类似于工作,但偏移方向与 Camera 相对。
MaxDistance
此属性控制在渲染停止之前,BillboardGui 会显示多远离相机。值 0 或 inf (默认)意味着没有限制,将无限远地渲染。
对于那些在室外出现的 BillboardGuis ,建议 MaxDistance 高度足够,以确保容器的用户界面在出现或消失时在屏幕上足够小,减少突然出现/消失的效果。
PlayerToHideFrom
由脚本用于隐藏特定玩家的 BillboardGui 。
要向多个玩家隐藏一个 BillboardGui ,将其放入 StarterGui 并使用脚本设置 Enabled 属性,根据是否应该让 LocalPlayer 看到它来设置属性。 属性可以用来将 附加到 或 中的 或 ,而不是将其养育。
SizeOffset
在尺寸相对单位中的 2D 抵消,具有像锚点一样的作用。这可以与 GuiObject.AnchorPoint 属性相似使用,但值是不同的。
<tbody><tr><td><code>0, 0</code></td><td>用户界面将被锚定在其中心的默认值。</td></tr><tr><td><code>0.5, 0.5</code></td><td>用户界面将锚定在左下角。</td></tr><tr><td><code>0.5, -0.5</code></td><td>用户界面将锚定在左上角。</td></tr><tr><td><code>-0.5, 0.5</code></td><td>用户界面将锚定在右上角。</td></tr><tr><td><code>-0.5, -0.5</code></td><td>用户界面将锚定在右下角。</td></tr></tbody>
尺寸抵消 | 说明 |
---|
还见到 StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 以及 ExtentsOffsetWorldSpace 这些偏移属性,它们在 3D 空间工作,而不是在 2D 空间。
StudsOffset
该属性决定了 BillboardGui 如何从其 Adornee 在螺柱上抵消,相对于 Camera 方向。
还见到 StudsOffsetWorldSpace ,其工作方式类似,但偏移方向与全球轴相对。
StudsOffsetWorldSpace
该属性决定了 BillboardGui 如何从其 Adornee 在螺柱上抵消,相对于全球轴。
还见到 StudsOffset ,其工作方式类似,除了偏移方向相对于 Camera 。