Тип QML Colorize

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

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

Свойства

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

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

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

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

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

lightness : вещественное

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

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

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

saturation : вещественное

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

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

source : variant

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

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