Spec-Zone.ru › Qt 5.13

Тип QML GammaAdjust

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

Заявление об импорте: import QtGraphicalEffects 1.13
С тех пор: 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
Кривые яркости пикселей на изображениях выше.

Красная кривая: значение gamma по умолчанию (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.13/qml-qtgraphicaleffects-gammaadjust.html

Spec-Zone.ru

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