Qt Quick 3D

Qt Quick 3D fournit une API de haut niveau permettant de créer du contenu 3D et des interfaces utilisateur 3D basées sur Qt Quick. Plutôt que d’utiliser un moteur externe, ce qui entraîne des problèmes de synchronisation et ajoute des couches d’abstraction supplémentaires, Qt Quick 3D propose des extensions du graphe de scène existant d’Qt Quick pour le contenu spatial, ainsi qu’un moteur de rendu pour ce graphe de scène étendu. L’utilisation du graphe de scène spatial permet de mélanger du contenu 2D Qt Quick avec du contenu 3D.

Qt Quick La 3D prend également en charge les applications XR et VR grâce à Qt Quick 3D Xr.

Utilisation du module

API QML

Les types QML du module sont disponibles via l’importation QtQuick3D. Pour utiliser ces types, ajoutez la déclaration d’importation suivante à votre fichier .qml :

import QtQuick3D

Les importations de modules suivantes fournissent des fonctionnalités supplémentaires :

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

API C++

L'utilisation de l'API C++ d'un module Qt nécessite une liaison avec la bibliothèque du module, soit directement, soit via d'autres dépendances. Plusieurs outils de compilation prennent cela en charge, notamment CMake et qmake.

Compilation avec CMake

Utilisez la commande ` find_package() ` pour localiser le composant de module requis dans le paquet ` Qt6 ` :

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

Pour plus de détails, consultez la présentation « Compilation avec CMake ».

Compilation avec qmake

Pour configurer le module en vue d’une compilation avec qmake, ajoutez le module en tant que valeur de la variable QT dans le fichier .pro du projet :

QT += quick3d

Compilation à partir du code source

Lors de la compilation à partir du code source, assurez-vous que les modules et outils des dépôts qtdeclarative et qtshadertools soient d’abord compilés, car il n’est pas possible d’utiliser Qt Quick 3D sans eux. Il est également fortement recommandé de disposer de qtquicktimeline, car les animations basées sur des images clés ne seront pas disponibles dans le cas contraire.

De plus, certains exemples s’appuient sur Qt Quick Controls.

Évolution du module

La section «Modifications apportées à Qt Quick 3D » répertorie les changements importants apportés à l’API et aux fonctionnalités du module dans le cadre de la série Qt 6.

Articles et guides

• Qt Quick Exemple d’introduction à la 3D
• Qt Quick Introduction à la 3D avec des ressources glTF
• Qt Quick Configuration requise pour les graphismes 3D
• Qt Quick Architecture 3D
• Outil d'importation de ressources Balsam
• Optimisation des ressources 3D
• Rendu basé sur la physique
• Utilisation de l'éclairage basé sur l'image
• Meilleures pratiques en matière d'anti-aliasing
• Qt Quick Scènes 3D avec du contenu 2D
• Données programmables relatives aux matériaux, aux effets, à la géométrie et aux textures
• Animation squelettique
• Animation par morphing
• Rendu instancié
• Niveau de détail
• Éditeur de matériaux personnalisés
• Cartes d'éclairage et éclairage global
• Mappage d'ombres
• Qt Quick 3D XR
• Rendu multivue
• Mise en cache des shaders sur disque

Exemples

• Introduction
• View3D avec plusieurs fenêtres d’affichage
• Lumières et ombres
• Création dynamique de modèles
• Matériaux basés sur des principes
• Effets intégrés et mappage de tons
• Qt Quick Éléments de la scène 3D
• Matériaux personnalisés
• Matériaux personnalisés non ombrés
• Écriture d’effets de post-traitement personnalisés
• Ajout d’une géométrie personnalisée depuis C++
• Ajout de données de texture personnalisées depuis C++
• Utilisation de lightmaps cuites
• Démonstration de la configuration d’une scène VR simple
• Démonstration de l'utilisation d'un contrôleur en réalité virtuelle
• Présente les ancrages spatiaux en réalité virtuelle
• Tous les exemples

Référence

• 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

Modules associés

• Qt Quick

Cours de la Qt Academy

• Qt Quick 3D : Animations
• Qt Quick 3D : Ressources et éléments
• Qt Quick 3D : Matériaux personnalisés, paramètres de rendu et post-traitement
• Qt Quick 3D : Interaction et gestion des performances
• Qt Quick 3D : Éclairage et caméras
• Qt Quick 3D : Vues, scènes et nœuds

Licences et mentions d’attribution

Qt Quick Qt 3D est disponible sous licence commerciale de The Qt Company. Il est également disponible sous la licence publique générale GNU, version 3. Voir la page Licences Qt pour plus de détails.

Par ailleurs, Qt Quick 3D peut contenir des modules tiers sous les licences permissives suivantes :