Sur cette page

Blend QML Type

Fusionne deux éléments source à l'aide d'un mode de fusion. En savoir plus…

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

Item

Propriétés

Description détaillée

Le mode de fusion peut être sélectionné à l'aide de la propriété « mode ».

sourceforegroundSourceEffet appliqué

Coléoptère noir sur une feuille

Illustration colorée représentant un papillon

Un mélange de coléoptère et de papillon

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

Documentation sur les propriétés

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 un tampon de mémoire 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, cette propriété est définie sur « false ».

foregroundSource : variant

Cette propriété définit l'élément qui sera superposé à l'effet « source ».

Remarque : il n'est pas pris en charge de faire en sorte que l'effet s'inclue 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 l'effet « foregroundSource » est appliqué par fusion à l'image source. Les valeurs ne sont pas sensibles à la casse.

modedescription
normalLes valeurs des composantes de pixels de l'foregroundSource e sont superposées à la source à l'aide d'un mélange alpha.
additionLes valeurs des composantes de pixel de la source et de l'foregroundSource sont additionnées puis écrites.
moyenneLa moyenne des valeurs des composantes de pixel de la source et de l'foregroundSource est calculée, puis appliquée.
couleurLa valeur de luminosité de la source est combinée avec la teinte et la saturation de l'foregroundSource, puis enregistrée.
colorBurnLes pixels les plus sombres de la source sont encore assombris ; si les pixels de la source et de l'foregroundSource sont clairs, le résultat est clair.
colorDodgeLes pixels les plus clairs de la source sont encore plus éclaircis ; si les pixels de la source et ceux de l'foregroundSource sont tous deux sombres, le résultat est sombre.
darkenLa valeur de la composante la plus sombre parmi celles de la source et de l'foregroundSource est conservée.
darkerColorLa valeur RVB du pixel ayant la luminance la plus faible parmi ceux de la source et de l'foregroundSource est enregistrée.
différenceLa différence absolue entre les valeurs des composantes de pixel de la source et de l'foregroundSource est écrite.
divideLes valeurs des composantes des pixels de la source sont divisées par celles de l’ foregroundSource, puis enregistrées.
exclusionLa différence de valeur des composantes de pixel entre l'image source et l'foregroundSource, avec un contraste réduit, est enregistrée.
hardLightLes valeurs des composantes de pixel de la source sont éclaircies ou assombries en fonction des valeurs d’ foregroundSource, puis écrites.
hueLa valeur de teinte de l’ foregroundSource est combinée avec la saturation et la luminosité de la source, puis enregistrée.
lightenLa valeur de composante de pixel la plus claire parmi celles de la source et de l'foregroundSource est enregistrée.
couleurPlusClaireLa valeur RVB du pixel présentant la plus grande luminance parmi la source et l'foregroundSource est enregistrée.
luminositéLa valeur de luminosité de l'foregroundSource est combinée avec la teinte et la saturation de la source, puis enregistrée.
multiplyLes valeurs des composantes des pixels provenant de la source et de l'foregroundSource sont multipliées entre elles, puis enregistrées.
négationLa différence absolue inversée entre les valeurs des composantes de pixel de la source et de l'foregroundSource est enregistrée.
SaturationLa valeur de saturation de l’ foregroundSource est combinée avec la teinte et la luminosité de la source, puis enregistrée.
écranLes valeurs de pixels de la source et de l'foregroundSource sont inversées, puis multipliées, inversées à nouveau, et enregistrées.
soustractionLa valeur du pixel de la source « foregroundSource » est soustraite de celle de la source et le résultat est enregistré.
softLightLes valeurs des composantes des pixels de la source sont légèrement éclaircies ou assombries en fonction des valeurs de l'foregroundSource, puis enregistrées.
Exemple de sourceExemple foregroundSource

Coléoptère noir sur une feuille

Illustration colorée représentant un papillon

Exemples de résultats avec différentes valeurs de mode

Effet de fusion avec le mode « Normal »

Effet de fusion avec le mode « Ajout »

Effet de fusion avec le mode « moyenne »

mode : normal mode : addition mode : moyenne

Effet de fusion avec le mode de couleur

Effet de fusion avec le mode « ColorBurn »

Effet de fusion avec le mode « ColorDodge »

mode : couleur mode : colorBurn mode : éclaircissement des couleurs

Effet de fusion avec le mode « Assombrir »

Effet de fusion avec le mode « couleur plus foncée »

Effet de fusion avec le mode « Différence »

mode : assombrir mode : couleur plus sombre mode : différence

Effet de fusion avec le mode « Division »

Effet de fusion avec mode d'exclusion

Effet de fusion avec le mode « hardLight »

mode : division mode : exclusion mode : lumière intense

Effet de fusion avec le mode « teinte »

Effet de fusion avec le mode « Éclaircir »

Effet de fusion avec le mode « couleur plus claire »

mode : teinte mode : éclaircir mode : couleur plus claire

Effet de fusion avec le mode « Luminosité »

Effet de fusion avec le mode « négation »

Effet de fusion avec le mode « Multiplier »

mode : luminosité mode : négation mode : multiplication

Effet de fusion avec le mode « Saturation »

Effet de fusion avec le mode « écran »

Effet de fusion avec le mode « soustraction »

mode : saturation mode : écran mode : soustraction

Effet de fusion avec le mode « softLight »

mode : lumière douce

source : variant

Cette propriété définit l'élément source qui servira de base lors de l'application de l'effet « foregroundSource ».

Remarque : il n'est pas possible de faire en sorte que l'effet s'applique à lui-même, par exemple en définissant la source comme étant 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.