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.

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 QtQuick3DDie folgenden Modulimporte bieten zusätzliche Funktionen:
import QtQuick3D.AssetUtils
import QtQuick3D.Helpers
import QtQuick3D.Particles3D
import QtQuick3D.XrC++-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 += quick3dKompilieren 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
- Qt Quick 3D Einführung Beispiel
- Qt Quick 3D Einführung mit glTF-Assets
- Qt Quick 3D Grafikanforderungen
- Qt Quick 3D Architektur
- Balsam-Asset-Import-Tool
- Optimierung von 3D-Assets
- Physikalisch basiertes Rendering
- Verwendung bildbasierter Beleuchtung
- Bewährte Verfahren für Anti-Aliasing
- Qt Quick 3D Szenen mit 2D-Inhalten
- Programmierbare Materialien, Effekte, Geometrie und Texturdaten
- Skelettanimation
- Morphing-Animation
- Instanziertes Rendering
- Detailgrad
- Benutzerdefinierter Material-Editor
- Lightmaps und globale Beleuchtung
- Schattenabbildung
- Qt Quick 3D Xr
- Multiview-Rendering
- Festplattenbasiertes Caching von Shadern
Beispiele
- Einführung
- View3D mit mehreren Ansichtsfenstern
- Licht und Schatten
- Dynamische Modellerstellung
- Principled Material
- Integrierte Effekte und Tonemapping
- Qt Quick Objekte in der 3D-Szene
- Benutzerdefinierte Materialien
- Nicht schattierte benutzerdefinierte Materialien
- Erstellen benutzerdefinierter Post-Processing-Effekte
- Hinzufügen benutzerdefinierter Geometrie aus C++
- Hinzufügen benutzerdefinierter Texturdaten aus C++
- Verwendung von gebackenen Lightmaps
- Veranschaulicht die Einrichtung einer einfachen VR-Szene
- Veranschaulicht die Controller-Eingabe in VR
- Veranschaulicht räumliche Anker in VR
- Alle Beispiele
Referenz
- Qt Quick 3D QML Types
- Qt Quick 3D C++ Classes
- Qt Quick 3D Helpers QML Types
- Qt Quick 3D Asset Utility QML Types
- Qt Quick 3D Particles3D QML Types
- Qt Quick 3D Xr
Verwandte Module
Qt Academy-Kurse
- Qt Quick 3D: Animationen
- Qt Quick 3D: Assets und Ressourcen
- Qt Quick 3D: Benutzerdefinierte Materialien, Rendereinstellungen & Nachbearbeitung
- Qt Quick 3D: Interaktion und Leistungsoptimierung
- Qt Quick 3D: Beleuchtung & Kameras
- Qt Quick 3D: Ansichten, Szenen & Knoten
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:
Creative Commons Zero v1.0 Universal | |
MIT-Lizenz | |
MIT-Lizenz | |
Apache-Lizenz 2.0 | |
MIT-Lizenz | |
MIT-Lizenz | |
BSD-Lizenz mit 3 Klauseln („New“ oder „Revised“) | |
Apache-Lizenz 2.0 | |
BSD-Lizenz mit 3 Klauseln („New“ oder „Revised“) | |
Apache-Lizenz Version 2.0 | |
MIT-Lizenz | |
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.