このページでは

SCurveTonemap QML Type

トーンマッピング効果。詳細...

Import Statement: import QtQuick3D.Effects 6.11
Status: Deprecated since 6.5

この型はQtQuick3D.Effects 6.5から非推奨となりました。新しいコードでは使用しないことを強くお勧めします。

プロパティ

詳細説明

代わりにExtendedSceneEnvironment を使用する。

警告 QtQuick3D.Effectsに含まれるすべてのプリメイドスタンドアロンエフェクトは、Qt 6.5から非推奨とされています。トーンマッピングを制御するには、代わりにExtendedSceneEnvironment を使用してください。

S字カーブのトーンマップ効果を示すシーンの比較

SCurveTonemap エフェクトは、S字カーブに従って Scene の各ピクセルの輝度をマッピングします:

S字カーブのトーンマップ機能を示すグラフ

カーブには3つの部分があります。カーブには3つの部分があり、つま先の部分はシャドウを決定し、toeSlopetoeEmphasis によって制御されます。中央部分は全体のコントラストを決定し、contrastBoost によって変更されます。肩の部分はハイライトを決定し、shoulderSlopeshoulderEmphasis によって制御されます。

プロパティ・ドキュメンテーション

contrastBoost : real

トーンマップの全体的なコントラストを強めたり弱めたりします。S字カーブの中間部分の傾きを変える。

範囲は[-1...2] 。デフォルト値は0

exposureValue : real

トーンマップ効果の露出を指定する。この値はuseExposuretrue の場合のみ使用されます。範囲は[0.01...16] です。デフォルト値は1 です。

gammaValue : real

トーンマップ効果のガンマ値を設定します。適切な値は[0.1...8] の範囲です。デフォルト値は2.2 です。

saturationLevel : real

トーンマップ効果の全体的な彩度レベルを設定します。範囲は[0...2] で、0 は完全なグレースケール、2 は非常に過飽和です。デフォルト値は1 です。

shoulderEmphasis : real

S字カーブのショルダー部分の形状を変更する。範囲は[-1...1] 。デフォルト値は0

shoulderSlopeも参照

shoulderSlope : real

S字カーブのショルダー部分の傾きを設定します。ショルダーは、ハイライトがコントラストを失う場所を定義します。

設定範囲は[0...3] 。デフォルト値は1

shoulderEmphasisも参照してください

toeEmphasis : real

S字カーブのつま先部分の形状を変更する。範囲は[-1...1] 。デフォルト値は0

toeSlopeも参照

toeSlope : real

S字カーブのつま先部分の傾きを設定する。つま先は、影がコントラストを失う場所を定義します。

設定範囲は[0...3] 。デフォルト値は1

toeEmphasisも参照。

useExposure : bool

輝度計算にexposureValue ではなくwhitePoint を使用するようにします。デフォルト値はfalse です。

whitePoint : real

トーンマップの白色点を設定します。この値はuseExposurefalse の場合のみ使用されます。範囲は[0.01...128] です。デフォルト値は1 です。

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