DirectionalBlur QML Type

Aplica el efecto de desenfoque a la dirección especificada. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• angle : real
• cached : bool
• length : real
• samples : int
• source : variant
• transparentBorder : bool

Descripción detallada

El efecto crea la impresión de que el elemento fuente parece moverse en la dirección del desenfoque. El desenfoque se aplica a ambos lados de cada píxel, por lo que establecer la dirección en 0 y 180 proporciona el mismo resultado.

Otros efectos de desenfoque de movimiento disponibles son ZoomBlur y RadialBlur.

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
    }

    DirectionalBlur {
        anchors.fill: bug
        source: bug
        angle: 90
        length: 32
        samples: 24
    }
}

Documentación de propiedades

angle : real

Esta propiedad define la dirección del desenfoque. El desenfoque se aplica a ambos lados de cada píxel, por lo que establecer la dirección a 0 y 180 produce el mismo resultado.

El valor oscila entre -180.0 y 180.0. Por defecto la propiedad está establecida en 0.0.

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.

length : real

Esta propiedad define la cantidad percibida de movimiento para cada píxel. El movimiento se divide uniformemente a ambos lados de cada píxel.

La calidad del desenfoque depende de la propiedad samples. Si el valor de longitud es grande, se necesitan más muestras para mantener la calidad visual en un nivel alto.

El valor va de 0.0 a inf. Por defecto, la propiedad está establecida en 0.0 (sin desenfoque).

samples : int

Esta propiedad define cuántas muestras se toman por píxel cuando se realiza el cálculo del desenfoque. Un valor mayor produce mejor calidad, pero es más lento de renderizar.

Esta propiedad no está pensada para ser animada. Cambiar esta propiedad puede causar que los shaders OpenGL subyacentes sean recompilados.

Los valores permitidos están entre 0 e inf (el máximo práctico depende de la GPU). Por defecto, la propiedad está establecida en 0 (sin muestras).

source : variant

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

transparentBorder : bool

Esta propiedad define el comportamiento del desenfoque cerca de los bordes del elemento, donde el desenfoque del píxel se ve afectado por los píxeles fuera de los bordes de la fuente.

Si la propiedad se establece en true, los píxeles fuera de la fuente se interpretan como transparentes, lo que es similar a la extensión de sujeción a bordes de OpenGL. El desenfoque se expande ligeramente fuera del área del elemento de efecto.

Si la propiedad está definida como false, se interpreta que los píxeles fuera de la fuente contienen el mismo color que los píxeles en el borde del elemento, lo que es similar al comportamiento de sujeción a borde de OpenGL. El desenfoque no se expande fuera del área del elemento de efecto.

Por defecto, la propiedad está establecida en false.