BillboardGui
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
BillboardGui ist ein Container für UI-Objekte, die im 3D-Raum erscheinen, aber immer der Kamera gegenüberstehen.Die Position des Containers ist relativ zum Eltern BasePart oder Attachment (oder dem Adornee ).Für BaseParts wird die Eigenschaft Position verwendet, während für Attachments die Eigenschaft WorldPosition verwendet wird.

Die Eigenschaft eines Billboards Size funktioniert etwas anders als die von GuiObject.Size.Während die Versatz -Komponenten gleich funktionieren, werden die Skalierung -Komponenten als Stabgrößen im Platzverwendet.
Wenn du eine skalierte Größe BillboardGui erstellst, die ein TextLabel enthält, ist es nützlich, die Eigenschaft des BeschriftungTextScaled zu aktivieren, damit sein Text sich mit der Billboard-Leinwand skaliert, wenn sich die Kameraentfernung ändert.
Beachten Sie, dass interaktive UI-Elemente wie ImageButtons und TextButtons innerhalb eines BillboardGui nur dann Benutzeingaben erhalten, wenn sie dem PlayerGui zugewiesen sind, typischerweise durch Platzierung des BillboardGui innerhalb von StarterGui.Die Eigenschaft Adornee kann verwendet werden, um ein Teil oder eine Anlage in der 3D-Welt anzuzielen, während die BillboardGui selbst im PlayerGui bleibt.
Siehe In-Experience-Benutzeroberfläche für eine Anleitung zum Arbeiten mit BillboardGui.
Cache-Verhalten
Um die Erfüllungzu verbessern, wird das Aussehen eines BillboardGui bis zu dem Zeitpunkt zwischengespeichert, nachdem eines der folgenden Ereignisse auftritt, danach wird sein Aussehen auf dem nächsten Rendering-Frame neu berechnet.
- Ein Nachkomme wird hinzugefügt oder von der BillboardGui entfernt.
- Eigenschaft eines Nachkommen der BillboardGui.
- Eigenschaft des BillboardGui selbst ändert sich.
Zusammenfassung
Eigenschaften
Steuert, ob die Nachkommen Eingabeereignisse erhalten.
Legt das zugeordnete Teil oder die zugeordnete Anlage fest, auf die sich die BillboardGui bezieht.
Bestimmt, ob die BillboardGui immer über anderen 3D-Objekten gerendert wird.
Bestimmt den Faktor, mit dem das Licht des -Containers skaliert wird, wenn ist.
Ob Teile von GuiObjects, die außerhalb der BillboardGui Leinwandgrenzen liegen, gezeichnet werden.
Die aktuelle Entfernung in Studs, die der BillboardGui vom Kameras des Spieler:inentfernt ist.
Bestimmt die Entfernung in Klötzen, bei der der BillboardGui die Skalierung größerer Größe stoppt.
Bestimmt die Größe CurrentDistance Zunahmen und Abnahmen in Studs, wenn sich die Kamera des Spieler:innäher und weiter vom BillboardGui entfernt.
Bestimmt die Entfernung in Studs, bei der die BillboardGui die Größenreduzierung einstellt.
Bestimmt, wie die BillboardGui von seinem Adornee im Verhältnis zur Camera Ausrichtung verschoben wird, in Einheiten, die die Dimensionen der ModellAuswahlboxder Camera um die Hälfte reduzieren.
Bestimmt, wie die BillboardGui von seinem Adornee abweicht, in Bezug auf die globalen Achsen, in Einheiten, die die Dimensionen der ModellAuswahlboxum die Hälfte reduzieren.
Steuert, wie stark die BillboardGui von der Umgebungsbeleuchtung beeinflusst wird.
Steuert, wie weit der BillboardGui entfernt angezeigt werden kann, bevor er aufhört zu rendern.
Verwendet von Skripten, um die BillboardGui von einem bestimmten Spieler:inauszublenden.
Steuert die Größe, die die BillboardGui auf dem Bildschirm haben wird.
Ein 2D-Versatz in Größen-bezogenen Einheiten, der wie ein Ankerpunkt funktioniert.
Bestimmt, wie die BillboardGui von seinem Adornee in Studs verschoben wird, im Verhältnis zur Camera Orientierung.
Bestimmt, wie die BillboardGui von ihren Adornee in Studs abweicht, im Verhältnis zu den globalen Achsen.
Schaltet die Sichtbarkeit dieses LayerCollector um.
Bestimmt, ob die LayerCollector-Reset (sich selbst löscht und wieder klont in den Charakter des Spieler:inPlayerGui ) jedes Mal erfolgt, wenn der Charakter des Spieler:inrespawniert.
Steuert, wie GuiObject.ZIndex sich auf alle Nachkommen dieser LayerCollector verhält.
Beschreibt die tatsächliche Bildschirmposition eines GuiBase2d Elements, in Pixeln.
Beschreibt die tatsächliche Bildschirm rotation eines GuiBase2d Elements, in Grad.
Beschreibt die tatsächliche Bildschirmgröße eines GuiBase2d Elements, in Pixeln.
Wenn es auf true gesetzt wird, wird die Lokalisierung auf dieses GuiBase2d und seine Nachkommen angewendet.
Eine Referenz auf ein LocalizationTable , das verwendet werden soll, um automatisierte Lokalisierung auf dieses GuiBase2d und seine Nachkommen anzuwenden.
Passt das Spielpadauswahlverhalten in die Down-Richtung an.
Passt das Spielpadauswahlverhalten in die linke Richtung an.
Passt das Spielpadauswahlverhalten in die richtige Richtung an.
Passt das Spielpadauswahlverhalten in die Richtung oben an.
Ermöglicht die Anpassung der Gamepad-Auswahlbewegung.
Ereignisse
Ereignisse von GuiBase2d übernommen- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Feuert, wenn die Auswahl des Gamepads sich auf, verlässt oder ändert innerhalb der verbundenen GuiBase2d oder eines Nachkommens GuiObjects.
Eigenschaften
Active
Steuert, ob die Nachkommen Eingabeereignisse erhalten.Wenn das einen enthält, wird dieser Button nur dann klickbar werden, wenn auf sowohl dem und Knopf eingestellt ist.
Beachten Sie, dass interaktive UI-Elemente wie ImageButtons und TextButtons innerhalb eines BillboardGui nur dann Benutzeingaben erhalten, wenn sie dem PlayerGui zugewiesen sind, typischerweise durch Platzierung des BillboardGui innerhalb von StarterGui.Die Eigenschaft Adornee kann verwendet werden, um ein Teil oder eine Anlage in der 3D-Welt anzuzielen, während die BillboardGui selbst im PlayerGui bleibt.
Adornee
Legt das Ziel BasePart oder Attachment fest, zu dem die BillboardGui positioniert ist, und überschreitet das zugeordnete Teil oder Anhang.
AlwaysOnTop
Diese Eigenschaft bestimmt, ob die BillboardGui immer über anderen 3D-Objekten gerendert wird.
Wenn auf false (Standard) eingestellt, wird der BillboardGui wie andere 3D-Inhalte gerendert und durch andere 3D-Objekte ausgeblendet.Wenn auf true gesetzt, rendert die BillboardGui immer über 3D-Inhalten und die Darstellung ändert sich signifikant:
- Farben passen dazu, wie sie innerhalb eines ScreenGui erscheinen.
- Text kann auf hohen DPI-Geräten schärfer erscheinen.
- LightInfluence wird behandelt, als wäre es 0 .
- Brightness hat keine auswirkung.
Brightness
Diese Eigenschaft legt den Faktor fest, mit dem das Licht des Containers skaliert wird, wenn ist.Standardmäßig ist diese Eigenschaft 1 und kann auf eine beliebige Zahl zwischen 0 und 1000 festgelegt werden.Durch Änderung dieser Eigenschaftenkann die scheinbare Helligkeit eines BillboardGui besser auf seine Umgebung abgestimmt werden.Zum Instanzkann eine Videowerbetafel in einem dunklen Raum heller gemacht werden, indem Brightness auf 10 erhöht wird.
Beachten Sie, dass Brightness im Studio nicht zugänglich ist und keine Auswirkung hat, wenn entweder LightInfluence ist 1 oder AlwaysOnTop ist true.
ClipsDescendants
Wenn auf true (Standard) eingestellt, werden Teile von GuiObjects, die außerhalb der BillboardGui Canvas-Grenzen liegen, nicht gezeichnet.
Selbst wenn diese Eigenschaft false ist, GuiObjects werden diejenigen, die außerhalb der Leinwand sind, vollständig nicht rendern.
CurrentDistance
Die aktuelle Entfernung in Studs, die der BillboardGui vom Kameras des Spieler:inentfernt ist.Ein geändertes Ereignis feuert für diese Eigenschaft nicht, es sei denn DistanceStep ist mehr als 0.
DistanceLowerLimit
Bestimmt die Entfernung in Studs, bei der der BillboardGui die Skalierung größer in Bezug auf die aktuelle Kamera des Spieler:inaufhören wird, mit einem Standard von 0.Wenn das CurrentDistance des BillboardGui unter diesem Wert ist, wird es nicht größer skalieren als bei dieser DistanceLowerLimit Entfernung.
DistanceStep
Bestimmt die Größe CurrentDistance Zunahmen und Abnahmen in Studs, wenn sich die Kamera des Spieler:innäher und weiter vom BillboardGui entfernt.Die Eigenschaft wird auf 0 zurückgesetzt und rundet ab, beginnend mit DistanceLowerLimit.
DistanceUpperLimit
Bestimmt die Entfernung in Studs, bei der die BillboardGui die Skalierung kleiner in Bezug auf die aktuelle Kamera des Spieler:instoppt.Wenn das CurrentDistance des BillboardGui über diesem Wert liegt, wird es nicht kleiner skaliert als bei dieser Entfernung von DistanceUpperLimit.
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
Diese Eigenschaft legt fest, wie sich der BillboardGui vom Adornee seiner Camera -Ausrichtung, bezogen auf die Camera -Abgrenzung des Modells, in Einheiten mit der Hälfte der Abmessungen der gebündelten Auswahlboxdes Modells ausrichtet.
Siehe auch StudsOffset, das ähnlich funktioniert, aber Stud-Einheiten verwendet oder ExtentsOffsetWorldSpace, das ähnlich funktioniert, aber die Versatzausrichtung relativ zu den globalen Achsen ist.
ExtentsOffsetWorldSpace
Diese Eigenschaft legt fest, wie sich der vom globalen Achsstandard abhebt, in Bezug auf die globalen Achsen, in Einheiten, die die Dimensionen der Modell-ausgerichteten Auswahlboxum die Hälfte reduzieren.
Siehe auch StudsOffset, das ähnlich funktioniert, aber Studieneinheiten verwendet oder ExtentsOffset, das ähnlich funktioniert, aber die Versatzausrichtung relativ zum Camera ist.
LightInfluence
Steuert, wie stark der BillboardGui von der Umgebungsbeleuchtung beeinflusst wird, in einem Bereich von 0 bis 1 .Dies auf 1 zu setzen bedeutet, dass die umgebende Beleuchtung die volle Kontrolle über das Aussehen hat, während das Setzen auf 0 bedeutet, dass die Beleuchtung keine Auswirkung hat.
MaxDistance
Diese Eigenschaft steuert, wie weit von der Kamera der BillboardGui angezeigt wird, bevor es aufhört zu rendern.Ein Wert von 0 oder inf (Standard) bedeutet, dass es keine Einschränkung gibt und es unendlich weit entfernt gerendert wird.
Für BillboardGuis, die im Freien erscheinen, wird empfohlen, dass MaxDistance hoch genug ist, um sicherzustellen, dass die Benutzeroberfläche des Containers auf dem Bildschirm ausreichend klein ist, wenn sie erscheint oder verschwindet, wodurch der plötzliche Pop-in/out-Effekt minimiert wird.
PlayerToHideFrom
Verwendet von Skripten, um die BillboardGui von einem bestimmten Spieler:inauszublenden.
Um ein BillboardGui von mehr als einem Spieler:inauszublenden, platzieren Sie es in StarterGui und verwenden Sie ein Skript, um die Eigenschaft Enabled entsprechend der Tatsache einzustellen, ob der LocalPlayer es sehen sollte.Die Eigenschaft Adornee kann verwendet werden, um das BillboardGui an einen BasePart oder Attachment im Workspace anzufügen, anstatt es zu pflegen.
Size
Steuert die Größe, die die BillboardGui auf dem Bildschirm haben wird.Im Gegensatz zu GuiObject.Size stellen die Skalierung -Komponenten dieses Eigenschaftssets die Größe der Billboard in Platzein.
SizeOffset
Ein 2D-Versatz in Größen-bezogenen Einheiten, der wie ein Ankerpunkt funktioniert.Dies kann ähnlich wie die EigenschaftenGuiObject.AnchorPoint verwendet werden, aber die Werte sind unterschiedlich.
<tbody><tr><td><code>0, 0</code></td><td>Der Standard, bei dem die UI in ihrer Mitte verankert wird.</td></tr><tr><td><code>0.5, 0.5</code></td><td>Die UI wird unten links verankert.</td></tr><tr><td><code>0.5, -0.5</code></td><td>Die UI wird oben links angelegt.</td></tr><tr><td><code>-0.5, 0.5</code></td><td>Die UI wird oben rechts verankert.</td></tr><tr><td><code>-0.5, -0.5</code></td><td>Die UI wird unten rechts verankert.</td></tr></tbody>
Größenversatz | Erklärung |
---|
Siehe auch StudsOffset , StudsOffsetWorldSpace , ExtentsOffset und ExtentsOffsetWorldSpace , die Offset-Eigenschaften sind, die stattdessen im 3D-Raum arbeiten.
StudsOffset
Diese Eigenschaft legt fest, wie sich der BillboardGui von seinem Adornee in Studs, im Verhältnis zur Camera Orientierung, verschiebt.
Siehe auch StudsOffsetWorldSpace, das funktioniert ähnlich, außer die Versatzausrichtung ist relativ zu den globalen Achsen.
StudsOffsetWorldSpace
Diese Eigenschaft legt fest, wie sich der BillboardGui von seinen Adornee in Studs, im Verhältnis zu den globalen Achsen, verschiebt.
Siehe auch StudsOffset, das funktioniert ähnlich, außer die Versatzausrichtung ist relativ zum Camera.