En esta página

HueSaturation QML Type

Modifica los colores de los elementos de origen en el espacio de color HSL. Más información...

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

Item

Propiedades

Descripción detallada

El efecto «HueSaturation» es similar al efecto « Colorize », pero los valores de las propiedades de matiz y saturación se gestionan de forma diferente. El efecto «HueSaturation» siempre modifica el matiz, la saturación y la luminosidad del original, en lugar de establecerlos.

FuenteEfecto aplicado

Escarabajo negro sobre una hoja

Escarabajo con el tono y la saturación ajustados

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 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 de 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 se animen las propiedades de la fuente o del efecto.

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

hue : real

Esta propiedad define el valor de matiz que se suma al valor de matiz 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 resultados con diferentes valores de matiz

Escarabajo con el tono desplazado hacia la izquierda

Beetle en su color original

Escarabajo con el tono desplazado hacia la derecha

tono: -0,3 tono: 0,0 tono: 0,3
saturation: 0saturation: 0saturation: 0
lightness: 0lightness: 0lightness: 0

lightness : real

Esta propiedad define el valor de luminosidad que se suma 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 resultados con diferentes valores de luminosidad

Escarabajo oscurecido

Beetle con la ligereza original

Beetle aligerado

claridad: -0,5 claridad: 0,0 claridad: 0,5
hue: 0hue: 0hue: 0
saturation: 0saturation: 0saturation: 0

saturation : real

Esta propiedad define el valor de saturación que se suma 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 resultados con diferentes valores de saturación

El Beetle está prácticamente desaturado

Beetle con la saturación original

Beetle con mayor 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 de origen que proporciona los píxeles de origen para el efecto.

Nota: Nose admite que el efecto se incluya a sí mismo, por ejemplo, estableciendo como origen el elemento 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.