ThresholdMask QML Type
Oculta el elemento de origen con otro elemento y aplica un valor umbral. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propiedades
- cached : bool
- maskSource : variant
- source : variant
- spread : real
- threshold : real
Descripción detallada
Nota: El componente « MultiEffect » proporciona un efecto de máscara con algunas ventajas en cuanto al rendimiento. En el código nuevo, debería considerarse como una alternativa al uso de Qt Graphical Effects.
El comportamiento del enmascaramiento se puede controlar mediante el valor de « threshold » para los píxeles de la máscara.
| Fuente | MaskSource | Efecto aplicado |
|---|---|---|
|
|
|
Ejemplo
El siguiente ejemplo muestra cómo aplicar el efecto.
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
}
}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 ».
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.
| Original | Máscara | Efecto aplicado |
|---|---|---|
|
|
|
Nota: Nose admite que el efecto se incluya a sí mismo, por ejemplo, estableciendo `maskSource` en el padre del efecto.
source : variant
Esta propiedad define el elemento de origen que se va a enmascarar.
Nota: Noestá permitido que el efecto se incluya a sí mismo, por ejemplo, estableciendo como origen el elemento padre del efecto.
spread : real
Esta propiedad define la suavidad de los bordes de la máscara cerca del valor alfa de « threshold ». Si se establece «spread» en 0,0, la máscara se utiliza de forma normal con el umbral especificado. Al establecer valores más altos de «spread», se suaviza la transición de los píxeles transparentes de la máscara hacia los opacos, añadiendo valores interpolados entre ellos.
El valor oscila entre 0,0 (borde de máscara nítido) y 1,0 (borde de máscara suave). Por defecto, la propiedad está establecida en « 0.0 ».
| Ejemplos de resultados con diferentes valores de «spread» | ||
|---|---|---|
|
|
|
| difusión: 0,0 | dispersión: 0,2 | difusión: 0,8 |
| threshold: 0,4 | threshold: 0,4 | threshold: 0,4 |
threshold : real
Esta propiedad define un valor umbral para los píxeles de la máscara. Los píxeles de la máscara que tienen un valor alfa inferior al de esta propiedad se utilizan para enmascarar por completo los píxeles correspondientes del elemento de origen. Los píxeles de la máscara que tienen un valor alfa superior se utilizan para realizar una mezcla alfa del elemento de origen con la pantalla.
El valor oscila entre 0,0 (valor alfa 0) y 1,0 (valor alfa 255). De forma predeterminada, la propiedad está establecida en 0.0.
© 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.








