Blend QML Type

Fusiona dos elementos de origen utilizando un modo de fusión. Más...

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

Lista de todos los miembros, incluidos los heredados

Propiedades

cached : bool
foregroundSource : variant
mode : string
source : variant

Descripción detallada

El modo de mezcla se puede seleccionar con la propiedad mode.

fuente	foregroundSource	Efecto aplicado

Nota: Este efecto está disponible cuando se ejecuta con OpenGL.

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
    }

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

    Blend {
        anchors.fill: bug
        source: bug
        foregroundSource: butterfly
        mode: "subtract"
    }
}

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á en false.

foregroundSource : variant

Esta propiedad define el elemento que se va a mezclar sobre source.

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

mode : string

Esta propiedad define el modo que se utiliza cuando foregroundSource se mezcla sobre la fuente. Los valores no distinguen mayúsculas de minúsculas.

modo	descripción
normal	Los valores de los componentes de píxel de foregroundSource se escriben sobre la fuente utilizando mezcla alfa.
suma	Los valores de los componentes de píxel de la fuente y foregroundSource se suman y se escriben.
promedio	Los valores de los componentes de píxel de la fuente y foregroundSource se promedian y se escriben.
color	El valor de luminosidad de la fuente se combina con el tono y la saturación de foregroundSource y se escribe.
colorQuemar	Los píxeles más oscuros de la fuente se oscurecen más, si tanto los píxeles de la fuente como los de foregroundSource son claros, el resultado es claro.
colorDodge	Los píxeles más claros de la fuente se aclaran más, si tanto la fuente como foregroundSource píxeles son oscuros el resultado es oscuro.
oscurecer	Se escribe el valor del componente de píxel más oscuro de la fuente y foregroundSource.
darkerColor	Se escribe el valor rgb del píxel de menor luminancia de la fuente y foregroundSource.
diferencia	Se escribe la diferencia absoluta del valor del componente de píxel entre la fuente y foregroundSource.
dividir	Los valores de componente de píxel de la fuente se dividen por el valor de foregroundSource y se escriben.
exclusión	Se escribe la diferencia de valor de componente de píxel con contraste reducido entre la fuente y foregroundSource.
hardLight	Los valores de los componentes de píxel de la fuente se aclaran u oscurecen de acuerdo con los valores de foregroundSource y se escriben.
matiz	El valor de matiz de foregroundSource se combina con la saturación y la luminosidad de la fuente y se escribe.
aclarar	Se escribe el valor de componente de píxel más claro de la fuente y de foregroundSource.
lighterColor	Se escribe el valor rgb del píxel con mayor luminancia de la fuente y de foregroundSource.
luminosidad	El valor de luminosidad de foregroundSource se combina con el tono y la saturación de la fuente y se escribe.
multiplicar	Los valores de los componentes de píxel de la fuente y foregroundSource se multiplican y se escriben.
negación	Se escribe la diferencia absoluta invertida del valor del componente del píxel entre la fuente y foregroundSource.
saturación	El valor de saturación de foregroundSource se combina con el tono y la luminosidad de la fuente y se escribe.
pantalla	Los valores de píxel de la fuente y foregroundSource se niegan, luego se multiplican, se niegan de nuevo y se escriben.
restar	El valor de píxel de foregroundSource se resta de la fuente y se escribe.
softLight	Los valores de los componentes de píxel de la fuente se aclaran u oscurecen ligeramente de acuerdo con los valores de foregroundSource y se escriben.

Ejemplo de fuente	Ejemplo foregroundSource

Ejemplos de salida con diferentes valores de modo

modo: normal	modo: suma	modo: promedio

modo: color	modo: colorBurn	modo: colorDodge

modo: oscurecer	modo: darkerColor	modo: diferencia

modo: dividir	modo: exclusión	modo: hardlight

modo: tono	modo: aclarar	modo: lighterColor

modo: luminosidad	modo: negación	modo: multiplicar

modo: saturación	modo: pantalla	modo: restar

modo: softLight

source : variant

Esta propiedad define el elemento fuente que va a ser la base cuando foregroundSource se mezcle sobre él.

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.