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: |
Propiedades
- cached : bool
- horizontalOffset : real
- length : real
- samples : int
- source : variant
- transparentBorder : bool
- verticalOffset : real
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.
| Fuente | Efecto 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: 24 | samples: 24 | samples: 24 |
| length: 32 | length: 32 | length: 32 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 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: 24 | samples: 24 | samples: 24 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 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: 24 | samples: 24 | samples: 24 |
| length: 32 | length: 32 | length: 32 |
| Desplazamiento vertical: 0 | Desplazamiento vertical: 0 | Desplazamiento 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.







