Тип QML HueSaturation
Изменяет цвета исходного элемента в цветовом пространстве HSL. Подробнее...
| Заявление импорта: | import QtGraphicalEffects 1.0 |
| С момента: | QtGraphicalEffects 1.0 |
| Наследует: |
Свойства
- cached : bool
- hue : real
- lightness : real
- saturation : real
- source : variant
Подробное описание
HueSaturation аналогичен эффекту Colorize, но значения свойств hue и saturation обрабатываются по-разному. Эффект HueSaturation всегда смещает оттенок, насыщенность и светлоту от исходного значения, а не устанавливает их.
| Источник | Примененный эффект |
|---|---|
Примечание: Этот эффект доступен при работе с OpenGL.
Пример
Следующий пример демонстрирует, как применить эффект.
import QtQuick 2.0
import QtGraphicalEffects 1.0
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
Это свойство определяет значение оттенка, которое добавляется к исходному значению оттенка.
Значение изменяется в диапазоне от -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
Это свойство определяет значение светлоты, которое добавляется к исходному значению насыщенности.
Значение изменяется в диапазоне от -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
Это свойство определяет значение насыщенности, которое добавляется к исходному значению насыщенности.
Значение изменяется в диапазоне от -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/archives/qt-5.11/qml-qtgraphicaleffects-huesaturation.html