Qt Quick 3D

Qt Quick 3D bietet eine High-Level-API für die Erstellung von 3D-Inhalten und 3D-Benutzeroberflächen auf der Grundlage von Qt Quick. Anstatt eine externe Engine zu verwenden, die Probleme bei der Synchronisierung und zusätzliche Abstraktionsebenen mit sich bringt, bietet Qt Quick 3D Erweiterungen des bestehenden Qt Quick Scene Graph für räumliche Inhalte und einen Renderer für diesen erweiterten Scene Graph. Bei Verwendung des räumlichen Szenegraphen ist es möglich, Qt Quick 2D-Inhalte mit 3D-Inhalten zu mischen.

Qt Quick 3D Auch für XR- und VR-Anwendungen bietet Qt Quick 3D Xr.

Verwendung des Moduls

QML-API

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

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

Bauen 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 Einzelheiten finden Sie in der Übersicht Bauen mit CMake.

Bauen mit qmake

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

QT += quick3d

Bauen aus dem Quellcode

Wenn Sie aus dem Quellcode bauen, stellen Sie sicher, dass die Module und Werkzeuge aus den qtdeclarative und qtshadertools Repositories zuerst gebaut werden, da es nicht möglich ist, Qt Quick 3D ohne diese zu verwenden. Die Verfügbarkeit von qtquicktimeline wird ebenfalls dringend empfohlen, da Keyframe-basierte Animationen sonst nicht verfügbar sind.

Außerdem verlassen sich einige der Beispiele auf Qt Quick Controls.

Entwicklung des Moduls

Änderungen an Qt Quick 3D listet wichtige Änderungen an der Modul-API und -Funktionalität auf, die für die Qt 6-Serie von Qt vorgenommen wurden.

Artikel und Anleitungen

Beispiele

Referenz

Qt Akademie Kurse

Lizenzen und Namensnennung

Qt Quick 3D ist unter der kommerziellen Lizenz von The Qt Company erhältlich. Darüber hinaus ist es unter der GNU General Public License, Version 3, verfügbar. Siehe Qt Licensing für weitere Details.

Darüber hinaus enthält Qt Quick 3D möglicherweise Module von Drittanbietern, die den folgenden Lizenzen unterliegen:

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