Qt 3D レンダリングのヒント

最も単純な形状をレンダリングする場合でも、Qt 3D はいくつかの段階を経て様々な処理を実行する必要があります。これらの段階のいずれかで問題が発生すると、最良の場合でも期待した結果とは異なるものが表示され、最悪の場合は画面が真っ黒になってしまう可能性があります。

• 手法の選択
• 順序が重要
• ブレンディング
• 便利なツール

テクニックの選択

Qt 3D は、さまざまなレンダリングAPIおよびそれらのAPIのバージョンに対応したシェーダーを指定できる、テクニック選択の仕組みを提供します。

不必要な時間の浪費を避けるため、ターゲットとするプラットフォームに対して、テクニークの API フィルタデータが正しいことを確認してください。

順序が重要

レンダラーによって実行されるドローコールの順序は、必ずしもシーン内のエンティティの順序と同じとは限りません。

レンダラーは、グラフィックス API に送信される呼び出しを最適化しようとします。レンダラーは、使用されているマテリアルやシェーダー、特定のマテリアルに対して定義されているレンダリング状態、それらの優先順位、2 つのマテリアル間で共有されているパラメータなどに基づいて、描画呼び出しの順序を決定します。

レンダリングが特定の描画順序に依存する場合は、以下の選択肢が考えられます：

• FrameGraph内でQt3DRender::QLayerコンポーネントとQt3DRender::QLayerFilterを使用したフィルタリング
• FrameGraph 内の Qt3DRender::QRenderPassFilter または Qt3DRender::QTechniqueFilter を使用した RenderPass または Technique フィルタリング

ブレンディング

適切な引数や関数を用いてブレンディングをマスターすることは、それ自体が芸術です。そのため、望ましい視覚的結果を得るには、試行錯誤が必要になることがよくあります。

Anders Riggelsen氏のオンラインビジュアライザーを利用すれば、どの引数や関数が自分に適しているかを見つけるのに役立つかもしれません。

Scene3D でのブレンディング

Scene3D 要素を使用して、Qt Quick シーンを介してQt 3D シーンをレンダリングする場合、適切なレンダリング結果を得るためには、レンダリング状態のブレンディング引数を調整する必要があるかもしれないことに注意してください。これは、Qt 3D がまずシーンをオフスクリーンテクスチャにレンダリングし、それをQt Quick シーンの残りの部分とブレンドするためです。

適切な値としては、ソースアルファにQt3DRender::QBlendEquationArguments::Zero 、デスティネーションアルファにQt3DRender::QBlendEquationArguments::One を設定することが一般的です。

便利なツール

Qt 3D の初期バージョンではトラブルシューティング機能がかなり限られていたため、OpenGLの描画呼び出しをキャプチャし、何が起きているかについてより多くの手がかりを得るためのツールがあると役立つ場合があります。

• apitrace
• vogl

これらのツールを使用すると、Qt 3D アプリケーションによって行われているすべてのOpenGL呼び出しのトレースを収集できます。生成されたトレースファイルを確認することで、描画呼び出しが行われているか、テクスチャが正しくアップロードされているか、ユニフォームが適切な値で設定されているかなどを確認するのに役立ちます。

今後のリリースでは、Qt 3D 向けのツール提供が計画されています。