GammaAdjust QML Type
ソース項目の輝度を変更します。詳細...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
プロパティ
詳細な説明
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 (変更なし)に設定されています。
| 異なるガンマ値による出力例 | ||
|---|---|---|
|
|
|
| gamma: 0.5 | gamma: 1.0 | gamma: 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.







