Тип 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

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

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