このページでは

Qt 3D Render QML Types

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

このモジュールの QML タイプをインポートして使用するには、次の文を使用してください:

import Qt3D.Render 2.12

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

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 3D がQt 5シリーズで排他的に使用していた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 はそのプラットフォームに最適であると判断したバックエンドをデフォルトとして使用します。

あるいは、QQuickWindow を使用している場合は、QQuickWindow::setGraphicsApi() を使用して、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.