Тип QML Colorize

Устанавливает цвет в цветовом пространстве HSL. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• cached : bool
• hue : real
• lightness : real
• saturation : real
• source : variant

Подробное описание

Эффект аналогичен тому, что происходит, когда на сверху серого изображения помещается цветное стекло. Colorize использует цветовое пространство оттенок, насыщенность и светлота (HSL). Вы можете указать желаемое значение для каждого свойства. Вы можете сдвинуть все значения HSL с помощью эффекта HueSaturation.

В качестве альтернативы вы можете использовать эффект ColorOverlay, чтобы окрасить исходный элемент в цветовом пространстве RGBA.

Примечание: Этот эффект доступен при работе с 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
    }

    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, что производит слегка красный цвет.

lightness : real

Это свойство определяет, насколько увеличивается или уменьшается значение светлоты источника.

В отличие от свойств оттенка и насыщенности, светлота не устанавливает используемое значение, а сдвигает существующее значение светлоты пикселя источника.

Значение находится в диапазоне от -1,0 (уменьшение) до 1,0 (увеличение). По умолчанию свойство установлено в 0.0 (без изменений).

saturation : real

Это свойство определяет значение насыщенности, используемое для окрашивания источника.

Значение находится в диапазоне от 0,0 (обесцвеченный) до 1,0 (насыщенный). По умолчанию свойство установлено в 1.0 (насыщенный).

source : variant

Это свойство определяет элемент источника, который предоставляет пиксели источника для эффекта.

Примечание: Не поддерживается включение эффекта в себя, например, путем установки источника в родительский элемент эффекта.