Тип QML Colorize

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

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

Свойства

• cached : bool
• hue : вещественное число
• lightness : вещественное число
• saturation : вещественное число
• source : значение

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

Эффект похож на то, что происходит, когда на градационное изображение сверху накладывается цветное стекло. 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 : вещественное число

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

Значение изменяется от 0,0 до 1,0. По умолчанию свойство установлено в 0.0, что дает слегка красный цвет.

lightness : вещественное число

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

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

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

saturation : вещественное число

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

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

source : значение

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

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