UIGradient

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

UIGradient aplica un gradiente de color y transparencia a los elementos de la interfaz renderizados por el padre GuiObject.La apariencia del gradiente se puede configurar a través de su Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), y Rotation (number).

Un UIGradient no se aplicará al hijo o descendiente GuiObjects .Para aplicar el mismo gradiente a múltiples objetos, necesitarás múltiples instancias degradadas.

Vea también modificadores de apariencia para obtener más información sobre UIGradient objetos y cómo funcionan.

Objetos admitidos

Puedes aplicar gradientes a Frame , TextLabel , TextButton , ImageLabel , ImageButton , y ViewportFrame .Sin embargo, ScrollingFrame y TextBox no se admiten actualmente.

Consideraciones de rendimiento

Para usar de manera eficiente un UIGradient, sigue estos principios:

  • Evite usar más de 6 paradas de color en la secuencia Color.

  • Evite usar un UIGradient en cualquier objeto que aplique un trazado de texto ( TextStrokeColor3 ), ya que el gradiente intentará mezclarse con los trazados y las fronteras, y puede causar problemas de rendimiento.

  • Evite establecer Color y Transparency con frecuencia: esto hace que la secuencia de colores se reconstruya con frecuencia, lo que es costoso.Si es posible, establece estas propiedades solo una vez y trata de animar las propiedades Offset o Rotation para lograr un efecto similar.Alternativamente, puedes cambiar el color del padre GuiObject usando propiedades como BackgroundColor3 , ImageColor3 o TextColor3 .

  • Al aplicar un gradiente inmutable en un elemento de interfaz de usuario cuyo estado cambia mucho, hay un compromiso entre el uso de un UIGradient (tiempo de procesamiento) y una imagen de gradiente estática (memoria).

Resumen

Propiedades

  • Leer paralelo

    Determina el color mezclado con el GuiObject padre a lo largo de la longitud del gradiente.

  • Leer paralelo

    Si el gradiente está habilitado o no.

  • Leer paralelo

    Determina la traducción escalar del gradiente desde el centro del GuiObject padre.

  • Leer paralelo

    Determina la rotación en sentido horario en grados del gradiente que comienza de izquierda a derecha.

  • Determina cuánto puede verse el objeto padre GuiObject a lo largo de la longitud del gradiente.

Propiedades

Leer paralelo

Esta propiedad describe el color para mezclarse con el elemento de interfaz de usuario padre a lo largo del elemento proporcionado ColorSequence.Esta propiedad funciona de manera similar a Beam.Color o Trail.Color , excepto que se aplica sobre una distancia en la pantalla determinada por el Offset y Rotation .

Enabled

Leer paralelo

Si el gradiente está habilitado o no.

Offset

Leer paralelo

Esta propiedad determina la traducción escalar del gradiente desde el centro del padre GuiObject.Es una traducción escalar, lo que significa que el desplazamiento real del píxel se determina por el AbsoluteSize del padre GuiObject.Así, un valor de (1, 0) cambiaría el gradiente horizontalmente a la derecha por una distancia igual al tamaño en la pantalla del objeto padre.Dependiendo de la Rotation, esto puede causar que el gradiente sea parcialmente visible o no visible en todos/todas.

También vea Rotation que también afecta la geometría del gradiente aplicado.

Rotation

Leer paralelo

Esta propiedad determina la rotación en sentido horario en grados de la UIGradient que comienza de izquierda a derecha.Los puntos de control de comienzo y final se ajustan a los bordes del padre GuiObject, pero mantienen la rotación proporcionada.

También vea Offset que también afecta la geometría del gradiente aplicado.

Transparency

Leer paralelo

Esta propiedad describe qué tan opaca será el elemento de interfaz de usuario padre a lo largo del elemento proporcionado NumberSequence.Esta propiedad funciona de manera similar a Beam.Transparency o Trail.Transparency , excepto que se aplica sobre una distancia en la pantalla determinada por el Offset y el Rotation .

Tenga en cuenta que los valores de sobre de la etiqueta NumberSequenceKeypoints se ignoran.

Métodos

Eventos