OpacityMask QML Type
Enmascara el elemento de origen con otro elemento. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propiedades
- cached : bool
- invert : bool
- maskSource : variant
- source : variant
Descripción detallada
Nota: El componente MultiEffect proporciona un efecto de máscara con algunas ventajas de rendimiento. Para código nuevo, debería considerarse como una alternativa al uso de Qt Graphical Effects.
| Fuente | MáscaraFuente | Efecto aplicado |
|---|---|---|
|
|
|
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 para mejorar el rendimiento del renderizado.
Cada vez que se cambian las propiedades de la fuente o del efecto, los píxeles de la caché deben actualizarse. El consumo de memoria se incrementa, ya que se requiere un buffer extra de memoria para almacenar la salida del efecto.
Se recomienda desactivar la caché cuando se animen la fuente o las propiedades del efecto.
Por defecto, la propiedad está establecida en false.
Nota: No se permite que el efecto se incluya a sí mismo, por ejemplo, estableciendo maskSource como padre del efecto.
invert : bool
Esta propiedad controla cómo se comportarán los valores alfa de la sourceMask.
Si esta propiedad es false, la opacidad resultante es el alfa de la fuente 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 predeterminado es false.
maskSource : variant
Esta propiedad define el elemento que se va a utilizar como máscara. El elemento de la máscara se renderiza 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.
| Original | Máscara | Efecto aplicado |
|---|---|---|
|
|
|
source : variant
Esta propiedad define el elemento fuente que va a ser enmascarado.
Nota: No se admite que el efecto se incluya a sí mismo, por ejemplo estableciendo source como 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.


