このページでは

Qt 3D Render C++ Classes

Qt 3D のRenderモジュールには、Qt 3D を使用した2Dおよび3Dレンダリングをサポートする機能が含まれています。詳細...

このモジュールはバージョン6.8以降、非推奨となっています。新しいコードでの使用は強く推奨しません。

名前空間

クラス

詳細な説明

Qt 3D Render モジュールは、Qt 3D フレームワークの一部として 2D および 3D レンダリングを実装するために必要なアスペクト、コンポーネント、およびその他のサポート型を提供します。

このモジュールのクラスを使用するには、C++ファイルに次のディレクティブを追加してください:

#include <Qt3DRender>

対応するC++ライブラリをリンクするには、qmakeプロジェクトファイルに以下を追加してください:

QT += 3drender

クラス、型、および関数は、Qt3DRender 名前空間の下で宣言されています。

概要

Qt 3D のRenderアスペクトは、『Qt 3D Render Framegraph』で説明されているデータ駆動型構成をサポートしています。

レンダリング・バックエンドの選択

Render アスペクトには、2 つのレンダリング・バックエンドが用意されています。

  • OpenGL バックエンド (ES 2、ES 3.2、GL 2、GL 3、GL 3.2、GL 4.3)
  • RHI バックエンド (ES 2、GL、DirectX、Vulkan、Metal)

OpenGLのみを対象とし、特定のOpenGL機能を使用している場合は、OpenGLバックエンドを使用する方が適している可能性があります。これは、Qt 5シリーズでQt 3D が排他的に使用していたOpenGLバックエンドです。

特定の OpenGL 機能を使用しておらず、OpenGL が非推奨となっている可能性のあるさまざまなプラットフォームをターゲットにしたい場合は、RHI バックエンドを使用する方が適しています。

レンダリングバックエンドを選択するには、環境変数 QT3D_RENDERER を「opengl」または「rhi」のいずれかに設定します。デフォルトは OpenGL バックエンドです。

RHIバックエンドを使用する場合、QSG_RHI_BACKENDを以下のいずれかの値に設定することで、内部のRHIバックエンドを強制的に使用させることができます。

  • opengl → RHI OpenGL バックエンド
  • gl → RHI OpenGL バックエンド
  • gles2 → RHI OpenGL バックエンド
  • metal → RHI Metal バックエンド
  • vulkan → RHI Vulkan バックエンド
  • d3d11 -> RHI DirectX 11 バックエンド

指定がない場合、RHI はそのプラットフォームに最適であると判断したバックエンドをデフォルトとして使用します。

参照

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.