BillboardGui

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

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

BillboardGui with a TextLabel describing the screen console it floats above.

广告牌的 Size 属性与 GuiObject.Size 有一点不同。虽然 偏移 组件工作相同,但 缩放 组件在 3D 空间中用作螺柱尺寸。

当创建大小比例的 BillboardGui 包含 TextLabel 时,启用标签的 TextScaled 属性有助于使其文本随着镜头距离的变化而缩放。

请注意,像 和 内的互动用户界面元素只会在它们成为父级时才能接收用户输入,通常是通过将 放置在 内来实现的。Adornee 属性可用于在 3D 世界中标记零件或附件,而 BillboardGui 本身仍留在 PlayerGui 中。

请参阅体验内的用户界面以获取有关使用BillboardGui的指南。

缓存行为

为了帮助提高性能,BillboardGui 的外观将被缓存,直到以下情况之一发生,然后其外观将在下一次渲染框中重新计算。

概要

属性

继承自LayerCollector属性继承自GuiBase2d属性

活动

继承自GuiBase2d活动

属性

Active

读取并联

控制子孙是否会接收输入事件。如果 包含一个 ,那个按钮只有在 设置为 在 和 按钮上才能成为可点击的。

请注意,像 和 内的互动用户界面元素只会在它们成为父级时才能接收用户输入,通常是通过将 放置在 内来实现的。Adornee 属性可用于在 3D 世界中标记零件或附件,而 BillboardGui 本身仍留在 PlayerGui 中。

Adornee

读取并联

设置目标 BasePartAttachment ,该 BillboardGui 位于相对于父部件或附件的位置,覆盖父部件或附件。

AlwaysOnTop

读取并联

该属性决定 whether BillboardGui 是否总是会在其他 3D 对象上渲染。

当设置为 false (默认) 时,BillboardGui 像其他 3D 内容一样渲染,被其他 3D 对象遮蔽。当设置为 true 时,BillboardGui 总是在 3D 内容上渲染,外观变化显著:

  • 颜色与它们在 ScreenGui 内出现的方式匹配。
  • 文本可能在高 DPI 设备上显得更锋利。
  • LightInfluence 被视为如果它是 0
  • Brightness 没有效果。

Brightness

读取并联

该属性决定了当 容器的灯光被缩放时的因子,当 > 时灯光被缩放。默认情况下,此属性为 1 ,可以设置为 01000 之间的任何数字。通过修改此属性,BillboardGui 的显示亮度可以更好地匹配其环境。例实例,一个视频广告牌可以在黑暗房间内亮起,通过将 Brightness 提高到 10 来实现。

请注意, 在 Studio 无法访问,且当 或 是 时没有效果。

ClipsDescendants

读取并联

当设置为 true (默认) 时,那些落在 GuiObjects 画布边界之外的 BillboardGui 部分不会被绘制。

即使当这个属性是 falseGuiObjects 那些在画布外完全 **** 的东西也不会渲染。

CurrentDistance

只读
未复制
读取并联

当前距离在螺柱中,BillboardGui 是从玩家的相镜头。更改的事件不会为此属性发射,除非 DistanceStep 大于 0

DistanceLowerLimit

读取并联

确定在距离单位上,BillboardGui将停止对玩家当前相镜头的尺寸进行扩展,默认值为0。如果 的 值低于此值,它将不会超过在这个距离上的值。

DistanceStep

读取并联

决定在玩家的相机靠近或远离 BillboardGui 的距离增加或减少 CurrentDistance 单位大小。属性默认为 0 并从 DistanceLowerLimit 开始回合。

DistanceUpperLimit

读取并联

确定在距离单位上的 BillboardGui 将停止缩放较小尺寸相对于玩家当前摄像镜头的距离。如果 的 大于此值,它将不会比在这个距离小于它。

如果值小于 0 ,该属性将被忽略。默认值是 -1,即属性默认忽略。

ExtentsOffset

读取并联

该属性决定了 BillboardGui 如何从其 Adornee 偏移,相对于模型的 Camera 方向,在模型的 Camera 对齐边界方块的一半单位尺寸。

还见到 StudsOffset 它的工作方式类似,但使用了学位单位,或 ExtentsOffsetWorldSpace 它的工作方式类似,但偏移方向与全球轴相对。

ExtentsOffsetWorldSpace

读取并联

该属性决定了 BillboardGui 如何从其 Adornee 偏移,相对于全球轴,在模型轴对齐边界方块的尺寸单位的一半。

还见到 StudsOffset ,它类似于工作,但使用了螺柱单位,或 ExtentsOffset ,它类似于工作,但偏移方向与 Camera 相对。

LightInfluence

读取并联

控制 BillboardGui 是否受到环境灯光的影响多少,范围为 01 。将其设置为 1 意味着周围的照明拥有完全控制外观,而将其设置为 0 意味着照明没有作用。

MaxDistance

读取并联

此属性控制在渲染停止之前,BillboardGui 会显示多远离相机。值 0inf (默认)意味着没有限制,将无限远地渲染。

对于那些在室外出现的 BillboardGuis ,建议 MaxDistance 高度足够,以确保容器的用户界面在出现或消失时在屏幕上足够小,减少突然出现/消失的效果。

PlayerToHideFrom

读取并联

由脚本用于隐藏特定玩家的 BillboardGui

要向多个玩家隐藏一个 BillboardGui ,将其放入 StarterGui 并使用脚本设置 Enabled 属性,根据是否应该让 LocalPlayer 看到它来设置属性。 属性可以用来将 附加到 或 中的 或 ,而不是将其养育。

Size

读取并联

控制 BillboardGui 在屏幕上的大小。与 GuiObject.Size 不同,此属性的 缩放 组件在 3D 空间中设置广告牌的杆尺寸。

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

方法

活动