UIGradient
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
UIGradient applique un gradient de couleur et de transparence aux éléments de l'interface rendus par le parent GuiObject.L'apparence du gradient est configurable via son Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), et Rotation (number).
Un UIGradient ne s'appliquera pas aux enfants ou aux descendants GuiObjects .Pour appliquer le même gradient à plusieurs objets, vous aurez besoin de plusieurs instances de gradient.
Voir aussi modifieurs d'apparence pour plus d'informations sur UIGradient les objets et comment ils fonctionnent.
Objets soutenus
Vous pouvez appliquer desgradients à Frame , TextLabel , TextButton , ImageLabel , ImageButton , et ViewportFrame .Cependant, ScrollingFrame et TextBox ne sont pas actuellement pris en charge.
Considérations de performance
Afin d'utiliser efficacement un UIGradient, suivez ces principes :
Évitez d'utiliser plus de 6 arrêts de couleur sur la séquence Color.
Évitez d'utiliser un UIGradient sur tout objet qui applique un trait de texte ( TextStrokeColor3 ), car le gradient essaiera de se fondre avec les traits et les bords, et peut causer des problèmes de performance.
Évitez de définir Color et Transparency souvent : cela provoque souvent la réconstruction de la séquence de couleurs, ce qui est coûteux.Si possible, définissez ces propriétés une seule fois et essayez d'animer les propriétés Offset ou Rotation pour obtenir un effet similaire.Alternativement, vous pouvez modifier la couleur du parent GuiObject en utilisant des propriétés telles que BackgroundColor3 , ImageColor3 ou TextColor3 .
Lors de l'application d'un gradient non modifiable sur un élément d'interface utilisateur dont l'état change beaucoup, il y a un compromis entre l'utilisation d'un UIGradient (temps de traitement) et une image de gradient statique (mémoire).
Résumé
Propriétés
Détermine la couleur mélangée avec l'objet parent GuiObject le long de la longueur du gradient.
Que le gradient soit activé ou non.
Détermine la traduction polynomiale du gradient à partir du centre du GuiObject parent.
Détermine la rotation horaire en degrés du gradient commençant par la gauche à la droite.
Détermine à quel point l'objet parent GuiObject peut être vu le long de la longueur du gradient.
Propriétés
Color
Cette propriété décrit la couleur à mélanger avec l'élément parent de l'interface utilisateur fourni ColorSequence .Cette propriété fonctionne de manière similaire à Beam.Color ou Trail.Color , sauf qu'elle s'applique sur une distance sur l'écran déterminée par le Offset et le Rotation .
Offset
Cette propriété détermine la traduction polynomiale du gradient du centre du parent GuiObject.C'est une traduction polynomiale, ce qui signifie que le décalage réel des pixels est déterminé par le AbsoluteSize du parent GuiObject.Ainsi, une valeur de (1, 0) déplacerait le gradient horizontalement à droite d'une distance égale à la taille à l'écran de l'objet parent.En fonction du Rotation, cela peut provoquer le fait que la gradation soit partiellement visible ou non visible du tout.
Voir aussi Rotation qui affecte également la géométrie du gradient appliqué.
Rotation
Cette propriété détermine la rotation horaire en degrés de la UIGradient à partir de gauche à droite.Les points de contrôle début et fin s'accrochent aux bords du parent GuiObject, mais maintiennent la rotation fournie.
Voir aussi Offset qui affecte également la géométrie du gradient appliqué.
Transparency
Cette propriété décrit à quel point l'élément parent de l'interface utilisateur sera opaque le long du NumberSequence fourni.Cette propriété fonctionne de manière similaire à Beam.Transparency ou Trail.Transparency , sauf qu'elle s'applique sur une distance sur l'écran déterminée par le Offset et le Rotation .
Notez que les valeurs d'enveloppe de la NumberSequenceKeypoints sont ignorées.