SkyMaterial QML Type

プロシージャルな空をレンダリングし、画像ベースの照明データを生成します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• enableIBL : bool (since 6.12)
• fragmentShader : url (since 6.12)
• fragmentShaderCode : string (since 6.12)
• iblRenderFrames : int (since 6.12)
• iblSampleCount : int (since 6.12)
• radianceMapSize : int (since 6.12)
• skyboxMode : enumeration (since 6.12)

詳細な説明

SkyMaterialは、カスタムフラグメントシェーダーコードを使用して、空の環境をキューブマップとしてレンダリングします。生成されたキューブマップは、必要に応じてフィルタリングを行い、物理ベースレンダリング用の画像ベースライティング（IBL）として使用することができます。

このシェーダーはキューブマップの6つの面すべてに対して評価され、任意のプロシージャルな空、グラデーション、または解析モデルを実装することができます。

生成されたキューブマップは、可視シーンの背景として、また有効になっている場合はイメージベースライティングのソースとしても使用されます。

シェーダー

シェーダーは、組み込み変数qt_eyeDir (vec3) にアクセスできます。この変数は、キューブマップの中心から現在のサンプル方向への、正規化されていない方向ベクトルを提供します。

フラグメントシェーダーは、MAIN() エントリーポイントを定義する必要があります。このエントリーポイントは、キューブマップのレンダリング中に生成される各フラグメントに対して実行されます。

最終的なピクセルカラーは、フラグメントシェーダーの出力変数であるFRAGCOLOR (vec4) に書き込まなければなりません。

最小限のシェーダー例：

void MAIN()
{
    vec3 dir = normalize(qt_eyeDir);

    // Output color (encoded direction as RGB)
    FRAGCOLOR = vec4(dir * 0.5 + 0.5, 1.0);
}

SkyMaterialで宣言されたカスタムQMLプロパティは、フラグメントシェーダー内で自動的にユニフォームとして公開されます。プロパティ名はGLSLの変数名と一致している必要があります。明示的なユニフォーム宣言は不要です。

以下の型マッピングがサポートされています：

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

enableIBL : bool [default: true, since 6.12]

生成されたスカイクーブマップを画像ベースのライティングに使用するかどうかを指定します。

有効にすると、エンジンは、物理ベースレンダリングにおけるアンビエントライティングや反射に使用される、フィルタリング済みのラディアンスマップおよびイラディアンスマップを生成します。

無効の場合、空は視覚的な背景としてのみレンダリングされ、IBLの前処理は行われません。

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

「SceneEnvironment::lightProbe」も参照してください 。

fragmentShader : url [since 6.12]

ファイルまたはリソースURLから読み込まれたフラグメントシェーダーを指定します。

fragmentShaderとfragmentShaderCode の両方が設定されている場合、fragmentShaderCode が優先されます。

シェーダーが指定されていない場合は、組み込みのデバッグ用シェーダーが使用されます。

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

fragmentShaderCodeも参照してください 。

fragmentShaderCode : string [since 6.12]

インラインのフラグメントシェーダーのソースコードを指定します。

これは `fragmentShader ` と同様の動作をし、同じ実行モデル、組み込み関数、およびプロパティからユニフォームへの自動マッピングを使用します。

fragmentShader と fragmentShaderCode の両方が設定されている場合、このプロパティが優先されます。

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

fragmentShaderも参照してください 。

iblRenderFrames : int [default: 0, since 6.12]

IBLプリフィルターの処理が各フレームにどのように割り振られるかを制御します。

• 0— すべてを1つのフレームに収める：サンプルの蓄積、正規化、および放射照度はすべて同じフレーム内で評価される。
• N ≥ 1—iblSampleCount のサンプルはN個のスライスフレーム（1フレームあたりceil(iblSampleCount / N) サンプル）に分割され、その後、専用の正規化および放射照度フレームが続きます。

値が大きいほど、GGX プリフィルターのコストがより多くのフレームに分散されます。これは、空の変化が頻繁ではなく、画質のために高いiblSampleCount が必要な場合に有用です。

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

「 iblSampleCount 」および「enableIBL 」も参照してください 。

iblSampleCount : int [default: 32, since 6.12]

フィルタ処理された放射輝度マップの出力テクセルごとに評価されるGGX重要度サンプルの総数。この値を大きくすると、太陽の円盤などの高周波数成分におけるシマリングが軽減されますが、その代わりに生成時間が長くなります。

値は [1, 1024] の範囲にクリップされます。

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

「 iblRenderFrames 」および「enableIBL 」も参照してください 。

radianceMapSize : int [default: 512, since 6.12]

画像ベースのライティングおよび反射プローブに使用される、生成された環境キューブマップの解像度を指定します。

値を高く設定すると、特に光沢のあるマテリアルにおいて、反射の鮮明さやライティングの品質が向上しますが、メモリ使用量とレンダリングコストが増加します。

値は最も近い 2 の累乗にスナップされ、[8, 2048] の範囲にクリップされます。

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

skyboxMode およびenableIBLも参照してください 。

skyboxMode : enumeration [default: SkyMaterial.Cubemap, since 6.12]

SkyMaterial が可視背景として生成する内容を選択します。

ScreenSpace モードは、可視背景をIBLキューブから切り離すもので、動的な空（例：動く太陽、アニメーション化されたボリュームクラウド）に最適です。Cubemap は静的な空に最適です。Cubemap は、enableIBL がfalse の場合でも、キューブマップの生成を強制します。

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

radianceMapSize およびenableIBLも参照してください 。