En esta página

Colorize QML Type

Establece el color en el espacio de color HSL. Más...

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

Item

Propiedades

Descripción detallada

Nota: El componente « MultiEffect » proporciona un efecto de coloración con algunas ventajas en cuanto al rendimiento. Para el código nuevo, debería considerarse como una alternativa al uso de Qt Graphical Effects.

El efecto es similar al que se produce cuando se superpone un cristal coloreado sobre una imagen en escala de grises. Colorize utiliza el espacio de color de tono, saturación y luminosidad (HSL). Se puede especificar el valor deseado para cada propiedad. Se pueden modificar todos los valores HSL con el efecto « HueSaturation ».

Como alternativa, puedes utilizar el efecto « ColorOverlay » para colorear el elemento de origen en el espacio de color RGBA.

FuenteEfecto aplicado

Escarabajo negro sobre una hoja

Escarabajo con efecto de coloración 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
    }

    Colorize {
        anchors.fill: bug
        source: bug
        hue: 0.0
        saturation: 0.5
        lightness: -0.2
    }
}

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 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 la fuente o del efecto estén animadas.

De forma predeterminada, la propiedad está establecida en « false ».

hue : real

Esta propiedad define el valor de matiz que se utiliza para dar color a la fuente.

El valor oscila entre 0,0 y 1,0. De forma predeterminada, la propiedad está establecida en 0.0, lo que produce un color ligeramente rojizo.

Valores de matiz permitidos

Espectro de colores que muestra valores de matiz de 0,0 a 1,0

Ejemplos de resultados con diferentes valores de matiz

Escarabajo coloreado con un tono de 0,2

Escarabajo coloreado con un tono de 0,5

Escarabajo coloreado con un tono de 0,8

tono: 0,2 tono: 0,5 tono: 0,8
saturation: 1saturation: 1saturation: 1
lightness: 0lightness: 0lightness: 0

lightness : real

Esta propiedad define en qué medida se incrementa o se reduce el valor de luminosidad de la fuente.

A diferencia de las propiedades de matiz y saturación, la luminosidad no establece el valor utilizado, sino que modifica el valor de luminosidad del píxel de origen existente.

El valor oscila entre -1,0 (disminución) y 1,0 (aumento). De forma predeterminada, la propiedad está establecida en « 0.0 » (sin cambios).

Ejemplos de resultados con diferentes valores de luminosidad

Beetle oscurecido, luminosidad -0,75

Beetle con luminosidad normal

Beetle aligerado, ligereza 0,75

luminosidad: -0,75 luminosidad: 0 luminancia: 0,75
hue: 0hue: 0hue: 0
saturation: 1saturation: 1saturation: 1

saturation : real

Esta propiedad define el valor de saturación que se utiliza para dar color a la fuente.

El valor oscila entre 0,0 (desaturado) y 1,0 (saturado). Por defecto, la propiedad está establecida en 1.0 (saturado).

Ejemplos de resultados con diferentes valores de saturación

Beetle desaturado, saturación 0

Beetle con saturación 0,5

Beetle completamente saturado

saturación: 0 saturación: 0,5 saturación: 1
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: Noestá permitido 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.