Тип QML RecursiveBlur

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

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

Свойства

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

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

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

Пример

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

import QtQuick 2.0
import QtGraphicalEffects 1.0

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

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

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

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

source : variant

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

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

transparentBorder : bool

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

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

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

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