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

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

Qt Quick 3D機能は、Qt 6.0のQt Quick がサポートするすべてのグラフィックスAPIおよびシェーディング言語での動作に対応しています。場合によっては、特にOpenGLおよびOpenGL ESにおいて、Qt Quick の3D機能では、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 ソースコードに変換されます。詳細については、Qt XML のShader Toolsモジュールのドキュメントを参照してください。

Qt Quick 3Dは、上記のグラフィックスAPIのいずれとも直接連携しません。むしろ、Qt Quick と同様に、Qt Rendering Hardware Interfaceの抽象化機能を使用します。

グラフィックスAPIの選択

Qt Quick 3Dは、レンダリングやウィンドウを独自に初期化せず、QQuickWindow やQQuickView 、あるいはWindow というQMLタイプに依存しているため、Qt Quick のシーングラフに適用されるグラフィックスAPIの選択に関するすべての事項は、Qt Quick 3Dにも同様に適用されます。以下に挙げる特定の環境変数を設定することで、シーングラフの動作を制御することが可能です。

常に特定の単一のグラフィックスAPIで実行したいアプリケーションは、C++だけでなく、QSG_RHI_BACKEND 環境変数を通じてこれを指定できます。たとえば、main() の初期段階で、QQuickWindow を構築する前に以下の呼び出しを行うと、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 機能に依存するシェーダーを使用するカスタムマテリアル
• 順序非依存透過