BillboardGui

控制子孫是否接收輸入事件。如果介面包含一個 GuiButton 按鈕，那個按鈕只會在兩個 BillboardGui 和按鈕上設為啟用，如果啟用設為 true 的話。

BillboardGuis 只會接受玩家輸入，如果它們與 PlayerGui 相關。BillboardGui.Adornee 屬性可以用來在工作區中瞄準零件，而玩家自己在 PlayerGui 中。

設定廣告牌GUI 的位置相對於的目標零件或附件。如果沒有 Adornee 設置，則 Parent 會被使用。

決定是否要在 3D 內容上方顯示廣告導覽器，或是否被它遮蔽。

設為 false 時，BillboardGui 會像其他 3D 內容一樣渲染，並且會被其他 3D 對象遮蔽。

設為真的時候，它總是在 3D 內容上重新渲染，並且外觀變更大幅：

• 顏色與 ScreenGui 中的顏色相匹配。
• 文字可能會在高 DPI 設備上顯示更銳利。
• BillboardGui.LightInfluence 被扱為 0 的屬性。
• BillboardGui.Brightness 沒有效果。

光澤 決定GUI的發射光的比例。 預設值為 1 ，可以設置為範圍內的任何數字。

通過修改此屬性，可以更好地與環境相匹配。 例個體、實例，如果在 Times Square 找到的視頻廣告牌亮度足夠，它就可以在明亮的一天變得更明亮。

這個屬性在下列情況下不會發生任何效果：

• 當 AlwaysOnTop 是真的時，每個畫素的顏色都會顯示在畫面上。
• Class.BillboardGui.LightInfluence|LightInfluence 是 1 時，所有從 GUI 發射的光都會反射從環境反射到環境而不會發射。

設定為 "真" 時，在BillboardGui 的畫布邊緣之外的 GuiObjects 將不會顯示。

即使這個屬性是 false ，但在BillboardGui 的 canvas 外的物件將不會成像。

Class.BillboardGui 的當前距離是從玩家的相攝影機發射的。變更的事件不會在此屬性發生，除非 BillboardGui.DistanceStep 的 gui 是更大的 0 以上。

Class.BillboardGui 將在對玩家的目前攝影機相對於其大小進行縮放時停止縮放。如果 gui 的距離小於此值，它將不會縮放大於此值。此屬性的預設值為 0 格子。

決定鏡頭移動到 BillboardGui.CurrentDistance 的距離增加和減少的尺寸。 此屬性預設為 0 並且從 BillboardGui 開始圓滿。 該屬性的預設值為 0 。 從 BillboardGui.DistanceLowerLimit 開始圓滿。

舉例來說，如果此屬性設為 0.5，玩家的相機從零開始移動，那麼當前距離會增加 0 -> 0.5 -> 1 -> 1.5 -> ... 等等。

Class.BillboardGui 將縮放尺寸與玩家目前的攝影機相對而言變小。如果距離 Class.BillboardGui 超過此值，它將不會縮放到此距離。

此屬性在值為零以下時會被忽略。預設值為 -1，表示此屬性以預設方式被忽略。

ExtentsOffset 決定BillboardGui 的BillboardGui.Adornee|Adornee 對Adornee 的方向和單位相對於模型的Camera - 對準框的尺寸是模型的0> Class.Camera0> 中的一方塊。

也看：

• ExtentsOffsetWorldSpace，其中偏移方向與全球軸相對
• StudsOffset，其中單位是 studs

ExtentsOffsetWorldSpace 決定BillboardGui 的 Offset 從其 Adornee 對全球軸和單位的尺寸是半個尺寸模型的軸對邊方塊。

也看：

• ExtentsOffset，其中偏移方向與 Camera 無關
• StudsOffsetWorldSpace，其中單位是 studs

控制 BillboardGui 是否受到環境中的照明影響。

當設為 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

-- 設定零件的位置並鎖空間
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 中，並使用指定的 Class.BillboardGui

控制 BillboardGui 在屏幕上的大小。

大小的比例項目以格子的大小解釋為格子的大小，並且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 bounding box的半尺寸

StudsOffsetWorldSpace 決定 BillboardGui 的 Offset 從其 Adornee 對全球軸的相對位置。

也看：

• StudsOffset，其中偏移方向與 Camera 無關
• ExtentsOffsetWorldSpace，其中單位的大小與模型的軸對邊界方塊的大小相同， except 單位的大小與模型的軸對邊界框的大小相同