BillboardGui 是用於在 3D 空間中顯示 UI 對象的容器,但總是面向相攝影機。容器的位置相對於父親 BasePart 或 Attachment (或 Adornee )。對於 BaseParts ,使用 Position 屬性,而對於 Attachments 則使用 WorldPosition 屬性。

廣告牌的 Size 屬性與 GuiObject.Size 有點不同。雖然 偏移 零件功能相同,但 比例 零件在 3D 空間中用作螺柱尺寸。
當創建尺寸縮放的 BillboardGui 包含 TextLabel 時,啟用標籤的 TextScaled 屬性將使其文字隨著相機距離變化而縮放。
請注意,如 和 內的互動用戶介面元素只會收到用戶輸入,如果它們屬於 ,通常是通過將 放置在 內來實現的。Adornee 屬性可以用來標靶 3D 世界中的零件或附件,而 BillboardGui 本身仍留在 PlayerGui 中。
請參閱體驗內的用戶介面以獲得與BillboardGui工作的指南。
緩存行為
為了幫助改善履約,BillboardGui 的外觀將被緩存,直到下列情況之一發生,然後在下一個渲染框中重新計算其外觀。
- 子孫被添加到或從 BillboardGui 中移除。
- 一個孫孫的 BillboardGui 變更的屬性。
- BillboardGui 本身的屬性發生變化。
概要
屬性
控制子孫是否會收到輸入事件。
設置 BillboardGui 位置相對於的目標零件或附件。
決定是否會將 BillboardGui 永遠渲染在其他 3D 物件之上。
決定容器 BillboardGui 的光在 LightInfluence 時縮放的因子,當 0 時縮放的因子。
是否繪製外部的 畫布邊界的一部分。
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
當遊戲控制器選擇移動到、離開或變更連接的 GuiBase2d 或任何子控制器 GuiObjects 時發生火災。
屬性
Active
控制子孫是否會收到輸入事件。如果 包含 ,那個按鈕只有在 設為 在 和 按鈕上才會變得可點擊。
請注意,如 和 內的互動用戶介面元素只會收到用戶輸入,如果它們屬於 ,通常是通過將 放置在 內來實現的。Adornee 屬性可以用來標靶 3D 世界中的零件或附件,而 BillboardGui 本身仍留在 PlayerGui 中。
AlwaysOnTop
此屬性決定是否 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 那些在畫布外完全 **** 的東西也不會成像。
DistanceLowerLimit
決定在距離單位上,BillboardGui將停止擴大與玩家當前攝影機相對的尺寸,默認值為0。如果 CurrentDistance 的 BillboardGui 值低於此值,它將不會超過此 DistanceLowerLimit 距離時的大小。
DistanceStep
決定在玩家的相機靠近或遠離 BillboardGui 時的增量和減量 CurrentDistance 單位。屬性默認為 0 並從 DistanceLowerLimit 開始回合。
DistanceUpperLimit
決定在距離單位上,BillboardGui將停止縮小與玩家當前攝影機相對的尺寸。如果 CurrentDistance 的 BillboardGui 超過此值,它將不會小於此 DistanceUpperLimit 距離時的尺寸。
如果值小於 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 顯示。Adornee可以用來將BillboardGui附加到BasePart或Attachment中的Workspace,而不是將它作為父級。
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空間中工作的偏移屬性。
StudsOffset
此屬性決定如何將 BillboardGui 從其 Adornee 在厘米中偏移,相對於 Camera 方向。
也可參見 StudsOffsetWorldSpace,其工作方式相似,但偏移方向與全球軸相對。
StudsOffsetWorldSpace
此屬性決定如何將 BillboardGui 從其 Adornee 在厘米上抵消,相對於全球軸。
也可參見 StudsOffset ,其工作方式相似,但偏移方向與 Camera 相對。