Colorize QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

• cached : bool
• hue : real
• lightness : real
• saturation : real
• source : variant

Descripción detallada

El efecto es similar a lo que ocurre cuando se pone un cristal coloreado encima de una imagen en escala de grises. Colorize utiliza el espacio de color tono, saturación y luminosidad (HSL). Puede especificar un valor deseado para cada propiedad. Puede desplazar todos los valores HSL con el efecto HueSaturation.

Alternativamente, puede utilizar el efecto ColorOverlay para colorear el elemento fuente en el espacio de color RGBA.

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 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 utiliza para colorear la fuente.

El valor oscila entre 0,0 y 1,0. Por defecto, la propiedad se establece en 0.0, que produce un color ligeramente rojo.

lightness : real

Esta propiedad define cuánto aumenta o disminuye el valor de luminosidad de la fuente.

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

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

saturation : real

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

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

source : variant

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