Тип 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 в родительский элемент эффекта.