Spec-Zone.ru › Qt 5.11

Тип QML Colorize

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

Оператор импорта: import QtGraphicalEffects 1.0
С момента: QtGraphicalEffects 1.0
Наследует:

Элемент

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

Свойства

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

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

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

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

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

Допустимые значения оттенка

Примеры выходных данных с разными значениями оттенка

hue: 0.2 hue: 0.5 hue: 0.8
saturation: 1 saturation: 1 saturation: 1
lightness: 0 lightness: 0 lightness: 0

lightness : real

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

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

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

Примеры выходных данных с разными значениями светлоты

lightness: -0.75 lightness: 0 lightness: 0.75
hue: 0 hue: 0 hue: 0
saturation: 1 saturation: 1 saturation: 1

saturation : real

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

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

Примеры выходных данных с разными значениями насыщенности

saturation: 0 saturation: 0.5 saturation: 1
hue: 0 hue: 0 hue: 0
lightness: 0 lightness: 0 lightness: 0

source : variant

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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qml-qtgraphicaleffects-colorize.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API