En esta página

HueSaturation QML Type

Altera los colores del elemento fuente en el espacio de color HSL. Más...

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

Item

Propiedades

Descripción detallada

HueSaturation es similar al efecto Colorize, pero los valores de las propiedades de tono y saturación se manejan de forma diferente. El efecto HueSaturation siempre desplaza el tono, la saturación y la luminosidad del original, en lugar de fijarlos.

FuenteEfecto aplicado

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    HueSaturation {
        anchors.fill: bug
        source: bug
        hue: -0.3
        saturation: 0.5
        lightness: -0.1
    }
}

Documentación de propiedades

cached : bool

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

Cada vez que se cambian las propiedades de la fuente o del efecto, los píxeles de la caché deben actualizarse. El consumo de memoria se incrementa, ya que se requiere un buffer extra de memoria para almacenar la salida del efecto.

Se recomienda desactivar la caché cuando se animen la fuente o las propiedades del efecto.

Por defecto, la propiedad está establecida en false.

hue : real

Esta propiedad define el valor de matiz que se añade al valor de matiz fuente.

El valor oscila entre -1,0 (disminución) y 1,0 (aumento). Por defecto, la propiedad está establecida en 0.0 (sin cambios).

Ejemplos de salida con diferentes valores de matiz

matiz: -0.3 matiz: 0.0 matiz: 0.3
saturation: 0saturation: 0saturation: 0
lightness: 0lightness: 0lightness: 0

lightness : real

Esta propiedad define el valor de luminosidad que se añade al valor de saturación de la fuente.

El valor oscila entre -1,0 (disminución) y 1,0 (aumento). Por defecto, la propiedad está establecida en 0.0 (sin cambios).

Ejemplos de salida con diferentes valores de luminosidad

luminosidad: -0.5 luminosidad: 0.0 luminosidad: 0.5
hue: 0hue: 0hue: 0
saturation: 0saturation: 0saturation: 0

saturation : real

Esta propiedad define el valor de saturación que se añade al valor de saturación de origen.

El valor oscila entre -1,0 (disminución) y 1,0 (aumento). Por defecto, la propiedad está establecida en 0.0 (sin cambios).

Ejemplos de salida con diferentes valores de saturación

saturación: -0.8 saturación: 0.0 saturación: 1.0
hue: 0hue: 0hue: 0
lightness: 0lightness: 0lightness: 0

source : variant

Esta propiedad define el elemento fuente que proporciona los píxeles de origen para el efecto.

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

© 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.