En esta página

Desaturate QML Type

Reduce la saturación de los colores. Más...

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

Item

Propiedades

Descripción detallada

Los valores de los píxeles desaturados se calculan como medias de los valores originales de los componentes RGB del elemento de origen.

FuenteEfecto aplicado

Escarabajo negro sobre una hoja

Escarabajo con colores desaturados

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
    }

    Desaturate {
        anchors.fill: bug
        source: bug
        desaturation: 0.8
    }
}

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 adicional de memoria para almacenar la salida del efecto.

Se recomienda desactivar la caché cuando las propiedades de la fuente o del efecto estén animadas.

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

desaturation : real

Esta propiedad define en qué medida se desaturan los colores de origen.

El valor oscila entre 0,0 (sin cambios) y 1,0 (desaturado). Por defecto, la propiedad está establecida en « 0.0 » (sin cambios).

Ejemplos de resultados con diferentes valores de desaturación

Beetle a todo color

Beetle parcialmente desaturado

Beetle totalmente desaturado a escala de grises

desaturación: 0,0 desaturación: 0,5 desaturación: 1,0

source : variant

Esta propiedad define el elemento de origen que proporciona los píxeles de origen al 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.