Тип QML Colorize

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

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

Свойства

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

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

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

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

Пример

В следующем примере показано, как применить эффект.

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