UIGradient
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
UIGradiente aplica um gradiente de cor e transparência aos elementos da interface renderizados pelo pai GuiObject.A aparência do gradiente é configurável através de seu Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), e Rotation (number).
Um UIGradient não se aplicará ao filho ou descendente GuiObjects .Para aplicar o mesmo gradiente a vários objetos, você precisará de várias instâncias de gradiente.
Veja também Modificadores de Aparência para mais informações sobre UIGradient e como eles funcionam.
Objetos Suportados
Você pode aplicar gradientes a Frame , TextLabel , TextButton , ImageLabel , ImageButton e ViewportFrame .No entanto, ScrollingFrame e TextBox não são atualmente suportados.
Considerações de Desempenho
Para usar eficientemente um UIGradient, siga esses princípios:
Evite usar mais de 6 paradas de cores na sequência Color.
Evite usar um UIGradient em qualquer objeto que aplique um traço de texto ( TextStrokeColor3 ), pois o gradiente tentará se misturar com traços e bordas e pode causar problemas de desempenho.
Evite definir Color e Transparency com frequência: isso faz com que a sequência de cores seja reconstruída frequentemente, o que é caro.Se possível, defina essas propriedades apenas uma vez e tente animar as propriedades Offset ou Rotation para obter um efeito semelhante.Alternativamente, você pode alterar a cor do pai GuiObject usando propriedades como BackgroundColor3 , ImageColor3 ou TextColor3 .
Ao aplicar um gradiente inalterável em um elemento de UI cujo estado muda muito, há um tradeoff entre usar um UIGradient (tempo de processamento) e uma imagem de gradiente estática (memória).
Resumo
Propriedades
Determina a cor misturada com o GuiObject pai ao longo da comprimento do gradiente.
Se o gradiente está ativado ou não.
Determina a tradução escalar do gradiente a partir do centro do GuiObject pai.
Determina a rotação em sentido horário em graus do gradiente começando de esquerda para direita.
Determina quanto o objeto pai GuiObject pode ser visto ao longo da duração do gradiente.
Propriedades
Color
Essa propriedade descreve a cor para se misturar com o elemento de UI pai ao longo do fornecido ColorSequence .Essa propriedade funciona de maneira semelhante a Beam.Color ou Trail.Color, exceto que se aplica sobre uma distância na tela determinada pelo Offset e Rotation.
Offset
Essa propriedade determina a tradução escalar do gradiente a partir do centro do pai GuiObject.É uma tradução escalar, o que significa que o deslocamento real do pixel é determinado pelo AbsoluteSize do pai GuiObject.Então, um valor de (1, 0) mudaria o gradiente horizontalmente para a direita por uma distância igual ao tamanho na tela do Objetopai.Dependendo do Rotation, isso pode fazer com que o gradiente seja parcialmente visível ou não visível de todas / todos.
Veja também Rotation que também afeta a geometria do gradiente aplicado.
Rotation
Essa propriedade determina a rotação sentido horário em graus do UIGradient.Os pontos de controle de início e fim saltam para os cantos do pai GuiObject, mas mantêm a rotação fornecida.
Veja também Offset que também afeta a geometria do gradiente aplicado.
Transparency
Essa propriedade descreve quão opaca o elemento de UI pai será ao longo do fornecido NumberSequence .Essa propriedade funciona de maneira semelhante a Beam.Transparency ou Trail.Transparency, exceto que se aplica sobre uma distância na tela determinada pelo Offset e Rotation.
Observe que os valores do envelope do NumberSequenceKeypoints são ignorados.