BillboardGui

Steuert, ob die Nachkommen Eingabe-Ereignisse erhalten. Wenn die UI ein GuiButton enthält, wird diese Schaltfläche nur für das Klicken aktiviert, wenn Active auf beide der BillboardGUI und der Schaltfläche eingestellt ist.

BillboardGuis wird nur Benutzereingaben erhalten, wenn sie mit dem PlayerGui verbunden sind. Die BillboardGui.Adornee -Eigenschaft kann verwendet werden, um ein Teil im Arbeitsbereich anzugreifen, während die Benutzeroberfläche selbst in der PlayerGui ist.

Setzt das Ziel oder die Anbautteil, auf die die BillboardGUI bezogen ist. Wenn kein Adornoee festlegenist, wird stattdessen die Parent verwendet.

Bestimmt, ob die BillboardGUI über dem 3D-Inhalt rendern wird oder von ihm abgesperrt wird.

Wenn auf false gesetzt, wird die BillboardGUI wie andere 3D-Inhalte gerendert und von anderen 3D-Objekten blockiert.

Wenn auf wahr gesetzt, wird immer auf dem 3D-Inhalt ausgegeben, und die Änderung des Aussehens beträgt:

• Farben entsprechen, wie sie in einem ScreenGui erscheinen.
• Der Text kann auf hochauflösenden Geräten schärfer erscheinen.
• BillboardGui.LightInfluence wird als ob es 0 wäre behandelt.
• BillboardGui.Brightness hat keinen Effekt.

Helligkeit bestimmt den Faktor, mit dem das abgestrahlte Licht der grafische Benutzeroberflächeskaliert wird. Standardmäßig ist diese Eigenschaft 1 und kann auf eine beliebige Zahl im Bereich [0, 1000] eingestellt werden.

Durch die Änderung dieser Eigenschaftenkann die offensichtliche Helligkeit eines GUI besser mit seinem Umgebung abgestimmt werden. Zum Instanzkann eine Videoanzeige wie die in Times Square heller sein, um sie am hellen Tag gut sichtbar zu machen.

Diese Eigenschaft wird in den folgenden Szenarien keinen Effekt produzieren, in denen die GUI kein Licht emittiert:

• Wenn AlwaysOnTop wahr ist, ist die Farbe jedes Pixels die Farbe, die auf dem Bildschirm angezeigt wird.
• Wenn LightInfluence 1 ist, alle Lichter aus der GUI werden vom Umgebung reflektiert, anstatt zu emittieren.

Wenn auf "Ja" gesetzt, werden Teile von GuiObjects, die außerhalb der Kante des BillboardsGUI fallen, nicht gezeichnet.

Selbst wenn diese Eigenschaft falsch ist, werden Objekte, die vollständig außerhalb des Kanvases der BillboardGUI sind, nicht rendern.

Die aktuelle Entfernung in Studs, von der die BillboardGui ist von der Kamera des Spieler:in. Ein verändertes Ereignis wird nicht für diese Eigenschaft ausgelöst, wenn der Gui- BillboardGui.DistanceStep nicht mehr als 0 ist.

Bestimmt die Entfernung in Studs, die ein BillboardGui größer skalieren wird, in relativer Ansicht zu der aktuellen Kamera des Spieler:in. Wenn die Entfernung des Guis unter diesem Wert ist, wird sie nicht größer skaliert, als sie bei dieser Entfernung sein sollte. Der Wert dieser Eigenschaft wird standardmäßig auf 0 Studs gesetzt.

Bestimmt die Größe BillboardGui.CurrentDistance Zuwachs und Abwachs in Studs, wenn die Kamera des Spieler:innäher und weiter von der BillboardGui bewegt sich. Die Eigenschaft wird standardmäßig auf 0 gesetzt und runden ab, beginnend von BillboardGui.DistanceLowerLimit .

Zum Beispiel, wenn diese Eigenschaft auf 0.5 eingestellt ist und die Kamera des Spieler:invon der GUI abbiegt, beginnt die aktuelle Entfernung 0 -> 0.5 -> 1 -> 1.5 -> ... und so weiter.

Bestimmt die Entfernung in Studs, die ein BillboardGui stoppt Skalierung kleiner in Größe in Bezug auf die aktuelle Kamera des Spieler:in. Wenn die Entfernung des Guis über diesem Wert ist, wird es nicht skaliert, kleiner als es in dieser Entfernung wäre.

Diese Eigenschaft wird ignoriert, wenn der Wert weniger als 0 ist. Der Standardwert ist -1, was bedeutet, dass die Eigenschaft standardmäßig ignoriert wird.

ExtentsOffset bestimmt, wie die BillboardGui von seinem Adornee abweicht, relativ zu der Orientierung und Einheiten sind die Hälfte der Dimensionen des Modells Camera -gebundenem Auswahlbox.

Siehe auch:

• ExtentsOffsetWorldSpace , was ähnlich funktioniert, mit der Ausnahme, dass die Offset-Orientalierung in Bezug auf die globalen Achsen relativ ist
• StudsOffset , was ähnlich funktioniert, außer die Einheiten sind Studs

ExtentsOffsetWorldSpace bestimmt, wie die BillboardGui von ihrem Adornee abgezogen ist, in Bezug auf die globalen Achsen und Einheiten sind die Dimensionen der Kante des Modells in der Größenordnung der Auswahlboxdes Modells halbiert.

Siehe auch:

• ExtentsOffset , was ähnlich funktioniert, mit der Ausnahme, dass die Offset-Orientalierung relativ zu der Camera ist
• StudsOffsetWorldSpace , was ähnlich funktioniert, mit der Ausnahme, dass die Einheiten Studs sind

Steuert, wie viel die BillboardGUI von der Beleuchtung im Umgebung beeinflusst wird.

Wenn auf 0 eingestellt, verhält sich die UI ähnlich wie ein LCD-Bildschirm, indem sie seine eigene Lichtquelle ist und unabhängig von der Umgebungslichtquelle dasselbe anzeigt.

Wenn auf 1 gesetzt, verhält sich die UI ähnlich wie ein Stück Papier, das nur das Licht einer anderen Ausgangstextwiderspiegelt.

Die MaxDistance-Eigenschaft eines BillboardGui setzt die Entfernung, in der die Werbetafel von der Kamera und immer noch gezeichnet werden kann, und zeigt, wie weit die Kamera und die Werbetafel von der Kamera entfernt sein kann, ohne dass die Werbetafel sichtbar ist, unabhängig von anderen Eigenschaften der Kamera oder GUI-Objekte, die sie enthält. Der Standardwert dieser Eigenschaft ist Infinity.

Wenn dieser Wert auf weniger als oder gleich null eingestellt ist, wird die maximale Entfernung als unendlich behandelt und die Werbetafel immer gezogen.

Beispiel

-- Warte, bis die Standardkamera/Steuerskripte geladen sind
task.wait(5)

-- Objekte erklären und initialisieren
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")

-- eingebeneinstellen
camera.CameraType = Enum.CameraType.Scriptable

-- Setzen Sie die Position der Teil und schließen Sie sie Ort
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true

-- Konfigurieren Sie die Werbetafel
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)

-- Etikett Beschriftung
label.Size = UDim2.fromScale(1, 1)

-- Eltern von Objekten festlegen
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace

-- Bewegen Sie die Kamera neben dem Teil. Warten Sie ein bisschen und dann bewegen Sie die Kamera
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)

-- Die Inhalte der Billboard werden hier sichtbar sein
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

Wird verwendet, um die BillboardGUI von einem bestimmten Spieler:inauszublenden.

Um die UI von mehr als einem Spieler:inauszublenden, platzieren Sie die BillboardGui in StarterGui und verwenden Sie ein Arbeitsbereich, um die BillboardGui.Enabled

Steuert die Größe, die die BillboardGUI auf dem Bildschirm haben wird.

Der Skalierungskomponente der Größe wird als Größe in Studs interpretiert, und die UI wird automatisch skaliert, wenn Skalierungswerte verwendet werden.

Die Skalierung und Offset-Portionen der Größe werden zusammengeführt und können gleichzeitig verwendet werden.

Ein 2D-Versatz in Größenangaben, der wie ein Ankerpunkt funktioniert. Dies kann wie die Class.GuiObject.AnchorPointEigenschaftenverwendet werden, aber die Werte sind anders.

Gewährte Werte

| SizeOffset | Erklärung | | : | | 0.0, 0.0 | Die Standardversion. Die UI wird an ihrem Zentrum angekernt. | | : | : | 0.5, 0.5 | Die UI wird an der linken unteren Ecke angekernt. | | : | : | : | 0.5, -

Siehe auch:

• StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtentsOffset0> , die alle anderen Offset-Eigenschaften sind, die in 3D-Raum arbeiten

StudsOffset ermittelt, wie die BillboardGui von ihrem Adornee abweicht, relativ zur Ausrichtung mit Einheiten in Studs.

Siehe auch:

• StudsOffsetWorldSpace , was ähnlich funktioniert, mit der Ausnahme, dass die Offset-Orientalierung in Bezug auf die globalen Achsen relativ ist
• ExtentsOffset , was ähnlich funktioniert, außer die Einheiten halbe der Dimensionen der ModellAuswahlboxsind

StudsOffsetWorldSpace bestimmt, wie die BillboardGui von ihrem Adornee abgezogen ist, in Bezug auf die globalen AXES mit Einheiten in Studs.

Siehe auch:

• StudsOffset , was ähnlich funktioniert, mit der Ausnahme, dass die Offset-Orientalierung relativ zu der Camera ist
• ExtentsOffsetWorldSpace , was ähnlich funktioniert, mit der Ausnahme, dass die Einheiten halb der Dimensionen der Auswahlboxsind