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: |
Propriétés
- cached : bool
- foregroundSource : variant
- mode : string
- source : variant
Description détaillée
Le mode de fusion peut être sélectionné à l'aide de la propriété « mode ».
| source | foregroundSource | Effet appliqué |
|---|---|---|
|
|
|
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.
| mode | description |
|---|---|
| normal | Les valeurs des composantes de pixels de l'foregroundSource e sont superposées à la source à l'aide d'un mélange alpha. |
| addition | Les valeurs des composantes de pixel de la source et de l'foregroundSource sont additionnées puis écrites. |
| moyenne | La moyenne des valeurs des composantes de pixel de la source et de l'foregroundSource est calculée, puis appliquée. |
| couleur | La valeur de luminosité de la source est combinée avec la teinte et la saturation de l'foregroundSource, puis enregistrée. |
| colorBurn | Les 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. |
| colorDodge | Les 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. |
| darken | La valeur de la composante la plus sombre parmi celles de la source et de l'foregroundSource est conservée. |
| darkerColor | La valeur RVB du pixel ayant la luminance la plus faible parmi ceux de la source et de l'foregroundSource est enregistrée. |
| différence | La différence absolue entre les valeurs des composantes de pixel de la source et de l'foregroundSource est écrite. |
| divide | Les valeurs des composantes des pixels de la source sont divisées par celles de l’ foregroundSource, puis enregistrées. |
| exclusion | La différence de valeur des composantes de pixel entre l'image source et l'foregroundSource, avec un contraste réduit, est enregistrée. |
| hardLight | Les valeurs des composantes de pixel de la source sont éclaircies ou assombries en fonction des valeurs d’ foregroundSource, puis écrites. |
| hue | La valeur de teinte de l’ foregroundSource est combinée avec la saturation et la luminosité de la source, puis enregistrée. |
| lighten | La valeur de composante de pixel la plus claire parmi celles de la source et de l'foregroundSource est enregistrée. |
| couleurPlusClaire | La 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. |
| multiply | Les valeurs des composantes des pixels provenant de la source et de l'foregroundSource sont multipliées entre elles, puis enregistrées. |
| négation | La différence absolue inversée entre les valeurs des composantes de pixel de la source et de l'foregroundSource est enregistrée. |
| Saturation | La valeur de saturation de l’ foregroundSource est combinée avec la teinte et la luminosité de la source, puis enregistrée. |
| écran | Les valeurs de pixels de la source et de l'foregroundSource sont inversées, puis multipliées, inversées à nouveau, et enregistrées. |
| soustraction | La valeur du pixel de la source « foregroundSource » est soustraite de celle de la source et le résultat est enregistré. |
| softLight | Les 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 source | Exemple foregroundSource |
|---|---|
|
|
| Exemples de résultats avec différentes valeurs de mode | ||
|---|---|---|
|
|
|
| mode : normal | mode : addition | mode : moyenne |
|
|
|
| mode : couleur | mode : colorBurn | mode : éclaircissement des couleurs |
|
|
|
| mode : assombrir | mode : couleur plus sombre | mode : différence |
|
|
|
| mode : division | mode : exclusion | mode : lumière intense |
|
|
|
| mode : teinte | mode : éclaircir | mode : couleur plus claire |
|
|
|
| mode : luminosité | mode : négation | mode : multiplication |
|
|
|
| mode : saturation | mode : écran | mode : soustraction |
| ||
| 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.
























