SurfaceGui
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
SurfaceGui ermöglicht das Rendern von UI-Objekten auf der Oberfläche eines Teils in der 3D-Welt, während gleichzeitig eine grundlegende Benutzerinteraktion auftretenkann.Ähnlich wie und , UI-Objekte wie und stehen in der gleichen Richtung wie die Oberfläche, die sie bearbeiten können, durch die Eigenschaften.
Beachten Sie, dass interaktive UI-Elemente wie ImageButtons und TextButtons innerhalb eines SurfaceGui nur dann Benutzeingaben erhalten, wenn sie dem PlayerGui zugewiesen sind, typischerweise durch Platzierung des SurfaceGui innerhalb von StarterGui (die Adornee Eigenschaft kann verwendet werden, um ein Teil in der 3D-Welt anzuzielen, während das SurfaceGui selbst im PlayerGui bleibt).Zusätzlich muss die Eigenschaft des Teils für das Interaktions-UI-Element sein, damit es Eingabe erhält.
Siehe In-Experience-Benutzeroberfläche für eine Anleitung zum Arbeiten mit SurfaceGui.
Cache-Verhalten
Um die Erfüllungzu verbessern, wird das Aussehen eines SurfaceGui 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 SurfaceGui entfernt.
- Eigenschaft eines Nachkommen der SurfaceGui.
- Eigenschaft des SurfaceGui selbst ändert sich.
Zusammenfassung
Eigenschaften
Bestimmt, ob die SurfaceGui immer über anderen 3D-Objekten gerendert wird.
Bestimmt den Faktor, mit dem das Licht des -Containers skaliert wird, wenn ist.
Die Größe eines "virtuellen Bildschirms" in "virtuellen Pixeln", die SurfaceGuis Pixel-zu-Pixel kompatibel mit ScreenGuis macht.
Ob Teile von GuiObjects, die außerhalb der SurfaceGui Leinwandgrenzen liegen, gezeichnet werden.
Steuert, wie stark die SurfaceGui von der Umgebungsbeleuchtung beeinflusst wird.
Steuert, wie weit der SurfaceGui entfernt angezeigt werden kann, bevor er aufhört zu rendern.
Bestimmt die Dichte der Pixel, die für jeden Weltraum-Punkt verwendet werden, um den Inhalt der SurfaceGui zu rendern.
Bestimmt, ob die SurfaceGui mit ihrer Größe in Studs an einer festen Größe oder Skalierung gerendert wird.
Legt die Entfernung fest, in der das linke Klicken beginnt, auf die SurfaceGui zu agieren, anstatt auf die gehaltene Tool.
Schichten dies SurfaceGui im Verhältnis zu anderen SurfaceGuis auf demselben Gesicht.
BasePart auf dem, auf dem die SurfaceGui angewendet werden soll, um die standard-elternvereinigung zu überschreiben.
Enum.NormalId gesicht, auf das die SurfaceGui anzuwenden ist.
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
AlwaysOnTop
Diese Eigenschaft bestimmt, ob die SurfaceGui immer über anderen 3D-Objekten gerendert wird.
Wenn auf false (Standard) eingestellt, wird der SurfaceGui wie andere 3D-Inhalte gerendert und durch andere 3D-Objekte ausgeblendet.Wenn auf true gesetzt, rendert die SurfaceGui 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 SurfaceGui 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.
CanvasSize
Die Größe eines "virtuellen Bildschirms" in "virtuellen Pixeln", die SurfaceGuis Pixel-zu-Pixel kompatibel mit ScreenGuis macht.
ClipsDescendants
Wenn auf true (Standard) eingestellt, werden Teile von GuiObjects, die außerhalb der SurfaceGui Canvas-Grenzen liegen, nicht gezeichnet.
Selbst wenn diese Eigenschaft false ist, GuiObjects werden diejenigen, die außerhalb der Leinwand sind, vollständig nicht rendern.
LightInfluence
Steuert, wie stark der SurfaceGui 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 SurfaceGui angezeigt wird, bevor es aufhört zu rendern.Ein Wert von 0 bedeutet, dass es keine Einschränkung gibt und es sich unendlich weit entfernt rendern wird.Der Standardwert von 1000 funktioniert für die meisten Fälle gut.
Für SurfaceGuis, 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.
PixelsPerStud
Diese Eigenschaft legt die Dichte der Pixel fest, die für jeden Weltraum-Punkt verwendet werden, um den Inhalt der SurfaceGui zu rendern.Höhere Werte werden dazu führen, dass die verschiedenen GuiObjects innerhalb kleiner erscheinen, wenn sie die gleiche Größe beibehalten.Umgekehrt werden niedrigere Werte verursachen, dass Objekte größer erscheinen.Wenn die jedoch durch die Verwendung von oder oder ähnlichem proportional skaliert werden, ermöglicht diese Eigenschaft eine höhere Definition zu verwenden.
Es ist wichtig, einen Wert auszuwählen, basierend darauf, wie weit entfernt du erwartest, dass ein Spieler die SurfaceGui sieht.Achten Sie auch darauf, dass eine große Pixeldichte die Leistung negativ beeinflussen kann, wenn das Gesicht des geschmückten Teils groß genug ist.
SizingMode
Wenn auf Enum.SurfaceGuiSizingMode.PixelsPerStud (Standard) eingestellt, rendert die SurfaceGui mit einer variablen Größe basierend auf PixelsPerStud und der Größe der Oberfläche in Studs.
Wenn auf Enum.SurfaceGuiSizingMode.FixedSize gesetzt, wird die SurfaceGui mit einer festen Größe durch CanvasSize dargestellt.
ToolPunchThroughDistance
Legt die Entfernung fest, in der das linke Klicken beginnt, auf die SurfaceGui zu agieren, anstatt auf die gehaltene Tool.Wenn ein Charakter innerhalb dieser Entfernung von der SurfaceGui ist, wird die Tool beim klickennicht aktiviert.
ZOffset
Legt dies SurfaceGui in Beziehung zu anderen auf demselben Gesicht (Ändern dieses hebt oder senkt nicht visuell eine SurfaceGui von der Oberfläche).