RadialBlur QML Type
Aplica un desenfoque direccional en forma de círculo alrededor del punto central de los elementos. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | Qt5Compat.GraphicalEffects 1.0 |
| Inherits: |
Propiedades
- angle : real
- cached : bool
- horizontalOffset : real
- samples : int
- source : variant
- transparentBorder : bool
- verticalOffset : real
Descripción detallada
El efecto crea la impresión de que el elemento original parece girar en la dirección del desenfoque.
Otros efectos de desenfoque de movimiento disponibles son ZoomBlur y DirectionalBlur.
| Fuente | Efecto aplicado |
|---|---|
|
|
Nota: Este efecto está disponible cuando se ejecuta con OpenGL.
Ejemplo de uso
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
}
RadialBlur {
anchors.fill: bug
source: bug
samples: 24
angle: 30
}
}Documentación de la propiedad
angle : real
Esta propiedad define la dirección del desenfoque y, al mismo tiempo, el nivel de desenfoque. Cuanto mayor sea el ángulo, más desenfocado será el resultado. La calidad del desenfoque depende de la propiedad « samples ». Si el valor del ángulo es elevado, se necesitan más muestras para mantener la calidad visual a un nivel alto.
Los valores permitidos están comprendidos entre 0,0 y 360,0. Por defecto, la propiedad está establecida en « 0.0 ».
| Ejemplos de resultados con diferentes valores de ángulo | ||
|---|---|---|
|
|
|
| ángulo: 0,0 | ángulo: 15,0 | ángulo: 30,0 |
| samples: 24 | samples: 24 | samples: 24 |
| horizontalOffset: 0 | horizontalOffset: 0 | horizontalOffset: 0 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
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 adicional de memoria 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 ».
horizontalOffset : real
Estas propiedades definen el desplazamiento en píxeles del punto central percibido de la rotación.
Los valores permitidos están comprendidos entre -inf e inf. Por defecto, estas propiedades están establecidas en 0.
| Ejemplos de resultados con diferentes valores de `horizontalOffset` | ||
|---|---|---|
|
|
|
| horizontalOffset: 75,0 | horizontalOffset: 0,0 | horizontalOffset: -75,0 |
| samples: 24 | samples: 24 | samples: 24 |
| angle: 20 | angle: 20 | angle: 20 |
| verticalOffset: 0 | verticalOffset: 0 | verticalOffset: 0 |
samples : int
Esta propiedad define el número de muestras que se toman por píxel al calcular el desenfoque. Un valor más alto ofrece mejor calidad, pero ralentiza el renderizado.
Esta propiedad no está pensada para ser animada. Cambiar esta propiedad puede provocar que se recompilen los shaders de OpenGL subyacentes.
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 de origen al que se le va a aplicar el efecto de desenfoque.
Nota: Noestá permitido que el efecto se incluya a sí mismo, por ejemplo, configurando el elemento de origen como el elemento padre del efecto.
transparentBorder : bool
Esta propiedad define el comportamiento del desenfoque cerca de los bordes del elemento, donde el desenfoque de los píxeles se ve afectado por los píxeles situados fuera de los bordes de la fuente.
Si la propiedad se establece en « true », los píxeles situados fuera del elemento de origen se interpretan como transparentes, lo que es similar a la extensión «clamp-to-border» de OpenGL. El desenfoque se expande ligeramente fuera del área del elemento de efecto.
Si la propiedad se establece en « false », los píxeles situados fuera de la fuente se interpretan como si contuvieran el mismo color que los píxeles del borde del elemento, lo que es similar al comportamiento «clamp-to-edge» de OpenGL. El desenfoque no se extiende fuera del área del elemento de efecto.
De forma predeterminada, la propiedad está establecida en « false ».
verticalOffset : real
Estas propiedades definen el desplazamiento en píxeles del punto central percibido de la rotación.
Los valores permitidos están comprendidos entre -inf e inf. Por defecto, estas propiedades están establecidas en 0.
| Ejemplos de resultados con diferentes valores de « horizontalOffset » | ||
|---|---|---|
|
|
|
| horizontalOffset: 75,0 | horizontalOffset: 0,0 | horizontalOffset: -75,0 |
| samples: 24 | samples: 24 | samples: 24 |
| angle: 20 | angle: 20 | angle: 20 |
| 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.







