En esta página

Blend QML Type

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

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

Item

Propiedades

Descripción detallada

El modo de fusión se puede seleccionar mediante la propiedad « mode ».

fuenteforegroundSourceEfecto aplicado

Escarabajo negro sobre una hoja

Ilustración de una mariposa de colores

Una mezcla de escarabajo y mariposa

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 la propiedad

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 el resultado 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».

foregroundSource : variant

Esta propiedad define el elemento que se va a superponer sobre el « source ».

Nota: Nose admite que el efecto se incluya a sí mismo, por ejemplo, estableciendo `foregroundSource` en el elemento padre del efecto.

mode : string

Esta propiedad define el modo que se utiliza cuando se superpone « foregroundSource » sobre la imagen de origen. Los valores no distinguen entre mayúsculas y minúsculas.

mododescripción
normalLos valores de los componentes de píxel de « foregroundSource » se superponen sobre la imagen de origen mediante una mezcla alfa.
adiciónLos valores de los componentes de píxel de la fuente y de foregroundSource se suman y se escriben.
promedioSe calcula la media de los valores de los componentes de píxel de la imagen de origen y de « foregroundSource » y se escriben.
colorEl valor de luminosidad de la imagen de origen se combina con el tono y la saturación de « foregroundSource » y se escribe.
colorBurnLos píxeles más oscuros de la imagen de origen se oscurecen aún más; si tanto los píxeles de la imagen de origen como los de la imagen de destino ( foregroundSource ) son claros, el resultado es claro.
colorDodgeLos píxeles más claros de la imagen de origen se aclaran aún más; si tanto los píxeles de la imagen de origen como los de la imagen de destino ( foregroundSource ) son oscuros, el resultado es oscuro.
oscurecerSe aplica el valor del componente más oscuro tanto de la imagen de origen como de la de « foregroundSource ».
color más oscuroSe escribe el valor RGB del píxel con menor luminancia de la fuente y « foregroundSource ».
differenceSe escribe la diferencia absoluta en el valor de los componentes de los píxeles entre la fuente y « foregroundSource ».
divideSe dividen los valores de los componentes de píxel de la fuente por el valor de « foregroundSource » y se escriben.
exclusiónSe escribe la diferencia de valores de los componentes de píxel con contraste reducido entre la imagen de origen y la imagen de « foregroundSource ».
hardLightLos valores de los componentes de píxel de la imagen de origen se aclaran o oscurecen según los valores de « foregroundSource » y se guardan.
tonoEl valor de matiz de la « foregroundSource » se combina con la saturación y la luminosidad de la «source» y se escribe.
lightenSe escribe el valor de componente de píxel más claro de la fuente y de « foregroundSource ».
colorMásClaroSe escribe el valor RGB del píxel con mayor luminancia de la fuente y de foregroundSource.
claridadSe combina el valor de luminosidad de « foregroundSource » con el tono y la saturación de la fuente, y se escribe el resultado.
multiplySe multiplican entre sí los valores de los componentes de los píxeles de la fuente y de « foregroundSource » y se escriben.
negaciónSe escribe la diferencia invertida y absoluta entre los valores de los componentes de los píxeles de la fuente y de foregroundSource.
SaturaciónEl valor de saturación de « foregroundSource » se combina con el tono y la luminosidad de la fuente y se escribe.
pantallaLos valores de píxel de la fuente y del « foregroundSource » se invierten, se multiplican, se invierten de nuevo y se escriben.
restarEl valor del píxel de « foregroundSource » se resta del de la fuente y se escribe.
softLightLos valores de los componentes de los píxeles de «source» se aclaran o oscurecen ligeramente según los valores de « foregroundSource » y se escriben.
Ejemplo de «source»Ejemplo foregroundSource

Escarabajo negro sobre una hoja

Ilustración de una mariposa de colores

Ejemplos de salida con diferentes valores de modo

Efecto de fusión con modo normal

Efecto de fusión con el modo de adición

Efecto de fusión con el modo «promedio»

modo: normal modo: adición modo: promedio

Efecto de fusión con modo de color

Efecto «Blend» con el modo «ColorBurn»

Efecto de fusión con el modo «Aclarar»

modo: color modo: quemado de color modo: sobreexponer color

Efecto de fusión con el modo «Oscurecer»

Efecto de fusión con el modo «color más oscuro»

Efecto de fusión con modo «Diferencia»

modo: oscurecer modo: color más oscuro modo: diferencia

Efecto de fusión con modo «dividir»

Efecto de fusión con modo de exclusión

Efecto de fusión con el modo «Luz intensa»

modo: dividir modo: exclusión modo: luz intensa

Efecto de fusión con el modo «tono»

Efecto de fusión con el modo «Aclarar»

Efecto de fusión con el modo «color más claro»

modo: matiz modo: aclarar modo: color más claro

Efecto de fusión con el modo «Luminosidad»

Efecto de fusión con modo de negación

Efecto de fusión con el modo «Multiplicar»

modo: luminosidad modo: negación modo: multiplicar

Efecto de fusión con el modo de saturación

Efecto de fusión con modo de pantalla

Efecto de fusión con modo de sustracción

modo: saturación modo: pantalla modo: sustracción

Efecto de fusión con el modo «Luz suave»

modo: luz suave

source : variant

Esta propiedad define el elemento de origen que servirá de base cuando se aplique el efecto « foregroundSource » sobre él.

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.