ThresholdMask QML Type

Enmascara el elemento de origen con otro elemento y aplica un valor umbral. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• cached : bool
• maskSource : variant
• source : variant
• spread : real
• threshold : real

Descripción detallada

El comportamiento de la máscara puede controlarse con el valor threshold para los píxeles de la máscara.

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

maskSource : variant

Esta propiedad define el elemento que se va a utilizar como máscara. El elemento 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 fuente en la pantalla.

source : variant

Esta propiedad define el elemento fuente que va a ser enmascarado.

spread : real

Esta propiedad define la suavidad de los bordes de la máscara cerca del valor alfa de threshold. Establecer spread a 0.0 utiliza la máscara normalmente con el umbral especificado. Establecer valores de dispersión más altos suaviza la transición de los píxeles transparentes de la máscara hacia los píxeles opacos de la máscara 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.

threshold : real

Esta propiedad define un valor umbral para los píxeles de la máscara. Los píxeles de máscara que tienen un valor alfa inferior a esta propiedad se utilizan para enmascarar completamente los píxeles correspondientes del elemento fuente. Los píxeles de la máscara que tienen un valor alfa más alto se utilizan para alfabetizar el elemento fuente en la pantalla.

El valor oscila entre 0.0 (valor alfa 0) y 1.0 (valor alfa 255). Por defecto, la propiedad está establecida en 0.0.