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
- Qt Quick 3D Einführung Beispiel
- Qt Quick 3D Einführung mit glTF Assets
- Qt Quick 3D Grafik-Anforderungen
- Qt Quick 3D Architektur
- Balsam-Asset-Import-Werkzeug
- Optimieren von 3D-Assets
- Physikalisch basiertes Rendering
- Verwendung bildbasierter Beleuchtung
- Best Practices für Anti-Aliasing
- Qt Quick 3D Szenen mit 2D-Inhalten
- Programmierbare Materialien, Effekte, Geometrie und Texturdaten
- Materialien zur Bauzeit
- Skelett-Animation
- Morphing-Animation
- Instanzielles Rendering
- Detailgrad
- Benutzerdefinierter Material-Editor
- Lightmaps und globale Beleuchtung
- Schatten-Mapping
- Qt Quick 3D Xr
- Multiview-Rendering
Beispiele
- Einführung
- View3D mit mehreren Ansichtsfenstern
- Lichter und Schatten
- Dynamische Modellerstellung
- Prinzipielles Material
- Eingebaute Effekte und Tonemapping
- Qt Quick Elemente innerhalb der 3D-Szene
- Benutzerdefinierte Materialien
- Ungeschattete benutzerdefinierte Materialien
- Schreiben von benutzerdefinierten Post-Processing-Effekten
- Hinzufügen von benutzerdefinierter Geometrie aus C++
- Hinzufügen von benutzerdefinierten Texturdaten von C++ aus
- Baked Lightmaps verwenden
- Demonstriert das Einrichten einer einfachen VR-Szene
- Demonstration der Controller-Eingabe in VR
- Demonstration von räumlichen Ankern 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 Akademie Kurse
- Qt Quick 3D: Animationen
- Qt Quick 3D: Assets & Ressourcen
- Qt Quick 3D: Benutzerdefinierte Materialien, Rendereinstellungen & Nachbearbeitung
- Qt Quick 3D: Interaktion und Leistungsmanagement
- Qt Quick 3D: Beleuchtung & Kameras
- Qt Quick 3D: Ansichten, Szenen und Knotenpunkte
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:
MIT-Lizenz | |
MIT-Lizenz | |
Apache-Lizenz 2.0 | |
MIT-Lizenz | |
MIT-Lizenz | |
BSD 3-Klausel "Neu" oder "Überarbeitet" Lizenznehmer | |
Apache-Lizenz 2.0 | |
BSD 3-Klausel "Neu" oder "Revidiert" Lizenz | |
MIT-Lizenz | |
MIT-Lizenz |
© 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.