En esta página

ConicalGradient QML Type

Dibuja un degradado cónico. Más...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Propiedades

Descripción detallada

Un degradado se define mediante dos o más colores que se fusionan sin interrupciones. Los colores comienzan en el ángulo especificado y terminan en un valor angular mayor de 360 grados.

Efecto aplicado

Gradiente cónico con colores que giran alrededor del centro

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    ConicalGradient {
        anchors.fill: parent
        angle: 0.0
        gradient: Gradient {
            GradientStop { position: 0.0; color: "white" }
            GradientStop { position: 1.0; color: "black" }
        }
    }
}

Documentación de propiedades

angle : real

Esta propiedad define el ángulo inicial en el que se representa el color correspondiente a la posición 0,0 del degradado. Los colores correspondientes a valores de posición mayores se representan en valores de ángulo mayores y se mezclan de forma fluida. Los valores de ángulo aumentan en el sentido de las agujas del reloj.

Ejemplos de resultados con diferentes valores de ángulo

Gradiente cónico con un ángulo de 0

Gradiente cónico con un ángulo de 45

Gradiente cónico con un ángulo de 185

ángulo: 0 ángulo: 45 ángulo: 185
horizontalOffset: 0horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0verticalOffset: 0

cached : bool

Esta propiedad permite almacenar en caché los píxeles de salida del efecto con el fin de mejorar el rendimiento del renderizado.

Cada vez que se modifican las propiedades de la fuente o del efecto, es necesario actualizar los píxeles almacenados en la caché. El consumo de memoria aumenta, ya que se requiere un búfer de memoria adicional para almacenar la salida del efecto.

Se recomienda desactivar la caché cuando las propiedades de origen o del efecto estén animadas.

Por defecto, la propiedad está establecida en « false ».

gradient : Gradient

Un degradado se define mediante dos o más colores que se funden entre sí de forma homogénea. Los colores se especifican como un conjunto de elementos secundarios de tipo « GradientStop », cada uno de los cuales define una posición en el degradado (de 0,0 a 1,0) y un color. La posición de cada « GradientStop » viene definida por la propiedad «position». El color viene definido por la propiedad «color».

Ejemplos de resultado con diferentes valores de degradado

Degradado de arcoíris que gira alrededor del centro

Degradado gris que gira alrededor del centro

Degradado de transparente a negro

gradient:
Gradient {
  GradientStop {
     position: 0.000
     color: Qt.rgba(1, 0, 0, 1)
  }
  GradientStop {
     position: 0.167
     color: Qt.rgba(1, 1, 0, 1)
  }
  GradientStop {
     position: 0.333
     color: Qt.rgba(0, 1, 0, 1)
  }
  GradientStop {
     position: 0.500
     color: Qt.rgba(0, 1, 1, 1)
  }
  GradientStop {
     position: 0.667
     color: Qt.rgba(0, 0, 1, 1)
  }
  GradientStop {
     position: 0.833
     color: Qt.rgba(1, 0, 1, 1)
  }
  GradientStop {
     position: 1.000
     color: Qt.rgba(1, 0, 0, 1)
  }
}
gradiente:
Gradient {
  GradientStop {
     position: 0.0
     color: "#F0F0F0"
  }
  GradientStop {
     position: 0.5
     color: "#000000"
  }
  GradientStop {
     position: 1.0
     color: "#F0F0F0"
  }
}
gradiente:
Gradient {
  GradientStop {
     position: 0.0
     color: "#00000000"
  }
  GradientStop {
    position: 1.0
    color: "#FF000000"
  }
}
angle: 0angle: 0angle: 0
horizontalOffset: 0horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0verticalOffset: 0

horizontalOffset : real

Las propiedades `horizontalOffset` y ` verticalOffset ` definen el desplazamiento en píxeles del punto central del degradado con respecto al centro del elemento.

El valor oscila entre -inf e inf. De forma predeterminada, las propiedades están establecidas en 0.

Ejemplos de resultados con diferentes valores de «horizontalOffset»

Desplazamiento del centro del degradado hacia la izquierda

Centro del gradiente en el origen

Desplazamiento central del degradado hacia la derecha

horizontalOffset: -50 horizontalOffset: 0 horizontalOffset: 50
angle: 0angle: 0angle: 0
verticalOffset: 0verticalOffset: 0verticalOffset: 0

source : variant

Esta propiedad define el elemento que se va a rellenar con el degradado. El elemento de origen se representa en un búfer de píxeles intermedio y los valores alfa del resultado se utilizan para determinar la visibilidad de los píxeles del degradado en la pantalla. El valor por defecto de «source» es indefinido y, en ese caso, toda el área del efecto se rellena con el degradado.

Ejemplos de resultados con diferentes valores de «source»

Relleno con degradado en toda la superficie

Degradado enmascarado por una forma de mariposa

fuente: sin definir fuente:
angle: 0angle: 0
horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0

Nota: Nose admite que el efecto se incluya a sí mismo, por ejemplo, estableciendo como origen el elemento padre del efecto.

verticalOffset : real

Las propiedades « horizontalOffset » y «verticalOffset» definen el desplazamiento en píxeles del punto central del degradado con respecto al centro del elemento.

El valor oscila entre -inf e inf. Por defecto, las propiedades están establecidas en 0.

Ejemplos de resultados con diferentes valores de horizontalOffset

Desplazamiento central del degradado hacia la izquierda

Centro del gradiente en el origen

Desplazamiento del centro del degradado hacia la derecha

horizontalOffset: -50 horizontalOffset: 0 horizontalOffset: 50
angle: 0angle: 0angle: 0
desplazamiento vertical: 0desplazamiento vertical: 0desplazamiento vertical: 0

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.