ThresholdMask QML Type

Masque l'élément source à l'aide d'un autre élément et applique une valeur seuil. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

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é à l'aide de la valeur « threshold » pour les pixels du masque.

Exemple

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

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, 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 de masque est rendu dans un tampon de pixels intermédiaire et les valeurs alpha issues du résultat sont utilisées pour déterminer la visibilité des pixels de l'élément source à l'écran.

source : variant

Cette propriété définit l'élément source qui va être masqué.

spread : real

Cette propriété définit la douceur des bords du masque à proximité de la valeur alpha « threshold ». Si la valeur de «spread» est définie sur 0,0, le masque est utilisé normalement avec le seuil spécifié. Des valeurs plus élevées de «spread» adoucissent la transition entre les pixels transparents et opaques du masque en ajoutant des valeurs interpolées entre eux.

La valeur varie de 0,0 (bord de masque net) à 1,0 (bord de masque lissé). 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 du masque dont la valeur alpha est inférieure à cette valeur sont utilisés pour masquer entièrement les pixels correspondants de l'élément source. Les pixels du masque dont la valeur alpha est supérieure sont utilisés pour effectuer un mélange alpha entre l'élément source et l'affichage.

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.