Spec-Zone.ru › Qt 5.14

Тип QML HueSaturation

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

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

Элемент

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

Свойства

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

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

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

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

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

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

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

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

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: -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: -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.14/qml-qtgraphicaleffects-huesaturation.html

Spec-Zone.ru

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