OpacityMask QML Type

Masque l'élément source avec un autre élément. Plus d'informations...

• 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 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.

invert : bool

Cette propriété contrôle le comportement des valeurs alpha du sourceMask.

Si cette propriété vaut false, l'opacité résultante est l'alpha de la source multiplié par l'alpha du masque, As * Am.

Si cette propriété vaut true, l'opacité résultante est 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 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.

source : variant

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