En esta página

ZoomBlur QML Type

Aplica el efecto de desenfoque direccional hacia el punto central de los elementos fuente. Más...

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

Item

Propiedades

Descripción detallada

El efecto crea la impresión de que el elemento fuente parece moverse hacia el punto central en la dirección Z o que la cámara parece acercarse rápidamente. Otros efectos de desenfoque de movimiento disponibles son DirectionalBlur y RadialBlur.

FuenteEfecto aplicado

Nota: Este efecto está disponible cuando se ejecuta con OpenGL.

Ejemplo

El siguiente ejemplo muestra cómo aplicar el efecto.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: butterfly
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    ZoomBlur {
        anchors.fill: butterfly
        source: butterfly
        samples: 24
        length: 48
    }
}

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.

horizontalOffset : real

Estas propiedades definen un desplazamiento en píxeles para el punto central de la dirección del desenfoque.

Los valores van de -inf a inf. Por defecto, estas propiedades se establecen en 0.

Ejemplos de salida con diferentes valores de horizontalOffset

horizontalOffset: 100.0 horizontalOffset: 0.0 horizontalOffset: -100.0
samples: 24samples: 24samples: 24
length: 32length: 32length: 32
verticalOffset: 0verticalOffset: 0verticalOffset: 0

length : real

Esta propiedad define la cantidad máxima percibida de movimiento para cada píxel. La cantidad es menor cerca del centro y alcanza el valor especificado en los bordes.

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

Ejemplos de salida con diferentes valores de longitud

longitud: 0.0 longitud: 32.0 longitud: 48.0
samples: 24samples: 24samples: 24
horizontalOffset: 0horizontalOffset: 0horizontalOffset: 0
verticalOffset: 0verticalOffset: 0verticalOffset: 0

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.

Nota: No se admite que el efecto se incluya a sí mismo, por ejemplo estableciendo source como el padre del efecto.

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

verticalOffset : real

Estas propiedades definen un desplazamiento en píxeles para el punto central de la dirección del desenfoque.

Los valores van de -inf a inf. Por defecto, estas propiedades se establecen en 0.

Ejemplos de salida con diferentes valores de horizontalOffset

horizontalOffset: 100.0 horizontalOffset: 0.0 horizontalOffset: -100.0
samples: 24samples: 24samples: 24
length: 32length: 32length: 32
Desplazamiento vertical: 0Desplazamiento vertical: 0Desplazamiento vertical: 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.