このページでは

GammaAdjust QML Type

ソース項目の輝度を変更します。詳細...

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

Item

プロパティ

詳細な説明

GammaAdjust は、事前にべき乗則の式として定義された曲線に従って各ピクセルに適用されます。この際、プロパティ「gamma」がスケーリング指数(逆数)として使用されます。詳細については、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

通常ガンマ線下でのカブトムシ

輝きを放つ甲虫、ガンマ 2.0

gamma: 0.5 gamma: 1.0 gamma: 2.0
上記の画像のピクセル輝度曲線。

ガンマ 0.5 における輝度曲線

ガンマ 1.0 の輝度曲線

ガンマ 2.0 の輝度特性曲線

赤い曲線:デフォルトのガンマ (1.0)
黄色の曲線:エフェクト適用後
X 軸:ピクセルの元の輝度
Y軸:エフェクト適用後のピクセル輝度

source : variant

このプロパティは、輝度を調整する対象となるソース項目を定義します。

注: エフェクトをその親に設定するなどして、エフェクト自体をソースに含めることはサポートされていません。

© 2026 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.