GammaAdjust QML Type

ソースアイテムの輝度を変更します。詳細...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

プロパティ

詳細説明

GammaAdjust は、あらかじめべき乗式として定義された曲線に従って各ピクセルに適用されます。詳細については、gamma のプロパティドキュメントを参照してください。

ソース適用される効果

次の例は、効果を適用する方法を示しています。

import QtQuick
import Qt5Compat.GraphicalEffects

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

ガンマ値を 1.0 未満に設定するとイメージは暗くなり、1.0 を超えると明るくなります。

値の範囲は0.0(最も暗い)からinf(最も明るい)までです。デフォルトでは、このプロパティは1.0 (変化なし)に設定されています。

ガンマ値を変えた出力例

ガンマ値:0.5 gamma: 1.0 ガンマ: 2.0
上の画像のピクセル輝度カーブ。

赤いカーブ:デフォルトのガンマ(1.0)
黄色のカーブ:エフェクト適用
X軸:ピクセルの元の輝度
Y 軸:効果を適用したピクセル輝度

source : variant

このプロパティは、輝度を調整するソースアイテムを定義する。

注意: 例えば source をエフェクトの親に設定することで、エフェクトがそれ自身を含むようにすることはサポートされていません。


©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。