Sur cette page

Blend QML Type

Fusionne deux éléments sources en utilisant un mode de fusion. Plus d'informations...

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

Item

Propriétés

Description détaillée

Le mode de mélange peut être sélectionné à l'aide de la propriété mode.

sourceforegroundSourceEffet appliqué

Note : Cet effet est disponible lors de l'exécution avec OpenGL.

Exemple

L'exemple suivant montre comment appliquer l'effet.

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"
    }
}

Propriété Documentation

cached : bool

Cette propriété permet de mettre en cache les pixels de sortie de l'effet afin d'améliorer les performances de rendu.

Chaque fois que les propriétés de la source ou de l'effet sont modifiées, les pixels du cache doivent être mis à jour. La consommation de mémoire augmente, car une mémoire tampon supplémentaire est nécessaire pour stocker la sortie de l'effet.

Il est recommandé de désactiver le cache lorsque les propriétés de la source ou de l'effet sont animées.

Par défaut, la propriété est définie sur false.

foregroundSource : variant

Cette propriété définit l'élément qui va être mélangé sur le site source.

Remarque : il n'est pas possible de laisser l'effet s'inclure lui-même, par exemple en définissant foregroundSource sur le parent de l'effet.

mode : string

Cette propriété définit le mode utilisé lorsque foregroundSource est mélangé à la source. Les valeurs sont insensibles à la casse.

modedescription
normalLes valeurs des composants des pixels de foregroundSource sont écrites sur la source à l'aide d'un mélange alpha.
additionLes valeurs des composantes des pixels de la source et de foregroundSource sont additionnées et écrites.
moyenneLa moyenne des valeurs des composants des pixels de la source et de foregroundSource est calculée et écrite.
couleurLa valeur de luminosité de la source est combinée avec la teinte et la saturation de foregroundSource et écrite.
colorBurnLes pixels les plus sombres de la source sont assombris davantage, si les pixels de la source et de foregroundSource sont clairs, le résultat est clair.
colorDodgeLes pixels plus clairs de la source sont plus éclaircis, si les pixels de la source et de foregroundSource sont foncés, le résultat est foncé.
darkenLa valeur de la composante du pixel le plus foncé de la source et de foregroundSource est écrite.
darkerColorLa valeur rgb du pixel de luminance inférieure de la source et de foregroundSource est écrite.
différenceLa différence absolue de valeur de composant de pixel entre la source et foregroundSource est écrite.
divideLes valeurs des composantes des pixels de la source sont divisées par la valeur de foregroundSource et écrites.
exclusionLa différence de valeur des composantes des pixels avec un contraste réduit entre la source et foregroundSource est écrite.
hardLightLes valeurs des composants des pixels de la source sont éclaircies ou assombries en fonction des valeurs de foregroundSource et écrites.
hueLa valeur de teinte de foregroundSource est combinée avec la saturation et la luminosité de la source et écrite.
éclaircirLa valeur de la composante de pixel la plus claire de la source et de foregroundSource est écrite.
lighterColorLa valeur rgb du pixel de plus haute luminance provenant de la source et de foregroundSource est écrite.
lightnessLa valeur de luminosité de foregroundSource est combinée avec la teinte et la saturation de la source et écrite.
multiplierLes valeurs des composantes des pixels provenant de la source et de foregroundSource sont multipliées et écrites.
négationLa différence absolue inversée de la valeur de la composante du pixel entre la source et foregroundSource est écrite.
saturationLa valeur de saturation de foregroundSource est combinée avec la teinte et la luminosité de la source et écrite.
écranLes valeurs des pixels de la source et de foregroundSource sont négatives, puis multipliées, à nouveau négatives et écrites.
soustraireLa valeur des pixels de foregroundSource est soustraite de la source et écrite.
softLightLes valeurs des composants des pixels de la source sont légèrement éclaircies ou assombries en fonction des valeurs de foregroundSource et écrites.
Exemple de sourceExemple foregroundSource

Exemples de sortie avec différentes valeurs de mode

mode : normal mode : addition mode : moyenne

mode : color mode : colorBurn mode : colorDodge

mode : darken mode : darkerColor mode : difference

mode : divide mode : exclusion mode : hardlight

mode : hue mode : lighten mode : lighterColor

mode : lightness mode : negation mode : multiply

mode : saturation mode : screen mode : subtract

mode : softLight

source : variant

Cette propriété définit l'élément source qui servira de base lorsque foregroundSource sera mélangé par-dessus.

Remarque : il n'est pas possible de laisser l'effet s'inclure lui-même, par exemple en définissant la source sur le parent de l'effet.

© 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.