Spec-Zone.ru › Qt 5.15

Тип QML GammaAdjust

Изменяет яркость исходного элемента. Подробнее...

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

Элемент

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

Свойства

  • cached : bool
  • gamma : real
  • source : variant

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

GammaAdjust применяется к каждому пикселю в соответствии с предварительно определенной кривой степенной зависимости, где свойство gamma используется в качестве обратного экспоненциального коэффициента масштабирования. Дополнительные сведения см. в документации по свойству gamma.

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

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

    GammaAdjust {
        anchors.fill: bug
        source: bug
        gamma: 0.45
    }
}

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

cached : bool

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

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

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

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

gamma : real

Это свойство определяет коэффициент изменения, определяющий, как яркость каждого пикселя изменяется в соответствии со следующим уравнением:

luminance = pow(original_luminance, 1.0 / gamma); // The luminance is assumed to be between 0.0 and 1.0

Установка значений gamma ниже 1.0 затемняет изображение, значения выше 1.0 осветляют его.

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

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

gamma: 0.5 gamma: 1.0 gamma: 2.0
Кривые яркости пикселей на изображениях выше.

Красная кривая: стандартная гамма (1.0)
Желтая кривая: примененный эффект
Ось X: исходная яркость пикселя
Ось Y: яркость пикселя с применённым эффектом

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-gammaadjust.html

Spec-Zone.ru

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