ExtendedSceneEnvironment QML Type

SceneEnvironment よく使われるレンダリング効果を提供する。詳細...

• 継承されたメンバを含む、すべてのメンバのリスト

プロパティ

• adjustmentBrightness : real
• adjustmentContrast : real
• adjustmentSaturation : real
• colorAdjustmentsEnabled : bool
• depthOfFieldBlurAmount : real
• depthOfFieldEnabled : bool
• depthOfFieldFocusDistance : real
• depthOfFieldFocusRange : real
• ditheringEnabled : bool
• exposure : real
• fxaaEnabled : bool
• glowBlendMode : int
• glowBloom : real
• glowEnabled : bool
• glowHDRMaximumValue : real
• glowHDRMinimumValue : real
• glowHDRScale : real
• glowIntensity : real
• glowLevel : int
• glowQualityHigh : bool
• glowStrength : real
• glowUseBicubicUpscale : bool
• lensFlareApplyDirtTexture : bool
• lensFlareApplyStarburstTexture : bool
• lensFlareBloomBias : real
• lensFlareBloomScale : real
• lensFlareBlurAmount : real
• lensFlareCameraDirection : vector3d
• lensFlareDistortion : real
• lensFlareEnabled : bool
• lensFlareGhostCount : int
• lensFlareGhostDispersal : real
• lensFlareHaloWidth : real
• lensFlareLensColorTexture : Texture
• lensFlareLensDirtTexture : Texture
• lensFlareLensStarburstTexture : Texture
• lensFlareStretchToAspect : real
• lutEnabled : bool
• lutFilterAlpha : real
• lutSize : real
• lutTexture : Texture
• sharpnessAmount : real
• ssgiBufferSizeFactor : real (since 6.11)
• ssgiEnabled : bool (since 6.11)
• ssgiHitThickness : real (since 6.11)
• ssgiIndirectLightBoost : real (since 6.11)
• ssgiIndirectLightEnabled : bool (since 6.11)
• ssgiSampleCount : int (since 6.11)
• ssgiSampleRadius : real (since 6.11)
• ssgiSimulatedBounceEnabled : bool (since 6.11)
• ssgiSimulatedBounceFactor : real (since 6.11)
• ssgiSliceCount : int (since 6.11)
• ssrEnabled : bool (since 6.11)
• tonemapMode : enumeration
• vignetteColor : color
• vignetteEnabled : bool
• vignetteRadius : real
• vignetteStrength : real
• whitePoint : real

詳しい説明

ExtendedSceneEnvironment はQtQuick3D のSceneEnvironment タイプを拡張したもので、よく使われるエフェクトのコレクションが組み込まれている。エフェクトは、コントロールするエフェクトの名前を先頭に持つプロパティのセットを通して公開されます。

これらのエフェクトを 1 つ以上有効にすると、SceneEnvironment のeffects リストに後処理エフェクトを手動で追加するのと同様の結果が得られます。しかし、ExtendedSceneEnvironment は、スタンドアロンでは利用できないエフェクトを提供し、さらに重要な点として、有効化されたエフェクトを効率的に組み合わせることで、必要な追加のレンダーパスの数を減らし、シーンに個別のポストプロセッシングエフェクトを適用するよりも大幅にパフォーマンスを向上させることができます。ExtendedSceneEnvironmentはまた、より複雑なマルチパスエフェクトや、複数のエフェクトを有効にして一緒に組み合わせた場合でも、トーンマッピングとうまく連携します。これは、スタンドアロンエフェクトでは必ずしもそうではありませんでした。

トーンマッピングなど、SceneEnvironment の一部の機能は継承され、ExtendedSceneEnvironment の追加プロパティで拡張されます。たとえば、SceneEnvironment は、tonemapMode プロパティを提供しますが、ExtendedSceneEnvironment では、トーンマッパの露出、ホワイトポイント、シャープネス、ディザリングの設定も制御できるようになります。ただし、ExtendedSceneEnvironment はSceneEnvironment からすべてを継承するため、tonemapMode プロパティは重複しません。したがって、トーンマッピングモードの基本設定は、View3D にどのタイプの環境が関連付けられていても使用できますが、追加プロパティは ExtendedSceneEnvironment を使用する場合にのみ使用できます。スクリーンスペースアンビエントオクルージョン（SSAO）やフォグなどのその他のエフェクトは、完全にSceneEnvironment の一部であり、どちらのタイプの環境でも使用できます。

ExtendedSceneEnvironment を使い始める

ExtendedSceneEnvironment が提供する追加機能を使用するには、View3D をそのインスタンスに関連付けます。QtQuick3D.Helpers モジュールのインポートを忘れないでください。

import QtQuick3D
import QtQuick3D.Helpers

View3D {
    environment: ExtendedSceneEnvironment {
        tonemapMode: SceneEnvironment.Filmic
        vignetteEnabled: true
        // ...
    }
}

利用可能なエフェクト

以下は、SceneEnvironment から継承された機能を含む、ExtendedSceneEnvironment が提供するエフェクトと関連機能の概要です。

• Tonemapping - 色を表示する前に、高解像度範囲から 0 ～ 1 の範囲にトーンマップする方法を制御します。ExtendedSceneEnvironment は、露出、白色点、シャープネス、ディザリングの制御を追加します。

  tonemapMode,exposure,whitePoint,ditheringEnabled のプロパティで制御します。

  

• Color adjustments - 明るさ、コントラスト、彩度の調整。

  プロパティcolorAdjustmentsEnabled,adjustmentBrightness,adjustmentContrast,adjustmentSaturation によって制御されます。

  

• Color grading ルックアップテーブル（LUT）テクスチャ経由。

  プロパティlutEnabled,lutSize,lutFilterAlpha で制御。

  

• Depth of field

  プロパティdepthOfFieldEnabled,depthOfFieldFocusDistance,depthOfFieldFocusRange,depthOfFieldBlurAmount によって制御されます。

  

• Glow and bloom

  プロパティによって制御されるglowEnabled,glowQualityHigh,glowUseBicubicUpscale,glowStrength,glowIntensity,glowBloom,glowBlendMode,glowHDRMaximumValue,glowHDRMinimumValue,glowHDRScale.

  

• Vignette

  プロパティによって制御されるvignetteEnabled,vignetteStrength,vignetteColor,vignetteRadius.

  

• Lens flare

  プロパティによって制御されるlensFlareEnabled,lensFlareBloomBias,lensFlareGhostDispersal,lensFlareGhostCount,lensFlareHaloWidth,lensFlareStretchToAspect,lensFlareDistortion,lensFlareBlurAmount,lensFlareApplyDirtTexture,lensFlareApplyStarburstTexture,lensFlareCameraDirection,lensFlareLensColorTexture,lensFlareLensDirtTexture,lensFlareLensStarburstTexture.

  

• Screen space ambient occlusion -SceneEnvironment 。SSGI もアンビエント・オクルージョンを提供しており、実際にはそちらの方が質の高い結果が得られることが多い。SceneEnvironment のアンビエントオクルージョンと、ExtendedSceneEnvironment のスクリーン空間グローバルイルミネーションの両方を有効にするのは、不必要で無駄が多いので避けてください。SceneEnvironment::aoEnabled,SceneEnvironment::aoStrength,SceneEnvironment::aoDistance,SceneEnvironment::aoSoftness,SceneEnvironment::aoDither,SceneEnvironment::aoSampleRate,SceneEnvironment::aoBias によって制御されます。

  

• Fog -SceneEnvironment によって提供される。これはポストプロセスタイプのエフェクトではなく、シーン内のレンダリング可能なオブジェクトのマテリアルに適用されます。

  SceneEnvironment::fog プロパティに関連付けられたFog オブジェクトによって制御されます。

  

• Antialiasing - マルチサンプリング、スーパーサンプリング、プログレッシブ・アンチエイリアシング、スペキュラ・アンチエイリアシング、テンポラル・アンチエイリアシングは、SceneEnvironment によって提供されます。ExtendedSceneEnvironment は、a form of FXAA を使用するオプションを追加します。

  FXAAはfxaaEnabled 。その他のアンチエイリアスモードは、SceneEnvironment::antialiasingMode 、SceneEnvironment::temporalAAEnabled 、SceneEnvironment::temporalAAStrength 、SceneEnvironment::specularAAEnabled によって制御されます。

  

• Screen-space global illumination アンビエントオクルージョンと間接照明を提供します。このエフェクトを有効にすると、GPU 負荷とパフォーマ ンスに大きな影響を与える可能性があることに注意してください。プロパティssgiEnabled,ssgiIndirectLightEnabled,ssgiIndirectLightBoost,ssgiBufferSizeFactor,ssgiSimulatedBounceEnabled,ssgiSimulatedBounceFactor,ssgiSampleCount,ssgiSampleRadius,ssgiSliceCount によって制御されます、ssgiHitThickness

  

SceneEnvironment とQt Quick 3D - シーンエフェクトの例も参照してください 。

プロパティのドキュメント

adjustmentBrightness : real [default: 1]

シーンの明るさを調整します。

adjustmentContrast : real [default: 1]

シーンのコントラストを調整します。

adjustmentSaturation : real [default: 1]

シーンの彩度を調整します。

colorAdjustmentsEnabled : bool [default: false]

色調整を有効にする。

colorAdjustmentsEnabledも参照 。

depthOfFieldBlurAmount : real [default: 4.0]

フォーカス範囲外のオブジェクトに適用されるぼかしの量を設定します。適切な値は0から10 の範囲です。値 0 の場合、追加のぼかしは適用されません。

depthOfFieldEnabled : bool [default: false]

被写界深度ぼかし効果を有効にする。

depthOfFieldFocusDistance : real [default: 600]

オブジェクトにフォーカスが合うカメラからの距離を設定します。

ここでは、Sponzaシーンに100 のスケールを適用し、ビューの後ろと前にぼかしを適用するのに適した大きな範囲を持つようにしています。下の写真は、フォーカス距離753、フォーカス範囲482で撮影されています。

depthOfFieldFocusRange : real [default: 100]

depthOfFieldFocusDistance 、ピントが完全に合っている距離。その後、手前側、奥側ともに同じ距離でピントがぼやけ、完全にボケる。

ditheringEnabled : bool [default: false]

バンディング・アーティファクトを低減するディザリングを有効にする。

exposure : real [default: 1.0]

トーンマッパーが使用する露出レベル。

fxaaEnabled : bool [default: false]

高速近似アンチエイリアス（FXAA）を有効にする。

glowBlendMode : int [default: ExtendedSceneEnvironment.GlowBlendMode.SoftLight]

グロー効果のブレンドモード。

使用可能なモードは次のとおりです：

• ExtendedSceneEnvironment.GlowBlendMode.Additive
• ExtendedSceneEnvironment.GlowBlendMode.Screen
• ExtendedSceneEnvironment.GlowBlendMode.SoftLight
• ExtendedSceneEnvironment.GlowBlendMode.Replace

Additive は、空や太陽が見えるような屋外のシーンで推奨されることが多いのですが、屋内環境ではデフォルトのSoftLight 。

Replace.GlowBlendMode.Replaceはブレンディングを実行せず、グロー/ブルーム効果が実際のコンテンツとブレンドされる寄与のみを表示します。実際には、グロー/ブルーム効果のパラメータを設定する際の実験やトラブルシューティングに役立ちます。

glowBloom : real [default: 0]

グロー効果に適用されるブルームの量を設定します。0から1の値が想定される。

glowHDRMinimumValue,glowHDRMaximumValue,glowHDRScale, glowBloom の各値は、グロー／ブルーム効果によって生成されるluminance feedback の量を制御する。

実際には、glowStrength 、glowIntensity 、glowBloomの値は、しばしば望ましい結果を達成するために一緒に調整されます。

例えば、4つのグロー・レベルが有効で、強さが1.5、強度が1である場合：

glowEnabled : bool [default: false]

グロー効果を有効にする。また、glowBloom の値が 0 より大きい場合、ブルームを与えることもできる。

glowHDRMaximumValue : real [default: 12.0]

グローの最大輝度をハイダイナミックレンジで設定する。値の範囲は0～256。

glowHDRMinimumValue 、glowHDRMaximumValue、glowHDRScale 、およびglowBloom 値は、グロー／ブルーム効果によって生成されるluminance feedback の量を一緒に制御する。

glowHDRMinimumValue : real [default: 1.0]

光芒の最小輝度をハイダイナミックレンジで設定する。期待される値は0から 4の範囲である。

glowHDRMinimumValue、glowHDRMaximumValue 、glowHDRScale 、glowBloom の各値は、グロー／ブルーム効果によって生成されるluminance feedback の量を制御する。

glowHDRScale : real [default: 2.0]

HDRグローのブリードスケール。期待される値は0から 8の範囲です。

glowHDRMinimumValue,glowHDRMaximumValue, glowHDRScale, andglowBloom values together control the amount ofluminance feedback generated by the glow/bloom effect.

glowIntensity : real [default: 1]

グロー強度。期待される値は0から 8の範囲である。

intensityは事実上、累積されたグロー・カラー（すべてのレベルを含む）のスケール・ファクター（乗数）である。

実際には、glowStrength 、glowIntensity、glowBloom の値は、しばしば望ましい結果を得るために一緒に調整されます。

例えば、glowStrength 1.0、glowBloom 0.25：

glowLevel : int [default: 1]

どのブラーパスがグロー効果に適用されるかを設定します。全部で7つのレベルがあります。

どのレベルも設定されていない場合、グローの視覚効果はありません。

例えば、グローレベル1と 6を有効にするには、2つの列挙型をORするだけです：

glowLevel = (ExtendedSceneEnvironment.GlowLevel.One | ExtendedSceneEnvironment.GlowLevel.Six)

glowQualityHigh : bool [default: false]

グロー効果の品質を向上させるために、ダウンサンプリング時にグローに使用するサンプルを増やします。

glowStrength : real [default: 1]

グローの強さ。使用可能な値は0から 2まで。

この強さは事実上、レベルごとに適用されるスケールファクター（乗数）である。つまり、glowLevel で有効になっているレベルが多ければ多いほど、glowStrength が大きいほど効果が顕著になります。

実際には、glowStrength、glowIntensity 、glowBloom の値は、多くの場合、望ましい結果を得るために一緒に調整される。

例えば、glowIntensity が1.0、glowBloom が0.25、最初の4つのレベルが有効な場合：

glowUseBicubicUpscale : bool [default: false]

エイリアシング・アーティファクトを低減し、グロー効果をボックス化する。

lensFlareApplyDirtTexture : bool [default: false]

レンズフレアに汚れテクスチャを適用するかどうかを設定します。

lensFlareLensDirtTextureも参照してください 。

lensFlareApplyStarburstTexture : bool [default: false]

レンズフレアにスターバーストテクスチャを適用するかどうかを設定します。

lensFlareLensStarburstTextureも参照してください 。

lensFlareBloomBias : real [default: 0.95]

レンズフレア・ブルームを開始するレベルを設定する。

バイアス値はハイダイナミックレンジのカラー値から差し引かれ、結果は0にクランプされる。つまり、シーンによっては、レンズフレアを目立たせるために、かなり低い値、例えば1以下に設定する必要がある場合がある。そのため、デフォルトは0.95となっている。一方、色の範囲が広い場合は、より大きな値がより理にかなっているかもしれません。

lensFlareBloomScale : real [default: 10]

レンズフレア・ブルーム効果のスケールを設定します。期待されるスケール値の範囲は0から20。

実際には、lensFlareBloomBias を差し引いたゼロクランプのカラー値の乗数として機能します。

lensFlareBlurAmount : real [default: 3]

レンズフレアに適用するぼかしの量を設定します。0〜50の範囲で設定可能。

lensFlareCameraDirection : vector3d [default: Qt.vector3d(0, 0, -1)]

シーン内のカメラの方向を設定します。

lensFlareDistortion : real [default: 5]

レンズフレアの色収差量を設定する。期待される値の範囲は0～20です。

lensFlareEnabled : bool [default: false]

レンズフレア効果を有効にします。

有効にすると、最初に調整するプロパティは通常lensFlareBloomBias です。

lensFlareGhostCount : int [default: 4]

レンズフレアのゴーストの量を設定します。設定可能な値は0～20です。

lensFlareGhostDispersal : real [default: 0.5]

レンズフレアのゴースト間の距離を設定します。期待される値は0から 5の間です。値は0より大きくする必要があります。

lensFlareHaloWidth : real [default: 0.25]

レンズフレアのハロの大きさを設定する。0〜1の範囲で設定可能。

lensFlareLensColorTexture : Texture

レンズフレアのレンズカラーに使用されるグラデーション画像。

デフォルトでは256x256のテクスチャが使用されます：

lensFlareLensDirtTexture : Texture

レンズの欠点をシミュレートするための画像。

lensFlareApplyDirtTexture が有効な場合のみ効果があります。

デフォルトでは、内蔵のダーティテクスチャが使用されます：

lensFlareLensStarburstTexture : Texture

レンズフレアのスターバースト効果を補強するノイズ画像。lensFlareApplyStarburstTexture が有効な場合のみ効果があります。

デフォルトでは内蔵ノイズテクスチャが使用されます：

lensFlareStretchToAspect : real [default: 0.5 [0, 1]]

レンズのフレアハローの丸みの補正係数を設定する。

lutEnabled : bool [default: false]

ルックアップテーブル（LUT）を使ったカラーグレーディングを可能にする。ルックアップテーブルはテクスチャとして与えられます。

lutFilterAlpha : real [default: 1]

シーンに混ぜるカラーグレーディングの量を設定する。値は0から 1の間であることが期待される。

lutSize : real [default: 16]

LUTテクスチャのサイズを設定します。テクスチャは寸法を持つ必要があります：

width = lutSize * lutSize とheight = lutSize

lutTexture : Texture

ルックアップ・テクスチャのソース。テクスチャが設定されていない場合は、ビルトインのIDテーブルが使用されます。

下の写真は256x16のサイズのテクスチャの例で、デフォルトのlutSize 16と一致しています。

このエフェクトの結果：

sharpnessAmount : real [default: 0.0]

シャープネス量を設定します。有効な値は0.0 (オフ) から1.0 (フル) です。

ssgiBufferSizeFactor : real [default: 0.5, since 6.11]

SSGI エフェクトが動作するカラーバッファのサイズを制御します。入力と出力の寸法（すなわち、View3D'のピクセルサイズ）に一致するレンダーターゲットですべてを実行することは、多くの GPU とデバイスが実際には余裕がないコストがかかりすぎることがあります。したがって、SSGI 効果は中間テクスチャのサイズを縮小して動作します。デフォルトでは、これは 0.5 で、入力と出力テクスチャの半分のサイズを意味します。この値を 1 に上げると、GPU の負荷が大きくなる代わりに、結果の品質が向上します。

このプロパティは Qt 6.11 で導入されました。

ssgiEnabled : bool [default: false, since 6.11]

スクリーン空間のグローバルイルミネーションを有効にします。このエフェクトは、シーンにアンビエントオクルージョンと間接光を追加することで、リアリズムを向上させます。

このプロパティは Qt 6.11 で導入されました。

Qt Quick 3D - SSGI Lightmap Exampleも参照してください 。

ssgiHitThickness : real [default: 0.5, since 6.11]

グローバルイルミネーションアルゴリズムを設定する。

推奨範囲は 0.001 から 4.0 です。

このプロパティは Qt 6.11 で導入されました。

ssgiIndirectLightBoost : real [default: 4.0, since 6.11]

間接光の結果の乗数。値を大きくすると、間接光の寄与がより顕著になる。推奨範囲は1～100です。適切な値は、常にシーンとその光の当て方に依存します。

このプロパティは Qt 6.11 で導入されました。

ssgiIndirectLightEnabled : bool [default: true, since 6.11]

間接光を結果に含めるか、アンビエントオクルージョンのみを含めるかを制御します。デフォルトでは両方が有効です。

この値を false に設定すると、SceneEnvironment のambient occlusion に直接代替できます。SSGIによって提供されるAO結果は、より高品質で、チューニングをほとんど必要としないことが期待されます。これは GPU 負荷が高くなる可能性があるという犠牲を伴います。

このプロパティは Qt 6.11 で導入されました。

ssgiSampleCount : int [default: 4, since 6.11]

グローバルイルミネーションアルゴリズムを設定します。サンプル数を多くすると、GPU負荷が増加する代償として、より良い結果が得られます。

推奨範囲は 1 から 16 です。

このプロパティは Qt 6.11 で導入されました。

ssgiSampleRadius : real [default: 0.1, since 6.11]

グローバルイルミネーションアルゴリズムを設定する。

推奨範囲は 0.001 から 4.0 です。

このプロパティは Qt 6.11 で導入されました。

ssgiSimulatedBounceEnabled : bool [default: false, since 6.11]

前のフレームのテクスチャをサンプリングして、追加の光の跳ね返りをシミュレートするかどうかを制御します。

このプロパティは Qt 6.11 で導入されました。

ssgiSimulatedBounceFactor : real [default: 0.5, since 6.11]

バウンスのシミュレーション計算結果の乗数。ssgiSimulatedBounceEnabled がtrue の場合のみ効果があります。この値は、ssgiIndirectLightBoost と一緒に調整する必要がある場合があります。シーンとその照明方法によっては、これらのプロパティの値を大きくすると、間接光の寄与が過度に誇張され、フレーム間で間接光が過度に大きくなるフィードバックループが発生する可能性もあります。

このプロパティは Qt 6.11 で導入されました。

ssgiSliceCount : int [default: 4, since 6.11]

グローバルイルミネーションアルゴリズムを設定します。

推奨範囲は 1 から 8 です。

このプロパティは Qt 6.11 で導入されました。

ssrEnabled : bool [default: false, since 6.11]

スクリーン上にレンダリングされたデータを使用して反射を作成するポスト処理技術である、スクリーン空間反射を有効にします。

このプロパティは Qt 6.11 で導入されました。

tonemapMode : enumeration [default: SceneEnvironment.TonemapModeLinear]

このプロパティは、レンダリング前に色がどのようにトーンマップされるかを定義します。Qt Quick 3D のすべてのレンダリングは線形色空間で実行されるため、多くの場合、表示不可能な色値が生成される可能性があります。tonemapMode は、色を表示可能な範囲に再マッピングするために使用される手法を決定します。

デフォルト値はSceneEnvironment.TonemapModeLinear

vignetteColor : color [default: "gray"]

ヴィネット効果の色を設定します。

例えば、半径 4、強さ 15 で赤に変更します：

vignetteEnabled : bool [default: false]

ヴィネット効果を有効にする。

vignetteRadius : real [default: 0.35]

ヴィネット効果の半径を設定します。範囲は0から5。

vignetteStrength : real [default: 15]

ヴィネット効果の強さを設定します。0から15 の範囲で設定できます。

whitePoint : real [default: 1]

トーンマッピングが有効な場合の白の基準値。値は0より大きくなければならない。