Spec-Zone.ru › Qt 5.15

Тип QML HueSaturation

Изменяет цвета исходного элемента в цветовом пространстве HSL. Подробнее...

Заявление об импорте: import QtGraphicalEffects 1.15
С момента: QtGraphicalEffects 1.0
Наследует:

Элемент

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

Свойства

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

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

HueSaturation похож на эффект Colorize, но значения свойств hue и saturation обрабатываются по-разному. Эффект HueSaturation всегда смещает hue, saturation и lightness от исходных значений, а не устанавливает их.

Исходный элемент Примененный эффект

Примечание: Этот эффект доступен при работе с 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
    }

    HueSaturation {
        anchors.fill: bug
        source: bug
        hue: -0.3
        saturation: 0.5
        lightness: -0.1
    }
}

Документация свойств

cached : bool

Это свойство позволяет кэшировать выходные пиксели эффекта для повышения производительности рендеринга.

Каждый раз, когда изменяются свойства source или effect, пиксели в кэше должны быть обновлены. Потребление памяти увеличивается, так как требуется дополнительный буфер памяти для хранения выходных данных эффекта.

Рекомендуется отключить кэш, когда свойства source или effect анимированы.

По умолчанию свойство установлено в false.

hue : real

Это свойство определяет значение hue, которое добавляется к значению hue исходного элемента.

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

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

hue: -0.3 hue: 0.0 hue: 0.3
saturation: 0 saturation: 0 saturation: 0
lightness: 0 lightness: 0 lightness: 0

lightness : real

Это свойство определяет значение lightness, которое добавляется к значению saturation исходного элемента.

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

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

lightness: -0.5 lightness: 0.0 lightness: 0.5
hue: 0 hue: 0 hue: 0
saturation: 0 saturation: 0 saturation: 0

saturation : real

Это свойство определяет значение saturation, которое добавляется к значению saturation исходного элемента.

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

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

saturation: -0.8 saturation: 0.0 saturation: 1.0
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/qt-5.15/qml-qtgraphicaleffects-huesaturation.html

Spec-Zone.ru

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