Тип QML DirectionalBlur

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

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

Свойства

• angle : real
• cached : bool
• length : real
• samples : int
• source : variant
• transparentBorder : bool

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

Эффект создает впечатление, что исходный элемент движется в направлении размытия. Размытие применяется к обеим сторонам каждого пикселя, поэтому установка направления в 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
    }
}

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

angle : real

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

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

cached : bool

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

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

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

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

length : real

Это свойство определяет воспринимаемую величину перемещения каждого пикселя. Перемещение распределяется равномерно по обеим сторонам каждого пикселя.

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

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

samples : int

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

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

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

source : variant

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

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

transparentBorder : bool

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

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

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

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