Spec-Zone.ru › Qt 5.9

Тип QML ZoomBlur

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

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

Элемент

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

Свойства

  • cached : bool
  • horizontalOffset : real
  • length : real
  • samples : int
  • source : variant
  • transparentBorder : bool
  • verticalOffset : real

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

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

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

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

Пример

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

import QtQuick 2.0
import QtGraphicalEffects 1.0

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 : real

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

Значения варьируются от -бесконечности до бесконечности. По умолчанию эти свойства установлены в 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 : real

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

Качество размытия зависит от свойства 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 : int

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

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

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

source : variant

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

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

transparentBorder : bool

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

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

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

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

verticalOffset : real

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

Значения варьируются от -бесконечности до бесконечности. По умолчанию эти свойства установлены в 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.9/qml-qtgraphicaleffects-zoomblur.html

Spec-Zone.ru

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