UIGradient
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
UIGradient wendet einen Farb- und Transparenzgradienten auf die UI-Elemente an, die vom Eltern GuiObject rendert werden.Das Aussehen des Gradienten ist konfigurierbar durch seine Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), und Rotation (number).
Ein UIGradient gilt nicht für Kind oder Nachkomme GuiObjects .Um derselben Gradienten auf mehrere Objekte anzuwenden, benötigen Sie mehrere Gradienteninstanzen.
Siehe auch Aussehensmodifizierer für weitere Informationen über UIGradient und wie sie funktionieren.
Unterstützte Objekte
Du kannst Gradienten auf Frame , TextLabel , TextButton , ImageLabel , ImageButton und ViewportFrame anwenden.Allerdings werden ScrollingFrame und TextBox derzeit nicht unterstützt.
Leistungsaspekte
Um eine UIGradient effizient zu nutzen, befolgen Sie diese Prinzipien:
Vermeiden Sie die Verwendung von mehr als 6 Farbstopps auf der Color Sequenz.
Vermeiden Sie die Verwendung eines UIGradient auf jedem Objekt, das einen Textstrich anwendet ( TextStrokeColor3 ), da der Gradient versuchen wird, sich mit Strichen und Grenzen zu vermischen und möglicherweise zu Performance-Problemen führen kann.
Vermeiden Sie die Festlegung von Color und Transparency häufig: Dies führt dazu, dass die Reihenfolge der Farben häufig wiedergebaut wird, was teuer ist.Wenn möglich, stellen Sie diese Eigenschaften nur einmal ein und versuchen Sie, die Offset oder Rotation Eigenschaften zu animieren, um einen ähnlichen Effekt zu erzielen.Alternativ kannst du die Farbe des Elternteils GuiObject ändern, indem du Eigenschaften wie BackgroundColor3 , ImageColor3 oder TextColor3 verwendest.
Wenn Sie einen unveränderlichen Gradienten auf ein UI-Element anwenden, dessen Zustand sich viel ändert, gibt es einen Kompromiss zwischen der Verwendung von UIGradient (Verarbeitungszeit) und einem statischen Gradientenbild (Speicher).
Zusammenfassung
Eigenschaften
Bestimmt die Farbe, die mit dem übergeordneten GuiObject entlang der Gradientenlänge gemischt wird.
Ob der Gradient aktiviert ist oder nicht.
Bestimmt die skalare Translation des Gradienten vom Zentrum des zugeordneten GuiObjekts.
Bestimmt die rechtschleifige Rotation in Grad des Gradients, beginnend von links nach rechts.
Bestimmt, wie viel das zugeordnete GuiObject entlang der Gradientenlänge gesehen werden kann.
Eigenschaften
Color
Diese Eigenschaft beschreibt die Farbe, die sich mit dem übergeordneten UI-Element entlang der angegebenen ColorSequence vermischen soll.Diese Eigenschaft funktioniert in ähnlicher Weise wie Beam.Color oder Trail.Color, mit Ausnahme, dass sie über eine auf dem Bildschirm festgelegte Entfernung angewendet wird, die von der Offset und Rotation bestimmt wird.
Offset
Diese Eigenschaft legt die skalare Übersetzung der Gradienten vom Zentrum des Eltern GuiObject fest.Es ist eine skalare Translation, was bedeutet, dass der tatsächliche Pixelfluss durch das AbsoluteSize des Eltern GuiObject bestimmt wird.Also, ein Wert von (1, 0) würde den Gradienten horizontal nach rechts verschieben, mit einer Entfernung, die der Bildschirmgröße des übergeordneten Objekts entspricht.Abhängig von der Rotation kann dies dazu führen, dass der Gradient teilweise sichtbar oder gar nicht sichtbar ist.
Siehe auch Rotation, was auch die Geometrie des angewendeten Gradienten beeinflusst.
Rotation
Diese Eigenschaft bestimmt die im Uhrzeigersinn Rotation in Grad der UIGradient.Die Anfangs- und Endkontrollpunkte schnappen sich an die Ränder des Eltern GuiObject , behalten aber die angegebene Rotation.
Siehe auch Offset, was auch die Geometrie des angewendeten Gradienten beeinflusst.
Transparency
Diese Eigenschaft beschreibt, wie undurchsichtig das zugeordnete UI-Element am angegebenen NumberSequence sein wird.Diese Eigenschaft funktioniert in ähnlicher Weise wie Beam.Transparency oder Trail.Transparency, mit Ausnahme, dass sie über eine auf dem Bildschirm festgelegte Entfernung angewendet wird, die von der Offset und Rotation bestimmt wird.
Beachten Sie, dass die Umschaltswerte der NumberSequenceKeypoints ignoriert werden.