Тип QML HueSaturation
Изменяет цвета исходного элемента в цветовом пространстве HSL. Подробнее...
| Заявление об импорте: | import QtGraphicalEffects 1.14 |
| С момента: | QtGraphicalEffects 1.0 |
| Наследует: |
Свойства
- cached : bool
- hue : real
- lightness : real
- saturation : real
- source : variant
Подробное описание
HueSaturation похож на эффект Colorize, но значения свойств hue и saturation обрабатываются по-другому. Эффект 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
Это свойство позволяет кэшировать выходные пиксели эффекта для повышения производительности рендеринга.
Каждый раз, когда изменяются свойства source или effect, пиксели в кэше должны быть обновлены. Потребление памяти увеличивается, так как для хранения выходных данных эффекта требуется дополнительный буфер памяти.
Рекомендуется отключать кэш, когда свойства source или effect анимируются.
По умолчанию свойство установлено в false.
hue : real
Это свойство определяет значение оттенка, которое добавляется к исходному значению оттенка.
Значение изменяется от -1.0 (уменьшение) до 1.0 (увеличение). По умолчанию свойство установлено в 0.0 (без изменений).
| Примеры выходных данных с различными значениями оттенка | ||
|---|---|---|
| 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: -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: -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.14/qml-qtgraphicaleffects-huesaturation.html