Qt Quick 3D QML Types

Il s'agit de l'interface QML permettant d'utiliser le moteur de rendu spatial et le graphe de scène. Pour l'instant, tous les contenus 3D passent par des textures hors écran (FBO) afin de pouvoir être intégrés dans des scènes d'Qt Quick s (comme le montre l'QQuickItem).

Importez le module QtQuick3D à l'aide de l'instruction suivante :

import QtQuick3D

Types QML QtQuick3D

AddDefine	Ajoute une définition de préprocesseur à la compilation du shader pour un passage
BakedLightmap	Spécifie les paramètres de la carte de lumière précalculée pour un modèle
Buffer	Crée ou référence un tampon de couleur à utiliser pour un passage d’un effet
BufferInput	Définit un tampon d'entrée à utiliser comme entrée pour un passage d'un effet
Camera	Définit une classe de base abstraite pour les caméras
ColorAttachment	Définit une extension de couleur pour un passage de rendu
Command	Supertype des commandes à exécuter dans le cadre d’un passage d’un effet
ContentLayer	Singleton fournissant des constantes d’indicateurs de calque pour le regroupement et le filtrage des nœuds de scène
CubeMapTexture	Définit une texture de carte cubique destinée à être utilisée dans des scènes 3D
CustomCamera	Définit une caméra avec une matrice de projection personnalisée
CustomMaterial	Composant de base permettant de créer des matériaux personnalisés utilisés pour l'ombrage des modèles
DebugSettings	Utilisé pour configurer les paramètres de débogage
DepthStencilAttachment	Définit une extension de profondeur-stencil pour un RenderPass
DepthTextureAttachment	Définit une texture de profondeur associée à un pass
DirectionalLight	Définit une lumière directionnelle dans la scène
Effect	Composant de base permettant de créer un effet de post-traitement
FileInstancing	Permet de lire des tables d’instances à partir d’un fichier
Fog	Spécifie les paramètres de brouillard pour une scène
FrustumCamera	Définit une PerspectiveCamera avec un frustum personnalisé
Geometry	Type de base pour une géométrie personnalisée
InstanceList	Permet de spécifier manuellement l’instanciation en QML
InstanceListEntry	Spécifie une instance dans une InstanceList
Instancing	Type de base pour les tables d'instances
Joint	Définit un nœud dans une hiérarchie d’animation squelettique
Light	Type de base abstrait non créable pour toutes les lumières
Lightmapper	Spécifie les paramètres de cuisson des lightmaps pour une scène
Loader3D	Permet le chargement dynamique d’un sous-arbre 3D à partir d’une URL ou d’un composant
Material	Type de base abstrait fournissant des fonctionnalités communes aux matériaux
Model	Permet de charger les données d’un modèle 3D
MorphTarget	Définit les propriétés d’une cible de morphing
Node	Composant de base d’un objet présent dans une scène 3D
Object3D	Type de base abstrait de tous les nœuds et ressources 3D
OrthographicCamera	Définit une caméra avec une matrice de projection orthographique
Pass	Définit un passage de rendu dans un effet
PerspectiveCamera	Définit une caméra en perspective permettant de visualiser le contenu d’une scène 3D
PipelineStateOverride	Définit des remplacements d’état de pipeline pour un passage unique
PointLight	Définit une lumière ponctuelle dans la scène
PrincipledMaterial	Permet de définir un matériau pour des éléments 3D à l'aide du workflow « métal/rugosité »
Quaternion	Fournit des fonctions utilitaires pour les quaternions
QuaternionAnimation	Une animation de propriété pour les quaternions
ReflectionProbe	Définit une sonde de réflexion dans la scène
RenderExtension	Un type de base abstrait non instanciable pour les extensions de rendu
RenderPass	Définit un passage de rendu personnalisé pour le rendu de contenu 3D
RenderPassTexture	Définit une texture à utiliser comme cible de rendu dans un passage
RenderStats	Fournit des informations sur le rendu de la scène
RenderablesFilter	Définit un filtre permettant de sélectionner les éléments de rendu à modifier dans un passage
Repeater3D	Instancie un certain nombre de composants basés sur des nœuds à l’aide d’un modèle fourni
ResourceLoader	Permet le préchargement des ressources 3D
SceneEnvironment	Vous permet de configurer la manière dont une scène est rendue
SetUniformValue	Définit une valeur à définir au cours d’un passage
Shader	Composant conteneur permettant de définir le code de shader utilisé par les effets de post-traitement
Skeleton	Définit une hiérarchie d’animation squelettique
Skin	Définit une animation de skinning
SkyMaterial	Rendu d’un ciel procédural et génération de données d’éclairage basées sur des images
SpecularGlossyMaterial	Permet de définir un matériau pour des éléments 3D à l’aide du workflow spéculaire/brillance
SpotLight	Définit un projecteur dans la scène
SubRenderPass	Effectue le rendu d’une sous-section du travail dans la même cible de rendu que le RenderPass parent
Texture	Définit une texture destinée à être utilisée dans des scènes 3D
TextureData	Type de base pour les données de texture personnalisées
TextureInput	Spécifie une texture exposée aux shaders d'un CustomMaterial ou d'un Effect
TextureProviderExtension	Type de base abstrait pour les extensions de rendu qui produisent une texture
View3D	Fournit une fenêtre d’affichage sur laquelle rendre une scène 3D

Types de valeurs QML

bounds	Spécifie les limites d’un modèle
pickResult	Contient les résultats d’une sélection
renderTargetBlend	Définit les paramètres de fusion pour une seule pièce jointe de couleur d’un passage de rendu

Types QML de QtQuick3D.Helpers

Importez le module QtQuick3D.Helpers à l'aide de l'instruction suivante :

import QtQuick3D.Helpers

AxisHelper	Aide visuelle permettant d'afficher les 3 axes et une grille dans une scène 3D
CapsuleGeometry	Fournit la géométrie d’une capsule
ConeGeometry	Fournit la géométrie d'un cône
CuboidGeometry	Fournit la géométrie d’un parallélépipède rectangle
CylinderGeometry	Fournit la géométrie d'un cylindre
DebugView	Vue permettant d'afficher les statistiques de rendu et d'effectuer des actions de débogage et de développement
ExtendedSceneEnvironment	Un SceneEnvironment fournissant des effets de rendu couramment utilisés
ExtrudedTextGeometry	Fournit la géométrie pour du texte extrudé
GridGeometry	Un fournisseur de géométrie personnalisé pour le rendu de grilles
HeightFieldGeometry	Une géométrie de champ de hauteur
InfiniteGrid	Affiche une grille infinie
InstanceModel	Définit un modèle de données basé sur une table d’instances
InstanceRange	Spécifie une plage pour RandomInstancing
InstanceRepeater	Instancie des composants à partir d’une table d’instances
LodManager	Gestionnaire qui gère les changements de visibilité du niveau de détail
LookAtNode	Un nœud auxiliaire qui reste automatiquement orienté vers un autre nœud
OrbitCameraController	Contrôleur de caméra qui tourne autour d’une origine
PlaneGeometry	Fournit la géométrie d’un plan
ProceduralMesh	Permet la création de géométrie à partir de QML
ProceduralMeshSubset	Définit un sous-ensemble d’un ProceduralMesh
ProceduralSkyTextureData	Génère une carte cubique HDR pour skybox
ProceduralTextureData	Permet la création et le remplissage de données de texture à partir de QML
QuadTextureProvider	Permet de rendre une texture quadrangulaire à l’aide d’un shader de fragment personnalisé
RandomInstancing	Génère une table d’instanciation aléatoire
RenderOutputProvider	Sert de passerelle pour accéder aux textures fournies dans les passes
SimpleQuadRenderer	Rendu d’un quad texturé en plein écran sur la cible de rendu principale
SphereGeometry	Fournit la géométrie d’une sphère
TorusGeometry	Fournit la géométrie d’un tore
WasdController	Contrôle la position et l’orientation des nœuds à l’aide du clavier et de la souris

Types QML de QtQuick3D.AssetUtils

Importez le module QtQuick3D.AssetUtils à l'aide de l'instruction suivante :

import QtQuick3D.AssetUtils

RuntimeLoader

Importe une ressource 3D lors de l'exécution

Types QML QtQuick3D.Particles3D

Importez le module QtQuick3D.Particles3D à l'aide de l'instruction suivante :

import QtQuick3D.Particles3D

Affector3D	Les affecteurs modifient les attributs des particules au cours de leur cycle de vie
Attractor3D	Attire les particules vers une position ou une forme
Direction3D	Les directions attribuent une vitesse aux particules émises
DynamicBurst3D	Émissions dynamiques
EmitBurst3D	Salves d'émetteurs déclaratives
Gravity3D	Accélère les particules selon un vecteur de magnitude spécifiée dans la direction spécifiée
LineParticle3D	Particule linéaire
ModelBlendParticle3D	Fusionne un effet de particules avec un modèle 3D
ModelParticle3D	Particule utilisant un modèle 3D d'Qt Quick
Particle3D	Particule logique abstraite
ParticleAbstractShape3D	Type de base abstrait pour les formes de particules
ParticleCustomShape3D	Charge des formes de particules personnalisées pour les émetteurs et les affecteurs
ParticleEmitter3D	Émetteur pour particules logiques
ParticleModelShape3D	Propose une forme de particule issue d'un modèle pour les émetteurs et les affecteurs
ParticleSceneShape3D	Propose des formes de particules issues d’une scène pour les émetteurs et les affecteurs
ParticleShape3D	Propose des formes 3D pour les émetteurs et les affecteurs
ParticleSystem3D	Un système comprenant des types de particules, d’émetteurs et d’affecteurs
ParticleSystem3DLogging	Fournit des informations sur le système de particules
PointRotator3D	Fait pivoter les particules autour d’un point de pivot
Repeller3D	Répulseur de particules
ScaleAffector3D	Affecteur d’échelle de particules
SpriteParticle3D	Particule utilisant une texture de sprite 2D
SpriteSequence3D	Fournit des fonctionnalités de séquence d’images pour les particules de type Sprite
TargetDirection3D	Pour spécifier une direction vers la position cible
TrailEmitter3D	Émetteur de particules logiques provenant d'autres particules
VectorDirection3D	Pour spécifier une direction vers la direction cible
Wander3D	Applique des courbes d’onde aléatoires aux particules

Types QML QtQuick3D.Xr

Importez le module QtQuick3D.Xr à l'aide de l'instruction suivante :

import QtQuick3D.Xr

XrCamera	Suivi de la position et de l’orientation spatiales à partir desquelles l’utilisateur visualise une scène XR
XrController	Nœud spatial suivi qui suit la position et l'orientation d'un contrôleur d'entrée
XrErrorDialog	Boîte de dialogue d'erreur personnalisée pour les applications PCVR
XrHandModel	Représente un modèle 3D d’une main
XrHapticEffect	Représente un effet haptique
XrHapticFeedback	Contrôle le retour haptique d’un contrôleur XR
XrInputAction	Représente une action provenant d’un contrôleur d’entrée
XrItem	Une surface virtuelle dans l'espace 3D pouvant contenir du contenu d'interface utilisateur en 2D
XrOrigin	Emplacement d'origine pour XrView
XrRuntimeInfo	Affiche des informations sur le runtime XR
XrSimpleHapticEffect	Permet de configurer les retours haptiques de la manette en utilisant l’amplitude, la durée et la fréquence
XrSpatialAnchor	Suivi d’un emplacement ou d’un objet spécifique dans l’espace réel
XrSpatialAnchorListModel	Fournit un modèle contenant des ancrages spatiaux
XrView	Configure la vue pour une application Xr
XrVirtualMouse	Convertit les commandes de la manette 3D en commandes de souris pour les éléments 2D

Types QML obsolètes

Les types QML suivants sont désormais obsolètes. Les types obsolètes ne sont plus mis à jour. Ils sont fournis pour permettre au code source existant de continuer à fonctionner, mais ils pourraient être supprimés dans une prochaine version. Nous déconseillons fortement d'utiliser ces classes dans du nouveau code.

A: AdditiveColorGradient

B: Blur; BrushStrokes

C: ChromaticAberration; ColorMaster

D: DefaultMaterial; DepthOfFieldHQBlur; Desaturate; DistortionRipple; DistortionSphere; DistortionSpiral

E: EdgeDetect; Emboss

F: Flip; FunctionSorter; Fxaa

G: GaussianBlur

H: HDRBloomTonemap

M: MotionBlur

S: Scatter; SCurveTonemap; Settings

T: TiltShift

V: Vignette

Types QML comportant des propriétés ou des méthodes obsolètes

Les types QML suivants contiennent une ou plusieurs propriétés ou méthodes désormais obsolètes. Les membres obsolètes ne sont plus maintenus. Ils sont fournis pour permettre au code source existant de continuer à fonctionner, mais ils pourraient être supprimés dans une prochaine version. Nous vous déconseillons fortement d'utiliser ces membres obsolètes dans du nouveau code. Cliquez sur un type pour afficher ses membres obsolètes.

A: Application

B: BakedLightmap

C: Canvas

D: DragHandler

G: Gravity

H: HeightFieldGeometry

L: Light; Locale

M: Model; MouseEvent

P: PinchHandler

Q: Qt

S: Screen; SortFilterProxyModel

T: TableView; Text; TouchPoint

X: XrInputAction

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