ThresholdMask QML Type
Masque l'élément source avec un autre élément et applique une valeur seuil. Plus d'informations...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propriétés
- cached : bool
- maskSource : variant
- source : variant
- spread : real
- threshold : real
Description détaillée
Le comportement du masquage peut être contrôlé par la valeur threshold pour les pixels du masque.
| Source | Source du masque | Effet appliqué |
|---|---|---|
|
|
|
Exemple d'application
L'exemple suivant montre comment appliquer l'effet.
import QtQuick import Qt5Compat.GraphicalEffects Item { width: 300 height: 300 Image { id: background anchors.fill: parent source: "images/checker.png" smooth: true fillMode: Image.Tile } Image { id: bug source: "images/bug.jpg" sourceSize: Qt.size(parent.width, parent.height) smooth: true visible: false } Image { id: mask source: "images/fog.png" sourceSize: Qt.size(parent.width, parent.height) smooth: true visible: false } ThresholdMask { anchors.fill: bug source: bug maskSource: mask threshold: 0.4 spread: 0.2 } }
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.
maskSource : variant |
Cette propriété définit l'élément qui sera utilisé comme masque. L'élément du masque est rendu dans un tampon de pixels intermédiaire et les valeurs alpha du résultat sont utilisées pour déterminer la visibilité des pixels de l'élément source dans l'affichage.
| Original | Masque | Effet appliqué |
|---|---|---|
|
|
|
Remarque : il n'est pas possible de laisser l'effet s'inclure lui-même, par exemple en définissant maskSource sur le parent de l'effet.
source : variant |
Cette propriété définit l'élément source qui va être masqué.
Note : Il n'est pas possible de laisser l'effet s'inclure lui-même, par exemple en fixant la source au parent de l'effet.
spread : real |
Cette propriété définit la finesse des bords du masque à proximité de la valeur alpha threshold. Si la valeur de l'écart est de 0,0, le masque est normalement utilisé avec le seuil spécifié. Des valeurs d'étalement plus élevées adoucissent la transition entre les pixels transparents du masque et les pixels opaques du masque en ajoutant des valeurs interpolées entre eux.
La valeur est comprise entre 0,0 (bord de masque net) et 1,0 (bord de masque lisse). Par défaut, la propriété est définie sur 0.0.
threshold : real |
Cette propriété définit une valeur seuil pour les pixels du masque. Les pixels de masque dont la valeur alpha est inférieure à cette propriété sont utilisés pour masquer complètement les pixels correspondants de l'élément source. Les pixels du masque qui ont une valeur alpha plus élevée sont utilisés pour afficher l'élément source à l'écran.
La valeur est comprise entre 0,0 (valeur alpha 0) et 1,0 (valeur alpha 255). Par défaut, la propriété est définie sur 0.0.
© 2025 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.








