Auf dieser Seite

Qt 3D Render C++ Classes

Das Modul „ Qt 3D “ enthält Funktionen zur Unterstützung des 2D- und 3D-Renderings mithilfe von „ Qt 3D “. Mehr...

Dieses Modul ist seit Version 6.8 veraltet. Wir raten dringend davon ab, es in neuem Code zu verwenden.

Namensräume

Klassen

Ausführliche Beschreibung

Das „ Qt 3D “-Render-Modul stellt Aspekte, Komponenten und andere unterstützende Typen bereit, die zur Implementierung von 2D- und 3D-Rendering als Teil des „ Qt 3D “-Frameworks erforderlich sind.

Um Klassen aus diesem Modul zu verwenden, fügen Sie diese Anweisung in die C++-Dateien ein:

#include <Qt3DRender>

Um die entsprechende C++-Bibliothek einzubinden, fügen Sie Folgendes in Ihre qmake-Projektdatei ein:

QT += 3drender

Klassen, Typen und Funktionen werden unter dem Namespace „ Qt3DRender “ deklariert.

Übersicht

Der Aspekt „ Qt 3D Render“ bietet Unterstützung für datengesteuerte Konfiguration, wie im Abschnitt „Qt 3D Render Framegraph“ beschrieben.

Auswahl eines Rendering-Backends

Der „Render“-Aspekt verfügt über zwei Rendering-Backends.

  • OpenGL-Backend (ES 2, ES 3.2, GL 2, GL 3, GL 3.2, GL 4.3)
  • RHI-Backend (ES 2, GL, DirectX, Vulkan, Metal)

Wenn Sie ausschließlich auf OpenGL abzielen und bestimmte OpenGL-Funktionen nutzen, ist die Verwendung des OpenGL-Backends möglicherweise die bessere Wahl. Dies ist das OpenGL-Backend, das Qt 3D ausschließlich in der Qt-5-Reihe verwendet hat.

In Fällen, in denen Sie keine spezifischen OpenGL-Funktionen nutzen und verschiedene Plattformen ansprechen möchten, auf denen OpenGL möglicherweise veraltet ist, ist die Verwendung des RHI-Backends die bessere Alternative.

Um Ihr Rendering-Backend auszuwählen, muss die Umgebungsvariable QT3D_RENDERER entweder auf „opengl“ oder „rhi“ gesetzt werden. Standardmäßig ist das OpenGL-Backend aktiviert.

Bei Verwendung des RHI-Backends können Sie das interne RHI-Backend zusätzlich erzwingen, indem Sie die Umgebungsvariable QSG_RHI_BACKEND auf einen der folgenden Werte setzen:

  • opengl -> RHI-OpenGL-Backend
  • gl -> RHI-OpenGL-Backend
  • gles2 -> RHI-OpenGL-Backend
  • metal -> RHI-Metal-Backend
  • vulkan -> RHI-Vulkan-Backend
  • d3d11 -> RHI DirectX 11-Backend

Wird keine Angabe gemacht, wählt RHI standardmäßig das Backend aus, das es als das beste für die jeweilige Plattform erachtet.

Referenz

© 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.