Тип QML DirectionalBlur

Применяет эффект размытия к указанному направлению. Подробнее...

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

Свойства

• угол : вещественное число
• кешированный : логическое значение
• длина : вещественное число
• образцы : целое число
• источник : тип значения
• прозрачнаяГраница : логическое значение

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

Эффект создает видимое впечатление, что элемент-источник перемещается в направлении размытия. Размытие применяется к обеим сторонам каждого пикселя, поэтому установка направления на 0 и 180 даёт одинаковый результат.

Другие доступные эффекты движения размытия — ZoomBlur и RadialBlur.

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

Пример

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

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
    }

    DirectionalBlur {
        anchors.fill: bug
        source: bug
        angle: 90
        length: 32
        samples: 24
    }
}

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

угол : вещественное число

Это свойство определяет направление размытия. Размытие применяется к обеим сторонам каждого пикселя, поэтому установка направления на 0 и 180 даёт одинаковый результат.

Значение находится в диапазоне от -180.0 до 180.0. По умолчанию свойство установлено в 0.0.

кешированный : логическое значение

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

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

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

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

длина : вещественное число

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

Качество размытия зависит от свойства образцы. Если значение длины велико, требуется больше образцов, чтобы сохранить визуальное качество на высоком уровне.

Значение находится в диапазоне от 0.0 до бесконечности. По умолчанию свойство установлено в 0.0 (без размытия).

образцы : целое число

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

Это свойство не предназначено для анимации. Изменение этого свойства может привести к перекомпиляции базовых шейдеров OpenGL.

Допустимые значения находятся в диапазоне от 0 до бесконечности (практический максимум зависит от графического процессора). По умолчанию свойство установлено в 0 (без образцов).

источник : тип значения

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

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

прозрачнаяГраница : логическое значение

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

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

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

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