Spec-Zone.ru › Qt 5.12

Тип QML GammaAdjust

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

Заявление об импорте: import QtGraphicalEffects 1.12
С момента: 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

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

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

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

По умолчанию свойство установлено в значение 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.12/qml-qtgraphicaleffects-gammaadjust.html

Spec-Zone.ru

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