OpacityMask QML Type

Masque l'élément source à l'aide d'un autre élément. En savoir plus...

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

Propriétés

• cached : bool
• invert : bool
• maskSource : variant
• source : variant

Description détaillée

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: mask
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    OpacityMask {
        anchors.fill: bug
        source: bug
        maskSource: mask
    }
}

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 la mise en 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 ».

invert : bool

Cette propriété détermine le comportement des valeurs alpha du « sourceMask ».

Si cette propriété est définie sur « false », l'opacité résultante correspond au produit de l'alpha source par l'alpha du masque, soit As * Am.

Si cette propriété est définie sur « true », l’opacité obtenue correspond à l’alpha de la source multiplié par l’inverse de l’alpha du masque, As * (1 - Am).

La valeur par défaut est « false ».

maskSource : variant

Cette propriété définit l'élément qui sera utilisé comme masque. L'élément servant 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é.