Spec-Zone.ru › Qt 5.14

Тип QML ZoomBlur

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

Заявление об импорте: import QtGraphicalEffects 1.14
С момента: QtGraphicalEffects 1.0
Наследует:

Элемент

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

Свойства

  • cached : bool
  • horizontalOffset : вещественное число
  • length : вещественное число
  • samples : целое число
  • source : значение
  • transparentBorder : bool
  • verticalOffset : вещественное число

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

Эффект создает визуальное впечатление, что элемент-источник перемещается к центральной точке в направлении Z-оси, или что камера быстро приближается/отдаляется. Другие доступные эффекты размытия движения: DirectionalBlur и RadialBlur.

Источник Применённый эффект

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

Пример

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

import QtQuick 2.12
import QtGraphicalEffects 1.12

Item {
    width: 300
    height: 300

    Image {
        id: butterfly
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    ZoomBlur {
        anchors.fill: butterfly
        source: butterfly
        samples: 24
        length: 48
    }
}

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

cached : bool

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

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

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

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

horizontalOffset : вещественное число

Эти свойства определяют смещение в пикселях для центральной точки направления размытия.

Значения варьируются от -бесконечности до бесконечности. По умолчанию эти свойства установлены в 0.

Примеры выходных данных с различными значениями horizontalOffset

horizontalOffset: 100.0 horizontalOffset: 0.0 horizontalOffset: -100.0
samples: 24 samples: 24 samples: 24
length: 32 length: 32 length: 32
verticalOffset: 0 verticalOffset: 0 verticalOffset: 0

length : вещественное число

Это свойство определяет максимальную воспринимаемую величину смещения для каждого пикселя. Значение уменьшается вблизи центра и достигает указанного значения на краях.

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

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

Примеры выходных данных с различными значениями length

length: 0.0 length: 32.0 length: 48.0
samples: 24 samples: 24 samples: 24
horizontalOffset: 0 horizontalOffset: 0 horizontalOffset: 0
verticalOffset: 0 verticalOffset: 0 verticalOffset: 0

samples : целое число

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

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

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

source : значение

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

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

transparentBorder : bool

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

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

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

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

verticalOffset : вещественное число

Эти свойства определяют смещение в пикселях для центральной точки направления размытия.

Значения варьируются от -бесконечности до бесконечности. По умолчанию эти свойства установлены в 0.

Примеры выходных данных с различными значениями horizontalOffset

horizontalOffset: 100.0 horizontalOffset: 0.0 horizontalOffset: -100.0
samples: 24 samples: 24 samples: 24
length: 32 length: 32 length: 32
verticalOffset: 0 verticalOffset: 0 verticalOffset: 0

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qml-qtgraphicaleffects-zoomblur.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API