Qt Quick 3D

Qt Quick 3D fournit une API de haut niveau pour la création de contenu 3D et d'interfaces utilisateur 3D basées sur la technologie Qt Quick. Plutôt que d'utiliser un moteur externe, qui crée des problèmes de synchronisation et des couches d'abstraction supplémentaires, Qt Quick 3D fournit des extensions au graphe de scène existant Qt Quick pour le contenu spatial et un moteur de rendu pour ce graphe de scène étendu. En utilisant le graphe de scène spatial, il est possible de mélanger Qt Quick du contenu 2D avec du contenu 3D.

Qt Quick 3D prévoit également des applications XR et VR avec Qt Quick 3D Xr.

Utilisation du module

API QML

Les types QML du module sont disponibles via l'importation QtQuick3D. Pour utiliser les types, ajoutez l'instruction d'importation suivante à votre fichier .qml :

import QtQuick3D

Les importations de modules suivantes offrent 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 l'établissement d'un lien avec la bibliothèque du module, soit directement, soit par l'intermédiaire d'autres dépendances. Plusieurs outils de construction disposent d'un support dédié à cet effet, notamment CMake et qmake.

Construction avec CMake

Utilisez la commande find_package() pour localiser le composant de module nécessaire dans le paquetage Qt6:

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

Pour plus de détails, voir l'aperçu de la construction avec CMake.

Construction avec qmake

Pour configurer le module afin qu'il soit construit avec qmake, ajoutez le module comme valeur de la variable QT dans le fichier .pro du projet :

QT += quick3d

Construire à partir des sources

Lorsque vous construisez à partir des sources, assurez-vous que les modules et les outils des dépôts qtdeclarative et qtshadertools sont construits en premier, car il n'est pas possible d'utiliser Qt Quick 3D sans eux. Il est également fortement recommandé d'avoir qtquicktimeline disponible, car les animations basées sur les images clés ne seront pas disponibles autrement.

En outre, certains des exemples reposent sur Qt Quick Controls.

Évolution du module

Changes to Qt Quick 3D liste les changements importants dans l'API et les fonctionnalités des modules qui ont été effectués pour la série Qt 6 de Qt.

Articles et guides

• Qt Quick Exemple d'introduction 3D
• Qt Quick Introduction 3D avec des actifs glTF
• Qt Quick Exigences graphiques 3D
• Qt Quick Architecture 3D
• Outil d'importation d'actifs Balsam
• Optimisation des actifs 3D
• Rendu basé sur la physique
• Utilisation de l'éclairage basé sur l'image
• Meilleures pratiques d'anti-crénelage
• Qt Quick Scènes 3D avec contenu 2D
• Matériaux programmables, effets, géométrie et données de texture
• Animation squelettique
• Animation de morphing
• Rendu instancié
• Niveau de détail
• Éditeur de matériaux personnalisés
• Lightmaps et illumination globale
• Cartographie des ombres
• Qt Quick 3D Xr
• Rendu multi-vues
• Mise en cache des shaders sur disque

Exemples d'application

• Introduction
• View3D avec plusieurs fenêtres de visualisation
• Lumières et ombres
• Création de modèles dynamiques
• Matériels de base
• Effets intégrés et tonemapping
• Qt Quick Éléments de la scène 3D
• Matériaux personnalisés
• Matériaux personnalisés non nuancés
• Écriture d'effets de post-traitement personnalisés
• Ajout d'une géométrie personnalisée à partir de C++
• Ajout de données de textures personnalisées à partir de C++
• Utilisation de lightmaps cuites
• Démonstration de la mise en place d'une scène VR simple
• Démonstration de l'utilisation d'un contrôleur dans la RV
• Démonstration des ancrages spatiaux dans la RV
• 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 : Actifs et ressources
• 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 : Eclairage et caméras
• Qt Quick 3D : Vues, scènes et nœuds

Licences et attributions

Qt Quick 3D est disponible sous la licence commerciale de The Qt Company. En outre, il est disponible sous la licence publique générale GNU, version 3. Voir Qt Licensing pour plus de détails.

De plus, Qt Quick 3D contient potentiellement des modules tiers sous les licences permissives suivantes :