En esta página

FastBlur QML Type

Aplica un efecto de desenfoque rápido a uno o más elementos fuente. Más...

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

Item

Propiedades

Descripción detallada

Nota: El componente MultiEffect proporciona un efecto de desenfoque con algunas ventajas de rendimiento. Para código nuevo, debe considerarse como una alternativa al uso de Qt Graphical Effects.

El efecto FastBlur suaviza el contenido fuente desenfocándolo con un algoritmo que utiliza la reducción de escala del contenido fuente y el filtrado bilineal.

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

radius : real

Esta propiedad define la distancia de los píxeles vecinos que afectan al desenfoque de un píxel individual. Un radio mayor aumenta el efecto de desenfoque. El algoritmo FastBlur puede reducir internamente la precisión del radio para proporcionar un buen rendimiento de renderizado.

El valor oscila entre 0,0 (sin desenfoque) e inf. 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 salida con diferentes valores de desenfoque

radio: 0 radio 32 radio: 64

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

Ejemplos de salida con diferentes valores de transparentBorder

transparentBorder: false transparentBorder: true
radius: 64radius: 64

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