Тип ZoomBlur QML
Применяет размытие в направлении к центральной точке источника элементов. Подробнее...
| Заявление об импорте: | import QtGraphicalEffects 1.12 |
| С момента: | QtGraphicalEffects 1.0 |
| Наследует: |
Свойства
- cached : bool
- horizontalOffset : real
- length : real
- samples : int
- source : variant
- transparentBorder : bool
- verticalOffset : real
Подробное описание
Эффект создаёт видимость, что элемент-источник движется к центральной точке в направлении 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 : 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 большое, требуется больше samples для поддержания высокого качества визуализации.
Значения изменяются от 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 до бесконечности (практический максимум зависит от графического процессора). По умолчанию свойство установлено в значение 0 (без выборок).
source : variant
Это свойство определяет элемент-источник, который будет размыт.
Примечание: Нельзя включить эффект в себя, например, установив source в родительский элемент эффекта.
transparentBorder : bool
Это свойство определяет поведение размытия у краёв элемента, где размытие пикселей зависит от пикселей за пределами границ источника.
Если свойство установлено в true, пиксели за пределами источника интерпретируются как прозрачные, что аналогично расширению clamp-to-border OpenGL. Размытие слегка расширяется за область элемента эффекта.
Если свойство установлено в false, пиксели за пределами источника интерпретируются как имеющие тот же цвет, что и пиксели на границе элемента, что аналогично поведению clamp-to-edge OpenGL. Размытие не расширяется за пределы области элемента эффекта.
По умолчанию свойство установлено в значение 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.12/qml-qtgraphicaleffects-zoomblur.html