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

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

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

• 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 のソースコードに変換されます。詳細はQtShader Toolsモジュールのドキュメントを参照してください。

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

グラフィックスAPIの選択

Qt Quick 3D は、レンダリングやウィンドウを独自に初期化するのではなく、QQuickWindow かQQuickView かWindow QML タイプに依存するため、Qt Quick Scene Graphに適用されるグラフィックス 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以外のグラフィックスAPIが使用されている場合には何の効果もありませんが、APIがOpenGLである場合には、Qt Quick 3Dのニーズに最適なOpenGLコンテキストを作成することにつながるため、非常に有益です。

OpenGL ES 2.0サポート

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

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