Тип QML RecursiveBlur

Многократно размывает, обеспечивая сильный эффект размытия. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• cached : bool
• loops : int
• progress : real
• radius : real
• source : variant
• transparentBorder : bool

Подробное описание

Эффект RecursiveBlur смягчает изображение, размывая его алгоритмом, использующим рекурсивную обратную связь для многократного размытия источника. Эффект может давать более размытый результат, чем GaussianBlur или FastBlur, но результат создается асинхронно и занимает больше времени.

Примечание: Этот эффект доступен при работе с OpenGL.

Пример

Следующий пример демонстрирует, как применить эффект.

import QtQuick 2.12
import QtGraphicalEffects 1.12

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

Документация по свойствам

cached : bool

Это свойство позволяет кэшировать выходные пиксели эффекта для повышения производительности рендеринга.

При каждом изменении источника или свойств эффекта пиксели в кэше должны быть обновлены. Потребление памяти увеличивается, так как требуется дополнительный буфер памяти для хранения выходных данных эффекта.

Рекомендуется отключить кэш при анимации источника или свойств эффекта.

По умолчанию свойство установлено в false.

loops : int

Это свойство определяет количество итераций размытия, которые будут выполнены для источника. При изменении свойства процесс итерационного размытия запускается. Если значение уменьшается или меняется с нуля на ненулевое, делается моментальный снимок источника. Снимок используется в качестве начальной точки процесса.

Петля итераций пытается работать как можно быстрее. Скорость может быть ограничена VSYNC или временем, необходимым для одного шага размытия, или обоими. Иногда желательно выполнять размытие с более медленным темпом. В этом случае может быть удобно управлять свойством с помощью анимации, увеличивая его значение.

Значение изменяется от 0 до бесконечности. По умолчанию свойство установлено в 0.

progress : real

Это свойство содержит прогресс асинхронного процесса размытия источника, от 0,0 (ничего не размыто) до 1,0 (завершено).

radius : real

Это свойство определяет расстояние соседних пикселей, которые влияют на размытие отдельных пикселей. Более большой радиус обеспечивает лучшее качество, но медленнее отображается.

Примечание: Значение радиуса в этом эффекте не предназначено для частой смены или анимации. Правильный способ его использования — установить корректное значение и оставить его неизменным на протяжении всего процесса итерационного размытия.

Значение изменяется от 0 (без размытия) до 16,0 (максимальный шаг размытия). По умолчанию свойство установлено в 0.0 (без размытия).

source : variant

Это свойство определяет элемент-источник, который будет размыт.

Примечание: Не допускается включение эффекта в сам эффект, например, путем задания source в родительский элемент эффекта.

transparentBorder : bool

Это свойство определяет поведение размытия около краёв элемента, где размытие пикселей зависит от пикселей за пределами границ источника.

Если свойство установлено в true, пиксели за пределами источника интерпретируются как прозрачные, что аналогично расширению clamp-to-border OpenGL. Размытие немного расширяется за область элемента эффекта.

Если свойство установлено в false, пиксели за пределами источника интерпретируются как содержащие тот же цвет, что и пиксели на краю элемента, что аналогично поведению clamp-to-edge OpenGL. Размытие не расширяется за область элемента эффекта.

По умолчанию свойство установлено в false.