UIGradient
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
UIGradient applica un gradiente di colore e trasparenza agli elementi UI renduti dal padre GuiObject .L'aspetto del gradiente è configurabile attraverso il suo Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), e Rotation (number).
Un UIGradient non si applicherà al figlio o alla discendenza GuiObjects .Per applicare lo stesso gradiente a più oggetti, avrai bisogno di più istanze di gradiente.
Vedi anche Modificatori di apparenza per ulteriori informazioni su oggetti e come funzionano.
Oggetti supportati
Puoi applicare gradienti a Frame , TextLabel , TextButton , ImageLabel , ImageButton , e ViewportFrame .Tuttavia, ScrollingFrame e TextBox non sono attualmente supportati.
Considerazioni sulle prestazioni
Per utilizzare in modo efficiente un UIGradient, segui questi principi:
Evita di utilizzare più di 6 fermi di colore sulla sequenza Color.
Evita di utilizzare un UIGradient su qualsiasi oggetto che applichi un tratto di testo ( TextStrokeColor3 ), poiché il gradiente cercherà di mescolarsi con i tratti e i bordi e potrebbe causare problemi di prestazioni.
Evita di impostare Color e Transparency frequentemente: ciò causa la ricostruzione frequente della sequenza di colori, che è costosa.Se possibile, imposta queste proprietà solo una volta e prova ad animare le proprietà Offset o Rotation per ottenere un effetto simile.In alternativa, puoi cambiare il colore del genitore GuiObject utilizzando proprietà come BackgroundColor3 , ImageColor3 o TextColor3 .
Quando si applica un gradiente invariabile su un elemento UI il cui stato cambia molto, c'è un trade-off tra l'utilizzo di un UIGradient (tempo di elaborazione) e un'immagine di gradiente statico (memoria).
Sommario
Proprietà
Determina il colore mescolato con l'oggetto padre GuiObject lungo la lunghezza del gradiente.
Se il gradiente è abilitato o meno.
Determina la traduzione scalare del gradiente dal centro dell'oggetto padre GuiObject.
Determina la rotazione a senso orario in gradi del gradiente a partire da sinistra a destra.
Determina quanto il GuiObject padre può essere visto attraverso lungo la lunghezza del gradiente.
Metodi
Proprietà
Color
Questa proprietà descrive il colore da mescolare con l'elemento UI padre lungo il ColorSequence fornito.Questa proprietà funziona in modo simile a Beam.Color o Trail.Color , tranne che si applica su una distanza sullo schermo determinata dal Offset e Rotation .
Offset
Questa proprietà determina la traduzione scalare del gradiente dal centro del genitore GuiObject .Si tratta di una traduzione scalare, il che significa che l'offset reale dei pixel è determinato dal AbsoluteSize del padre GuiObject.Quindi, un valore di (1, 0) sposterebbe il gradiente orizzontalmente a destra di una distanza uguale alla dimensione sullo schermo dell'oggetto padre.A seconda del Rotation, questo può causare il fatto che il gradiente sia parzialmente visibile o non visibile tutti/tutte.
Vedi anche Rotation che influisce anche sulla geometria del gradiente applicato.
Rotation
Questa proprietà determina la rotazione a destra in gradi dell'UIGradient a partire da sinistra a destra.I punti di controllo iniziale e finale si agganciano ai bordi del genitore GuiObject, ma mantengono la rotazione fornita.
Vedi anche Offset che influisce anche sulla geometria del gradiente applicato.
Transparency
Questa proprietà descrive quanto sarà opaco l'elemento UI padre lungo il fornito NumberSequence .Questa proprietà funziona in modo simile a Beam.Transparency o Trail.Transparency , tranne che si applica su una distanza sullo schermo determinata da Offset e Rotation .
Si noti che i valori dell'invio della NumberSequenceKeypoints sono ignorati.