Auf dieser Seite

Qt Quick 3D

Qt Quick 3D wird eine hochrangige API zum Erstellen von 3D-Inhalten und 3D-Benutzeroberflächen auf der Grundlage von Qt Quick. Anstatt eine externe Engine zu verwenden, was zu Synchronisationsproblemen und zusätzlichen Abstraktionsebenen führt, bietet „ Qt Quick 3D “ Erweiterungen des bestehenden „Qt Quick “-Szenengraphen für räumliche Inhalte sowie einen Renderer für diesen erweiterten Szenengraphen. Bei Verwendung des räumlichen Szenengraphen ist es möglich, Qt Quick 2D-Inhalte mit 3D-Inhalten zu mischen.

Qt Quick 3DQt Quick 3D Xr bietet zudem Unterstützung für XR- und VR-Anwendungen.

Grünes Drachenmodell in Metallic-Optik

Verwendung des Moduls

QML-API

Die QML-Typen des Moduls sind über den Import „ QtQuick3D “ verfügbar. Um die Typen zu verwenden, fügen Sie die folgende Importanweisung in Ihre .qml-Datei ein:

import QtQuick3D

Die folgenden Modulimporte bieten zusätzliche Funktionen:

import QtQuick3D.AssetUtils
import QtQuick3D.Helpers
import QtQuick3D.Particles3D
import QtQuick3D.Xr

C++-API

Die Verwendung der C++-API eines Qt-Moduls erfordert die Verknüpfung mit der Modulbibliothek, entweder direkt oder über andere Abhängigkeiten. Mehrere Build-Tools bieten hierfür spezielle Unterstützung, darunter CMake und qmake.

Erstellen mit CMake

Verwenden Sie den Befehl „ find_package() “, um die benötigte Modulkomponente im Paket „ Qt6 “ zu finden:

find_package(Qt6 REQUIRED COMPONENTS Quick3D)
target_link_libraries(mytarget PRIVATE Qt6::Quick3D)

Weitere Informationen finden Sie in der Übersicht „Erstellen mit CMake “.

Erstellen mit qmake

Um das Modul für die Erstellung mit qmake zu konfigurieren, fügen Sie das Modul als Wert der Variablen „ QT “ in der .pro-Datei des Projekts hinzu:

QT += quick3d

Kompilieren aus dem Quellcode

Stellen Sie beim Erstellen aus dem Quellcode sicher, dass die Module und Werkzeuge aus den Repositories „qtdeclarative“ und „qtshadertools“ zuerst erstellt werden, da „ Qt Quick 3D “ ohne diese nicht verwendet werden kann. Es wird außerdem dringend empfohlen, „qtquicktimeline“ zur Verfügung zu haben, da Keyframe-basierte Animationen andernfalls nicht verfügbar sind.

Darüber hinaus basieren einige der Beispiele auf Qt Quick Controls.

Modul-Entwicklung

Unter„Änderungen an Qt Quick 3D “ sind wichtige Änderungen an der Modul-API und der Funktionalität aufgeführt, die für die Qt-6-Serie von Qt vorgenommen wurden.

Artikel und Anleitungen

Beispiele

Referenz

Qt Academy-Kurse

Lizenzen und Urheberangaben

Qt Quick 3D ist unter der kommerziellen Lizenz von The Qt Company verfügbar. Darüber hinaus steht es unter der GNU General Public License, Version 3, zur Verfügung. Weitere Details finden Sie unter „Qt-Lizenzierung “.

Darüber hinaus enthält „ Qt Quick 3D “ möglicherweise Module von Drittanbietern unter den folgenden freizügigen Lizenzen:

Blue Noise Texture

Creative Commons Zero v1.0 Universal

Godot Engine: Fog

MIT-Lizenz

Godot Engine: ProceduralSky

MIT-Lizenz

Intel Embree, version 3.13.3

Apache-Lizenz 2.0

Java Native Interface for C++, version 1.0.0

MIT-Lizenz

JsonCpp, version 1.9.6

MIT-Lizenz

Open Asset Import Library, version 6.0.5

BSD-Lizenz mit 3 Klauseln („New“ oder „Revised“)

OpenXR SDK, version 1.1.61

Apache-Lizenz 2.0

Tiny OpenEXR, version 1.0.13

BSD-Lizenz mit 3 Klauseln („New“ oder „Revised“)

closestPointOnTriangle

Apache-Lizenz Version 2.0

meshoptimizer, version 1.2

MIT-Lizenz

xatlas, version 16ace528acd2cf1f16a7c0dde99c42c486488dbe

MIT-Lizenz

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