Тип QML Colorize
Устанавливает цвет в цветовом пространстве HSL. Подробнее...
| Оператор импорта: | import QtGraphicalEffects 1.0 |
| С момента: | QtGraphicalEffects 1.0 |
| Наследует: |
Свойства
- cached : bool
- hue : real
- lightness : real
- saturation : real
- source : variant
Подробное описание
Эффект похож на то, что происходит, когда цветное стекло помещено поверх градации изображения. Colorize использует цветовое пространство оттенок, насыщенность и светлота (HSL). Вы можете указать желаемое значение для каждого свойства. Вы можете сместить все значения HSL с помощью эффекта HueSaturation.
В качестве альтернативы, можно использовать эффект ColorOverlay для окраски исходного элемента в цветовом пространстве RGBA.
| Исходник | Применённый эффект |
|---|---|
Примечание: Этот эффект доступен при работе с 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
}
Colorize {
anchors.fill: bug
source: bug
hue: 0.0
saturation: 0.5
lightness: -0.2
}
} Документация по свойствам
cached : bool
Это свойство позволяет кэшировать выходные пиксели эффекта для повышения производительности рендеринга.
При каждом изменении источника или свойств эффекта пиксели в кэше должны быть обновлены. Потребление памяти увеличивается, так как для хранения выходных данных эффекта требуется дополнительный буфер памяти.
Рекомендуется отключить кэширование, когда источник или свойства эффекта анимированы.
По умолчанию свойство установлено в false.
hue : real
Это свойство определяет значение оттенка, используемое для окрашивания источника.
Значение изменяется от 0,0 до 1,0. По умолчанию свойство установлено в 0.0, что создаёт слегка красный цвет.
| Допустимые значения оттенка |
|---|
| Примеры выходных данных с разными значениями оттенка | ||
|---|---|---|
| hue: 0.2 | hue: 0.5 | hue: 0.8 |
| saturation: 1 | saturation: 1 | saturation: 1 |
| lightness: 0 | lightness: 0 | lightness: 0 |
lightness : real
Это свойство определяет, насколько значение светлоты источника увеличивается или уменьшается.
В отличие от свойств оттенка и насыщенности, светлота не устанавливает используемое значение, а смещает существующее значение светлоты пикселя источника.
Значение изменяется от -1,0 (уменьшено) до 1,0 (увеличено). По умолчанию свойство установлено в 0.0 (без изменений).
| Примеры выходных данных с разными значениями светлоты | ||
|---|---|---|
| lightness: -0.75 | lightness: 0 | lightness: 0.75 |
| hue: 0 | hue: 0 | hue: 0 |
| saturation: 1 | saturation: 1 | saturation: 1 |
saturation : real
Это свойство определяет значение насыщенности, используемое для окрашивания источника.
Значение изменяется от 0,0 (обесцвеченный) до 1,0 (насыщенный). По умолчанию свойство установлено в 1.0 (насыщенный).
| Примеры выходных данных с разными значениями насыщенности | ||
|---|---|---|
| saturation: 0 | saturation: 0.5 | saturation: 1 |
| 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-colorize.html