En esta página

OpacityMask QML Type

Oculta el elemento de origen con otro elemento. Más...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Propiedades

Descripción detallada

Nota: El componente ` MultiEffect ` ofrece un efecto de máscara con algunas ventajas en cuanto al rendimiento. Para el código nuevo, debería considerarse como una alternativa al uso de `Qt Graphical Effects`.

FuenteMaskSourceEfecto aplicado

Escarabajo negro sobre una hoja

Máscara de degradado circular

Escarabajo con máscara circular aplicada

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

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

Documentación de propiedades

cached : bool

Esta propiedad permite almacenar en caché los píxeles de salida del efecto con el fin de mejorar el rendimiento del renderizado.

Cada vez que se modifican las propiedades de la fuente o del efecto, es necesario actualizar los píxeles de la caché. El consumo de memoria aumenta, ya que se requiere un búfer de memoria adicional para almacenar la salida del efecto.

Se recomienda desactivar la caché cuando las propiedades de la fuente o del efecto estén animadas.

Por defecto, la propiedad está establecida en « false ».

Nota: Nose admite que el efecto se incluya a sí mismo, por ejemplo, estableciendo ` maskSource ` en el padre del efecto.

invert : bool

Esta propiedad controla cómo se comportarán los valores alfa de la máscara de origen.

Si esta propiedad es « false », la opacidad resultante es el alfa de origen multiplicado por el alfa de la máscara, « As * Am ».

Si esta propiedad es « true », la opacidad resultante es el alfa de la fuente multiplicado por el inverso del alfa de la máscara, As * (1 - Am).

El valor por defecto es false.

maskSource : variant

Esta propiedad define el elemento que se va a utilizar como máscara. El elemento de máscara se representa en un búfer de píxeles intermedio y los valores alfa del resultado se utilizan para determinar la visibilidad de los píxeles del elemento de origen en la pantalla.

OriginalMáscaraEfecto aplicado

Escarabajo negro sobre una hoja

Máscara de degradado circular

Escarabajo con máscara circular colocada

source : variant

Esta propiedad define el elemento de origen que se va a enmascarar.

Nota: Noes posible que el efecto se incluya a sí mismo, por ejemplo, estableciendo como origen el elemento padre del efecto.

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