BillboardGui

顯示已棄用項目

*此內容是使用 AI(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

平行讀取

此屬性決定是否 BillboardGui 將永遠渲染在其他 3D 物件之上。

當設為 false (預設值) 時,BillboardGui 會像其他 3D 內容一樣渲染,並被其他 3D 對象遮蓋。當設為 true 時,BillboardGui 總是在 3D 內容上渲染,外觀變化非常顯著:

Brightness

平行讀取

此屬性決定了當 容器的光被縮放時, 容器的亮度會被縮放的因子。預設值為 1 ,可設為 01000 之間的任何數字。修改此屬性可以使 BillboardGui 的顯示亮度更匹配環境。例個體、實例,一個視頻廣告牌可以在黑暗房間內亮起,通過增加 Brightness10 來提高亮度。

請注意, 在 Studio 無法使用,且當 或 是 時沒有效果。

ClipsDescendants

平行讀取

當設為 true (預設值) 時,會繪製外部的 GuiObjects 畫布邊界之外的 BillboardGui 部分。

即使當此屬性是 falseGuiObjects 那些在畫布外完全 **** 的東西也不會成像。

CurrentDistance

唯讀
未複製
平行讀取

BillboardGui 從玩家的相攝影機到目前距離以磚格為單位的距離。變更的事件除非 DistanceStep 大於 0 否則不會對此屬性發射。

DistanceLowerLimit

平行讀取

決定在距離單位上,BillboardGui將停止擴大與玩家當前攝影機相對的尺寸,默認值為0。如果 CurrentDistanceBillboardGui 值低於此值,它將不會超過此 DistanceLowerLimit 距離時的大小。

DistanceStep

平行讀取

決定在玩家的相機靠近或遠離 BillboardGui 時的增量和減量 CurrentDistance 單位。屬性默認為 0 並從 DistanceLowerLimit 開始回合。

DistanceUpperLimit

平行讀取

決定在距離單位上,BillboardGui將停止縮小與玩家當前攝影機相對的尺寸。如果 CurrentDistanceBillboardGui 超過此值,它將不會小於此 DistanceUpperLimit 距離時的尺寸。

如果值小於 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 顯示。Adornee可以用來將BillboardGui附加到BasePartAttachment中的Workspace,而不是將它作為父級。

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>
尺寸偏移說明

請參閱StudsOffsetStudsOffsetWorldSpaceExtentsOffsetExtentsOffsetWorldSpace,這些是在3D空間中工作的偏移屬性。

StudsOffset

平行讀取

此屬性決定如何將 BillboardGui 從其 Adornee 在厘米中偏移,相對於 Camera 方向。

也可參見 StudsOffsetWorldSpace,其工作方式相似,但偏移方向與全球軸相對。

StudsOffsetWorldSpace

平行讀取

此屬性決定如何將 BillboardGui 從其 Adornee 在厘米上抵消,相對於全球軸。

也可參見 StudsOffset ,其工作方式相似,但偏移方向與 Camera 相對。

方法

活動