En esta página

RecursiveBlur QML Type

Aplica el desenfoque repetidamente, lo que proporciona un efecto de desenfoque muy marcado. Más...

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

Item

Propiedades

Descripción detallada

El efecto «RecursiveBlur» suaviza la imagen difuminándola mediante un algoritmo que utiliza un bucle de retroalimentación recursivo para difuminar la imagen original varias veces. El efecto puede ofrecer resultados más difuminados que GaussianBlur o FastBlur, pero el resultado se genera de forma asíncrona y tarda más tiempo.

FuenteEfecto aplicado

Escarabajo negro sobre una hoja

Escarabajo con efecto de desenfoque recursivo

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: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    RecursiveBlur {
        anchors.fill: bug
        source: bug
        radius: 7.5
        loops: 50
    }
}

Documentación de la propiedad

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 se animen las propiedades de la fuente o del efecto.

De forma predeterminada, la propiedad está establecida en « false ».

loops : int

Esta propiedad define el número de iteraciones de desenfoque que se van a realizar sobre la fuente. Cuando se modifica la propiedad, se inicia el proceso iterativo de desenfoque. Si se reduce el valor o si este pasa de cero a un valor distinto de cero, se toma una instantánea de la fuente. La instantánea se utiliza como punto de partida para el proceso.

El bucle de iteraciones intenta ejecutarse lo más rápido posible. La velocidad puede verse limitada por el VSYNC, por el tiempo necesario para un paso de desenfoque, o por ambos. En ocasiones, puede ser conveniente realizar el desenfoque a un ritmo más lento. En ese caso, puede resultar útil controlar la propiedad mediante una animación que aumente el valor.

El valor oscila entre 0 e infinito. Por defecto, la propiedad está establecida en « 0 ».

Ejemplos de resultados con diferentes valores de loops

Escarabajo con 4 bucles borrosos

Escarabajo con 20 bucles de desenfoque

Escarabajo con 70 bucles borrosos

loops: 4 loops: 20 loops: 70
radius: 7,5radius: 7,5radius: 7,5

progress : real

Esta propiedad indica el progreso del proceso asíncrono de desenfoque de la fuente, desde 0,0 (sin desenfoque) hasta 1,0 (finalizado).

radius : real

Esta propiedad define la distancia entre los píxeles adyacentes que influyen en el desenfoque de cada píxel. Un radio mayor ofrece mejor calidad, pero el renderizado es más lento.

Nota: El valor del radio en este efecto no está pensado para cambiarse ni animarse con frecuencia. La forma correcta de utilizarlo es establecer el valor adecuado y mantenerlo sin cambios durante toda la secuencia de desenfoque iterativo.

El valor oscila entre (sin desenfoque) y 16,0 (nivel máximo de desenfoque). Por defecto, la propiedad está establecida en 0.0 (sin desenfoque).

Ejemplos de resultados con diferentes valores de radio

Escarabajo con un radio de 2,5

Escarabajo con un radio de 4,5

Escarabajo con radio de 7,5

radio: 2,5 radio: 4,5 radio: 7,5
loops: 20loops: 20loops: 20

Nota: La propiedad « radius » se utiliza para calcular el tamaño del búfer fuera de pantalla del efecto. Los valores más altos provocarán asignaciones de memoria más grandes.

source : variant

Esta propiedad define el elemento de origen al que se le va a aplicar el efecto de desenfoque.

Nota: Nose admite 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 del elemento de origen 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 ».

Ejemplos de resultado con diferentes valores de «transparentBorder»

Desactivado el efecto de desenfoque con borde transparente

Desenfoque con borde transparente activado

transparentBorder: false transparentBorder: true
loops: 20loops: 20
radius: 7,5radius: 7,5

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