Тип QML HueSaturation
Изменяет цвета исходного элемента в цветовом пространстве HSL. Подробнее...
| Заявление об импорте: | import QtGraphicalEffects 1.13 |
| С тех пор: | QtGraphicalEffects 1.0 |
| Наследует: |
Свойства
- cached : bool
- hue : real
- светлота : real
- насыщенность : real
- источник : variant
Подробное описание
HueSaturation похож на эффект Colorize, но значения свойств оттенка и насыщенности обрабатываются по-разному. Эффект HueSaturation всегда смещает оттенок, насыщенность и светлоту от исходного значения, а не устанавливает их.
| Источник | Применённый эффект |
|---|---|
Примечание: Этот эффект доступен при работе с OpenGL.
Пример
Следующий пример демонстрирует, как применить эффект.
import QtQuick 2.12
import QtGraphicalEffects 1.12
Item {
width: 300
height: 300
Image {
id: bug
source: "images/bug.jpg"
sourceSize: Qt.size(parent.width, parent.height)
smooth: true
visible: false
}
HueSaturation {
anchors.fill: bug
source: bug
hue: -0.3
saturation: 0.5
lightness: -0.1
}
} Документация по свойствам
cached : bool
Это свойство позволяет кэшировать выходные пиксели эффекта для повышения производительности рендеринга.
При каждом изменении источника или свойств эффекта пиксели в кэше должны быть обновлены. Потребление памяти увеличивается, так как для хранения выходных данных эффекта требуется дополнительный буфер памяти.
Рекомендуется отключать кэширование при анимации источника или свойств эффекта.
По умолчанию свойство установлено в false.
hue : real
Это свойство определяет значение оттенка, которое добавляется к исходному значению оттенка.
Значение изменяется в диапазоне от -1.0 (уменьшение) до 1.0 (увеличение). По умолчанию свойство установлено в 0.0 (без изменений).
| Примеры вывода с разными значениями оттенка | ||
|---|---|---|
| hue: -0.3 | hue: 0.0 | hue: 0.3 |
| насыщенность: 0 | насыщенность: 0 | насыщенность: 0 |
| светлота: 0 | светлота: 0 | светлота: 0 |
lightness : real
Это свойство определяет значение светлоты, которое добавляется к исходному значению насыщенности.
Значение изменяется в диапазоне от -1.0 (уменьшение) до 1.0 (увеличение). По умолчанию свойство установлено в 0.0 (без изменений).
| Примеры вывода с разными значениями светлоты | ||
|---|---|---|
| lightness: -0.5 | lightness: 0.0 | lightness: 0.5 |
| hue: 0 | hue: 0 | hue: 0 |
| насыщенность: 0 | насыщенность: 0 | насыщенность: 0 |
saturation : real
Это свойство определяет значение насыщенности, которое добавляется к исходному значению насыщенности.
Значение изменяется в диапазоне от -1.0 (уменьшение) до 1.0 (увеличение). По умолчанию свойство установлено в 0.0 (без изменений).
| Примеры вывода с разными значениями насыщенности | ||
|---|---|---|
| saturation: -0.8 | saturation: 0.0 | saturation: 1.0 |
| hue: 0 | hue: 0 | hue: 0 |
| светлота: 0 | светлота: 0 | светлота: 0 |
source : variant
Это свойство определяет элемент-источник, который предоставляет исходные пиксели для эффекта.
Примечание: Недопустимо включение эффекта в себя, например, установкой source в родительский элемент эффекта.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qml-qtgraphicaleffects-huesaturation.html