BillboardGui

控制子子会否接收输入事件。如果UI包含一个 GuiButton 按钮，那个按钮只会在Active 设置为 true 在 both BillboardGui 和按钮上才会变为可点击。

只有在玩家GUI上关联到BillboardGuis才会收到用户输入。BillboardGui.Adornee属性可以用来在工作区中将目标部分标记在UI上，而UI本身位于PlayerGui。

设置广告牌图形用户界面位置相对的目标部分或附件。如果没有 Adornee 被设置，那么 Parent 将被使用。

决定 BillboardGui 是否会在 3D 内容之上渲染，或被其覆盖。

设置为“关闭”时，广告牌图会像其他3D内容一样渲染，并且会被其他3D对象覆盖。

设置为“真”，它总是会在 3D 内容上渲染，且外观发生 значитель变化：

• 颜色与它们在 ScreenGui 中的样子匹配。
• 文本可能会在高 DPI 设备上更锋利。
• BillboardGui.LightInfluence 被处理为 0 。
• BillboardGui.Brightness 没有效果。

亮度 决定图形GUI界面发射的光的比例。默认情况下，此属性为 1 ，可以设置为 0 到 1000 之间的任何数字。

通过修改此属性，可以更好地将 GUI 的亮度匹配到其环境。 例实例，如果在 Times Square 找到的视频广告牌照亮，可以使其在明亮的一天更加明显。

这个属性在以下场景中不会产生任何效果，其中 GUI 不会发出光：

• 当 AlwaysOnTop 是真的时候，每个像素的颜色都是屏幕上显示的颜色。
• 当 LightInfluence 是 1 时，所有从 GUI 发出的光都会反射到环境中，而不是发出。

设置为 true 时，会话外的 GuiObjects 部分不会被绘制。

即使当此属性为 false ，在 BillboardGui 的画布上完全不会渲染。

Class.BillboardGui 从玩家的相镜头上的当前距离。一个更改的事件不会为此属性发射，除非 gui 的 BillboardGui.DistanceStep 超过 0。

确定BillboardGui的尺寸在相对于玩家当前镜头的大小上会停止缩放。如果 Class.BillboardGui的距离小于此值，它将不会在此距离上缩放。此属性的默认值为 0 格。

确定尺寸 BillboardGui.CurrentDistance 增加和减少在游玩家戏员的相机移动更近和更远从 BillboardGui 。 属性默认为 0 并从 BillboardGui.DistanceLowerLimit 开始。

例如，如果此属性设置为 0.5 ，玩家的相机从 0 开始移动，那么当前距离将增加 0 -> 0.5 -> 1 -> 1.5 -> ... 等等。

确定游戏中的对象在相对于玩家的当前摄像镜头的尺寸上会缩放的距离。如果游戏中的对象的距离高于此值，它将不会缩放小于此值。

如果值小于 0，这个属性将被忽略。默认值是 -1，这意味着该属性由默认值被忽略。

ExtentsOffset 决定 BillboardGui 的 Offset 从其 Adornee ，相对于 Camera 方向和单位是半尺寸模型的 0> Class.Camera0> - 对齐边方块。

还请参阅：

• ExtentsOffsetWorldSpace，其作用类似于除了偏移方向相对于全球轴以外
• StudsOffset，其中单位不是 studs

ExtentsOffsetWorldSpace 决定 BillboardGui 的 Offset 从其 Adornee ，相对于全球轴和单位是半尺寸模型的轴对齐边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边框的边方块

还请参阅：

• ExtentsOffset，其工作方式与偏移方向相同，除了偏移方向是相对于 Camera 的
• StudsOffsetWorldSpace，其中单位是 studs

控制广告牌图形是否受到环境中的照明影响。

设置为 0 时，UI 会像 LCD 屏幕一样行为，作为其自己的光源，无论周围的照明如何。

当设置为 1 时，UI 会像纸片一样反射光，只会反射另一个源的光。

Class.BillboardGui 的 MaxDistance 属性设置广告牌可以从相机远程得到多远，然后仍然可以被绘制。如果相机和广告牌远离了最大距离，那么广告牌就无法在任何其他广告牌或容器 GUI 对象上的任何其他属性上显示。此属性的默认值为无限。

如果此值设置为小于或等于 0 ，最大距离将被视为无限，广告牌永远都不会被吊显。

例子

-- 等待默认相机/控制脚本加载
task.wait(5)

-- 声明和初始化对象
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")

-- 设置相机输入
camera.CameraType = Enum.CameraType.Scriptable

-- 设置零件的位置并锁定在 plac场景
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true

-- 设置广告牌
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)

-- 设置标签
label.Size = UDim2.fromScale(1, 1)

-- 设置对象的父亲
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace

-- 将相机移动到零件旁边。 稍等一段时间，然后将相机移镜头
local cameraPosition0 = part.Position + Vector3.new(0, 0, 10)
local cameraPosition1 = part.Position + Vector3.new(0, 0, 20)
camera.CFrame = CFrame.lookAt(cameraPosition0, part.Position)

-- 广告牌内容将在此显示
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

用于隐藏特定玩家从 BillboardGui 的内容。

要隐藏 UI 对于多个玩家，请将 BillboardGui 放置在 StarterGui 中，并使用脚本设置 BillboardGui.Enabled 属性

控制屏幕上的广告牌指示牌的大小。

大小的比例部件在 stud 单位上解释为一个大小，而且 if 大小值使用的话，UI 会自动缩放。

大小的缩放和抵消部分可以在同一时间使用。

一个 2D 偏移在尺寸相对单位中，作为锚定点。 这可以与 GuiObject.AnchorPoint 属性类似，但值是不同的。

通用值

| 大小调整 | 说明 | | ：| | | 0.0, 0.0 | 默认。 UI 将在其中心锚定。 | | 0.5, 0.5 | UI 将在左下角锚定。 | | 0.5, -0.5 | UI 将在右

还请参阅：

• StudsOffset，StudsOffsetWorldSpace，ExtentsOffset，0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtentsOffset0>，其中所有其他偏移属性在 3D 空间中都不起作用

StudsOffset 确定 BillboardGui 的 Offset 从其 Adornee 与 Camera 对象的相对位置，取决于使用单位在 studs 的单位。

还请参阅：

• StudsOffsetWorldSpace，其工作方式与偏移方向相同，但偏移方向与全球轴相对
• ExtentsOffset，其作用类似于除了单位是模型 Camera-aligned 边界方块的一半尺寸外

StudsOffsetWorldSpace 确定 BillboardGui 的 Offset 从其 Adornee 与相对于全球轴，用于 studs 的单位。

还请参阅：

• StudsOffset，其工作方式与偏移方向相同，除了偏移方向是相对于 Camera 的
• ExtentsOffsetWorldSpace，其中单位是模型的轴对齐边界方块的一半尺寸