FastBlur QML Type
Aplica un efecto de desenfoque rápido a uno o varios elementos de origen. Más...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Propiedades
- cached : bool
- radius : real
- source : variant
- transparentBorder : bool
Descripción detallada
Nota: El componente « MultiEffect » proporciona un efecto de desenfoque con algunas ventajas en cuanto al rendimiento. Para el código nuevo, debería considerarse como una alternativa al uso de Qt Graphical Effects.
El efecto FastBlur suaviza el contenido de origen desenfocándolo mediante un algoritmo que utiliza la reducción de resolución del contenido de origen y el filtrado bilineal.
| Fuente | Efecto aplicado |
|---|---|
|
|
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
}
FastBlur {
anchors.fill: bug
source: bug
radius: 32
}
}Documentación de propiedades
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 de memoria adicional 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 ».
radius : real
Esta propiedad define la distancia de los píxeles vecinos que influyen en el desenfoque de un píxel concreto. Un radio mayor aumenta el efecto de desenfoque. El algoritmo de FastBlur puede reducir internamente la precisión del radio para garantizar un buen rendimiento de renderizado.
El valor oscila entre 0,0 (sin desenfoque) e infinito. La calidad visual del desenfoque se reduce cuando el radio supera el valor 64. Por defecto, la propiedad está establecida en « 0.0 » (sin desenfoque).
| Ejemplos de resultados con diferentes valores de desenfoque | ||
|---|---|---|
|
|
|
| radio: 0 | radio: 32 | radio: 64 |
source : variant
Esta propiedad define el elemento de origen que se va a desenfocar.
Nota: Noes posible que el efecto se incluya a sí mismo, por ejemplo, estableciendo como origen 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 ».
© 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.






