Тип QML HueSaturation
Изменяет цвета исходного элемента в цветовом пространстве HSL. Подробнее...
| Заявление об импорте: | import QtGraphicalEffects 1.15 |
| С момента: | QtGraphicalEffects 1.0 |
| Наследует: |
Свойства
- cached : bool
- hue : real
- lightness : real
- saturation : real
- source : variant
Подробное описание
HueSaturation похож на эффект Colorize, но значения свойств hue и saturation обрабатываются по-разному. Эффект HueSaturation всегда смещает hue, saturation и lightness от исходных значений, а не устанавливает их.
| Исходный элемент | Примененный эффект |
|---|---|
Примечание: Этот эффект доступен при работе с 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
Это свойство позволяет кэшировать выходные пиксели эффекта для повышения производительности рендеринга.
Каждый раз, когда изменяются свойства source или effect, пиксели в кэше должны быть обновлены. Потребление памяти увеличивается, так как требуется дополнительный буфер памяти для хранения выходных данных эффекта.
Рекомендуется отключить кэш, когда свойства source или effect анимированы.
По умолчанию свойство установлено в false.
hue : real
Это свойство определяет значение hue, которое добавляется к значению hue исходного элемента.
Значение изменяется в диапазоне от -1.0 (уменьшение) до 1.0 (увеличение). По умолчанию свойство установлено в 0.0 (без изменений).
| Примеры выходных данных с разными значениями hue | ||
|---|---|---|
| hue: -0.3 | hue: 0.0 | hue: 0.3 |
| saturation: 0 | saturation: 0 | saturation: 0 |
| lightness: 0 | lightness: 0 | lightness: 0 |
lightness : real
Это свойство определяет значение lightness, которое добавляется к значению saturation исходного элемента.
Значение изменяется в диапазоне от -1.0 (уменьшение) до 1.0 (увеличение). По умолчанию свойство установлено в 0.0 (без изменений).
| Примеры выходных данных с разными значениями lightness | ||
|---|---|---|
| lightness: -0.5 | lightness: 0.0 | lightness: 0.5 |
| hue: 0 | hue: 0 | hue: 0 |
| saturation: 0 | saturation: 0 | saturation: 0 |
saturation : real
Это свойство определяет значение saturation, которое добавляется к значению saturation исходного элемента.
Значение изменяется в диапазоне от -1.0 (уменьшение) до 1.0 (увеличение). По умолчанию свойство установлено в 0.0 (без изменений).
| Примеры выходных данных с разными значениями saturation | ||
|---|---|---|
| saturation: -0.8 | saturation: 0.0 | saturation: 1.0 |
| hue: 0 | hue: 0 | hue: 0 |
| lightness: 0 | lightness: 0 | lightness: 0 |
source : variant
Это свойство определяет исходный элемент, который предоставляет пиксели для эффекта.
Примечание: Не допускается включение эффекта в сам себя, например, путем установки source в родителя эффекта.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtgraphicaleffects-huesaturation.html