QCanvasGradient Class
QCanvasGradient es la clase base de todos los pinceles de degradado de QCanvasPainter. Más información...
| Encabezado: | #include <QCanvasGradient> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CanvasPainter) target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter) |
| Desde: | Qt 6.11 |
| Heredado por: | QCanvasBoxGradient, QCanvasConicalGradient, QCanvasLinearGradient y QCanvasRadialGradient |
Funciones públicas
| QCanvasGradient() | |
(since 6.12) void | addColorStop(qreal position, QColor color) |
| QColor | endColor() const |
| void | setColorAt(qreal position, QColor color) |
| void | setEndColor(QColor color) |
(since 6.12) void | setImage(const QCanvasImage &image, int index = 0) |
| void | setStartColor(QColor color) |
| void | setStops(const QCanvasGradientStops &stops) |
| QColor | startColor() const |
| QCanvasGradientStops | stops() const |
| QCanvasBrush::BrushType | type() const |
| operator QCanvasBrush() const & | |
| operator QVariant() const |
Funciones protegidas
| QCanvasGradient(const QCanvasGradient &) | |
| QCanvasGradient(QCanvasGradient &&) | |
| ~QCanvasGradient() | |
| QCanvasGradient & | operator=(QCanvasGradient &&) |
| QCanvasGradient & | operator=(const QCanvasGradient &) |
Elementos no miembros relacionados
| QCanvasGradientStops | |
| bool | operator!=(const QCanvasGradient &lhs, const QCanvasGradient &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QCanvasGradient &gradient) |
| QDataStream & | operator<<(QDataStream &stream, const QCanvasGradientStop &stop) |
| bool | operator==(const QCanvasGradient &lhs, const QCanvasGradient &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QCanvasGradient &gradient) |
| QDataStream & | operator>>(QDataStream &stream, QCanvasGradientStop &stop) |
Descripción detallada
QCanvasGradient es la clase base para todos los pinceles de degradado de QCanvasPainter. Actualmente hay cuatro tipos de degradados: QCanvasLinearGradient, QCanvasRadialGradient, QCanvasConicalGradient y QCanvasBoxGradient.
Si no se especifican paradas con setStartColor, setEndColor, setColorAt o setStops, el degradado se representa como negro transparente (0,0,0,0). Si solo se especifica una parada, el degradado se rellena con ese color.
QCanvasPainter utiliza dos enfoques diferentes para dibujar degradados.
- Con un máximo de 2 paradas, los colores se pasan al shader como 2 uniformes de tipo vec4. Esto hace que la animación de degradados de 2 paradas sea muy eficiente, sin pasos adicionales intermedios.
- Con más de dos paradas, los colores se pasan al sombreador como una textura unidimensional. Por defecto, el tamaño de la textura es de 1x256 píxeles, optimizado para calidad y rendimiento. Las texturas se almacenan en caché, por lo que, cuando los puntos del degradado o los colores no cambian, se puede reutilizar la textura anterior incluso aunque cambien otras propiedades del degradado (como la posición, el ángulo, etc.). Aunque la animación de degradados con varios puntos es rápida, provocará cargas de texturas, así que valora si merece la pena.
Existen algunas variables de entorno para controlar el uso de texturas en los degradados:
- QCPAINTER_DISABLE_TEXTURE_USAGE_TRACKING: por defecto, se realiza un seguimiento del uso de las texturas de degradado y se mantiene por debajo del número máximo. Establece esta variable de entorno para desactivar el seguimiento y mantener todas las texturas de degradado en memoria.
- QCPAINTER_MAX_TEXTURES: por defecto, la cantidad máxima de texturas es
1024. Establece esta variable de entorno con el número máximo de texturas que desees. Las texturas de degradado temporales que no se estén utilizando en ese momento se eliminan automáticamente cuando se alcanza la cantidad máxima.Nota: Esto no tiene ningún efecto cuando se ha desactivado el seguimiento del uso de texturas.
Documentación de funciones de miembro
[delete] QCanvasGradient::QCanvasGradient()
Crea por defecto una instancia de ` QCanvasGradient`. Esta función se ha eliminado.
[constexpr noexcept protected default] QCanvasGradient::QCanvasGradient(const QCanvasGradient &)
Crea una instancia de ` QCanvasGradient` mediante copia.
[constexpr noexcept protected default] QCanvasGradient::QCanvasGradient(QCanvasGradient &&)
Crea una instancia de ` QCanvasGradient` mediante la construcción «move».
[constexpr noexcept protected default] QCanvasGradient::~QCanvasGradient()
Elimina la instancia de « QCanvasGradient ».
[since 6.12] void QCanvasGradient::addColorStop(qreal position, QColor color)
Crea un punto de parada en la posición position indicada con el valor color especificado. El valor position debe estar comprendido entre 0 y 1.
Este método se proporciona para garantizar la compatibilidad con el CanvasGradient de HTML. Es equivalente a setColorAt().
Esta función se introdujo en Qt 6.12.
Véase también setStops() y stops().
QColor QCanvasGradient::endColor() const
Devuelve el color final del degradado o el color correspondiente a la posición más alejada. Si no se ha definido ningún punto de parada, devuelve negro transparente (0, 0, 0, 0).
Véase también setEndColor().
void QCanvasGradient::setColorAt(qreal position, QColor color)
Crea un punto de parada en la posición position indicada con el valor color especificado. El valor position indicado debe estar comprendido entre 0 y 1.
Véanse también setStops() y stops().
void QCanvasGradient::setEndColor(QColor color)
Establece el color final del degradado en color. Esto equivale a llamar a setColorAt() con la posición 1.
Véase también endColor().
[since 6.12] void QCanvasGradient::setImage(const QCanvasImage &image, int index = 0)
Utiliza la función « image » como fuente del degradado en la coordenada y index. Se trata de una alternativa para definir las paradas del degradado utilizando, por ejemplo, setStops() o setColorAt(). El ancho predeterminado esperado de la imagen es de 256 píxeles, pero se puede ajustar definiendo QCPAINTER_GRADIENT_SIZE. El parámetro «index» es opcional y no es necesario cuando la altura de la imagen es de 1 píxel. El valor máximo de «index» debe ser la altura de la imagen menos 1.
Posibles razones para utilizar este método en lugar de establecer paradas:
- Es ligeramente más rápido de crear, ya que no es necesario analizar los puntos de parada. Además, se pueden incluir varios degradados en una sola imagen utilizando ` index`.
- La posibilidad de utilizar el degradado directamente desde el diseño o la imagen, en lugar de convertirlo en un conjunto de paradas.
- La posibilidad de tener degradados no lineales, como, por ejemplo, la curva gaussiana.
Nota: Si se han definido tanto los puntos de parada como la imagen, se utilizarán los puntos de parada.
A continuación se muestra un ejemplo sencillo de cómo utilizar una imagen con degradado de 256x1:
![]() | |
![]() | |
Esta función se introdujo en Qt 6.12.
Véase también setStops().
void QCanvasGradient::setStartColor(QColor color)
Establece el color inicial del degradado en color. Esto equivale a llamar a setColorAt() con la posición 0.
Véase también startColor().
void QCanvasGradient::setStops(const QCanvasGradientStops &stops)
Sustituye el conjunto actual de puntos de parada por el indicado en stops.
Las reglas para la lista de paradas son las siguientes:
- La lista debe contener al menos 2 paradas.
- Las posiciones de las paradas deben estar comprendidas entre 0 y 1, y deben ordenarse de menor a mayor.
- La primera posición debe estar en 0,0 y la última en 1,0.
Véanse también setColorAt() y stops().
QColor QCanvasGradient::startColor() const
Devuelve el color inicial del degradado o el color correspondiente a la posición más pequeña. Si no se ha definido ningún punto de parada, devuelve negro transparente (0, 0, 0, 0).
Véase también setStartColor().
QCanvasGradientStops QCanvasGradient::stops() const
Devuelve los puntos de parada de este gradiente.
Véase también setStops() y setColorAt().
QCanvasBrush::BrushType QCanvasGradient::type() const
Devuelve el tipo de degradado.
QCanvasGradient::operator QCanvasBrush() const &
Devuelve el degradado como un ` QCanvasBrush`.
Esta función sobrecarga QCanvasGradient::operator QCanvasBrush() &&.
QCanvasGradient::operator QVariant() const
Devuelve el gradiente como un objeto ` QVariant`.
[constexpr noexcept protected default] QCanvasGradient &QCanvasGradient::operator=(QCanvasGradient &&)
Asigna « other » a esta instancia de « QCanvasGradient ».
[constexpr noexcept protected default] QCanvasGradient &QCanvasGradient::operator=(const QCanvasGradient &)
Asigna por copia other a esta instancia de QCanvasGradient.
Elementos no miembros relacionados
QCanvasGradientStops
Definición de tipo para QList<QCanvasGradientStop>.
[noexcept] bool operator!=(const QCanvasGradient &lhs, const QCanvasGradient &rhs)
Devuelve ` true ` si el gradiente ` lhs ` es distinto de ` rhs`; en caso contrario, devuelve ` false `.
Véase también operator==().
QDataStream &operator<<(QDataStream &stream, const QCanvasGradient &gradient)
Escribe el objeto ` gradient ` especificado en el objeto ` stream ` especificado y devuelve una referencia al objeto ` stream`.
Véase también «Serialización detipos de datos de Qt».
QDataStream &operator<<(QDataStream &stream, const QCanvasGradientStop &stop)
Escribe el gradiente stop en el objeto stream especificado y devuelve una referencia al objeto stream.
Véase también «Serialización detipos de datos de Qt».
[noexcept] bool operator==(const QCanvasGradient &lhs, const QCanvasGradient &rhs)
Devuelve ` true ` si el gradiente ` lhs ` es igual a ` rhs`; en caso contrario, devuelve ` false `.
Véase también operator!=().
QDataStream &operator>>(QDataStream &stream, QCanvasGradient &gradient)
Lee el objeto ` gradient ` especificado a partir del objeto ` stream ` especificado y devuelve una referencia al objeto ` stream`.
Véase también «Serialización detipos de datos de Qt».
QDataStream &operator>>(QDataStream &stream, QCanvasGradientStop &stop)
Lee un degradado stop desde la dirección indicada stream y devuelve una referencia a stream.
Véase también «Serialización detipos de datos de Qt».
© 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.

