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 をエフェクトの親に設定するなど、エフェクトに自分自身を含めることはサポートされていません。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.