Qt Quick 3D グラフィックス要件

サポートされているグラフィックス API、バージョン、シェーディング言語

Qt Quick 3D は、Qt 6.0 の Qt Quick でサポートされているすべてのグラフィック API とシェーディング言語での動作をサポートしています。特にOpenGLとOpenGL ESについては、Qt Quick 3Dの方がQt Quick 3Dよりも必要なバージョンが高い場合があります。

• OpenGL3.0 以上。OpenGL 3.3 以上を強く推奨します。
• OpenGL ES2.0 以上、OpenGL ES 3.0 以上を強く推奨
• Direct3D 11.1
• Direct3D 12
• Vulkan1.0以上
• Metal1.2以上

シェーダパイプラインは Qt 6 の標準的なアプローチに基づいています。Vulkan 互換の GLSL シェーダコードは SPIR-V にコンパイルされ、GLSL、HLSL、MSL のソースコードに変換されます。詳細はQt Shader Toolsモジュールのドキュメントを参照してください。

Qt Quick 3D は上記のグラフィックス API を直接使用しません。むしろ、Qt Quick と同様に Qt Rendering Hardware Interface を使用します。

グラフィックスAPIの選択

Qt Quick 3D はレンダリングやウィンドウを独自に初期化するのではなく、QQuickWindow またはQQuickView またはWindow QML タイプに依存するため、Qt Quick Scene Graphsに適用されるグラフィックス API の選択に関連するすべてが Qt Quick 3D にも適用されます。以下に示す特定の環境変数を設定することで、シーングラフの動作を制御することができます：

常に1つのグラフィックAPIで実行したいアプリケーションは、C++と同様に、QSG_RHI_BACKEND enivronment変数で要求できます。例えば、QQuickWindow を構築する前にmain() の初期に行う次の呼び出しは、Vulkan の使用を強制します（そうしないと失敗します）。

QQuickWindow::setGraphicsApi(QSGRendererInterface::Vulkan);

OpenGL の仕様

Qt Quick 3Dアプリケーションは、main()関数内でQQuick3D::idealSurfaceFormat()を呼び出し、返されたQSurfaceFormat をデフォルトとして使用します：

QSurfaceFormat::setDefaultFormat(QQuick3D::idealSurfaceFormat());

この呼び出しは、OpenGL以外のGraphical APIを使用する場合には何の効果もありませんが、APIがOpenGLの場合には、Qt Quick 3Dのニーズに最適なOpenGLコンテキストを作成することにつながるため、非常に有益です。

OpenGL ES 2.0のサポート

Qt Quick 3D は、OpenGL ES 2.0 での動作をサポートしていますが、機能はかなり制限されています。以下のリストには、使用できなくなる、または機能しなくなる機能の一部が含まれています：

• イメージベースライティング、ライトプローブ、スカイボックス
• シャドウマッピング
• スクリーン空間アンビエントオクルージョン
• マルチサンプリング
• 特定のポストプロセッシングエフェクト
• GLSL ES 100にはないGLSL機能に依存するシェーダーを使用するカスタムマテリアル