Spec-Zone.ru › Qt 5.14

Тип QML GammaAdjust

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

Заявление об импорте: import QtGraphicalEffects 1.14
С момента: 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.14/qml-qtgraphicaleffects-gammaadjust.html

Spec-Zone.ru

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