Spec-Zone.ru › Qt 5.11

Тип QML HueSaturation

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

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

Элемент

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

Свойства

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

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

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

Источник Примененный эффект

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

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

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

cached : bool

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

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

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

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

hue : real

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

Значение изменяется в диапазоне от -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

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

Значение изменяется в диапазоне от -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

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

Значение изменяется в диапазоне от -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/archives/qt-5.11/qml-qtgraphicaleffects-huesaturation.html

Spec-Zone.ru

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