BillboardGui

Veraltete anzeigen

*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.

BillboardGui with a TextLabel describing the screen console it floats above.

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.

Zusammenfassung

Eigenschaften

Eigenschaften von LayerCollector übernommenEigenschaften von GuiBase2d übernommen

Ereignisse

Ereignisse von GuiBase2d übernommen

Eigenschaften

Active

Parallel lesen

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

Parallel lesen

Legt das Ziel BasePart oder Attachment fest, zu dem die BillboardGui positioniert ist, und überschreitet das zugeordnete Teil oder Anhang.

AlwaysOnTop

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Schreibgeschützt
Nicht repliziert
Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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

Parallel lesen

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ößenversatzErklärung

Siehe auch StudsOffset , StudsOffsetWorldSpace , ExtentsOffset und ExtentsOffsetWorldSpace , die Offset-Eigenschaften sind, die stattdessen im 3D-Raum arbeiten.

StudsOffset

Parallel lesen

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

Parallel lesen

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.

Methoden

Ereignisse