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, tout le contenu 3D passe par des textures hors écran (FBO) afin qu'elles puissent être composées en scènes Qt Quick (comme QQuickItem).

Importez le module QtQuick3D avec l'instruction suivante :

import QtQuick3D

QtQuick3D QML Types

AddDefine	Ajoute une définition de préprocesseur à la compilation des shaders pour une passe.
BakedLightmap	Spécifie les paramètres de l'image lumineuse cuite pour un modèle.
Buffer	Crée ou référence un tampon de couleur à utiliser pour une passe d'un effet
BufferInput	Définit un tampon d'entrée à utiliser comme entrée pour une passe d'un effet
Camera	Définit une base abstraite pour les caméras
ColorAttachment	Définit un attachement de couleur pour une passe
Command	Supertype de commandes à exécuter dans le cadre d'une passe d'un effet
ContentLayer	Fournit une énumération des couches de contenu disponibles dans un QtQuick3D
CubeMapTexture	Définit une texture de carte cubique à utiliser dans les scènes 3D
CustomCamera	Définit une caméra avec une matrice de projection personnalisée
CustomMaterial	Composant de base pour la création de matériaux personnalisés utilisés pour ombrer les modèles
DebugSettings	Utilisé pour configurer les paramètres de débogage
DepthStencilAttachment	Définit un attachement au crayon de profondeur pour un RenderPass
DepthTextureAttachment	Définit une texture de profondeur pour un passage
DirectionalLight	Définit une lumière directionnelle dans la scène
Effect	Composant de base pour la création d'un effet de post-traitement
FileInstancing	Permet de lire les tables d'instance à 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 la géométrie personnalisée
InstanceList	Permet de spécifier manuellement l'instanciation en QML
InstanceListEntry	Spécifie une instance dans une liste d'instances
Instancing	Type de base pour les tables d'instances
Joint	Définit un nœud dans une hiérarchie d'animation squelettique
Light	Un type de base abstrait non créable pour toutes les lumières
Lightmapper	Spécifie les paramètres de cuisson de la carte lumineuse 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 offrant 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 morphologique
Node	Composant de base d'un objet existant 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 une passe de rendu dans un effet
PerspectiveCamera	Définit une caméra de perspective pour visualiser le contenu d'une scène 3D
PipelineStateOverride	Définit l'état du pipeline pour une passe unique
PointLight	Définit une lumière ponctuelle dans la scène
PrincipledMaterial	Permet de définir un matériau pour les objets 3D à l'aide du flux de travail métal/rugosité
Quaternion	Fournit des fonctions utilitaires pour les quaternions
QuaternionAnimation	Une PropertyAnimation pour les quaternions
ReflectionProbe	Définit une sonde de réflexion dans la scène
RenderExtension	Un type de base abstrait non créable pour les extensions de rendu
RenderPass	Le type définit une passe de rendu personnalisée pour le rendu de contenu 3D
RenderPassTexture	Définit une texture à utiliser comme cible de rendu dans une passe
RenderStats	Fournit des informations sur le rendu de la scène
RenderablesFilter	Définit un filtre pour sélectionner les éléments de rendu à affecter dans une passe
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	Permet de configurer le rendu d'une scène
SetUniformValue	Définit une valeur à définir au cours d'une seule passe
Shader	Composant conteneur pour définir le code shader utilisé par les effets de post-traitement
Skeleton	Définit une hiérarchie d'animation squelettique
Skin	Définit une animation d'habillage
SpecularGlossyMaterial	Permet de définir un matériau pour les objets 3D à l'aide du flux de travail spéculaire/brillant
SpotLight	Définit un éclairage ponctuel dans la scène
Texture	Définit une texture à utiliser dans les 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	Un type de base abstrait non créable pour les extensions de fournisseurs de textures
View3D	Fournit une fenêtre de visualisation pour le rendu d'une scène 3D
renderTargetBlend	Définit les paramètres de mélange pour une couleur unique d'une passe de rendu.

Types de valeurs QML

bounds	Spécifie les limites d'un modèle
pickResult	Contient les résultats d'une sélection

Types QML QtQuick3D.Helpers

Importez le module QtQuick3D.Helpers avec l'instruction suivante :

import QtQuick3D.Helpers

AxisHelper	Aide visuelle pour 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 cuboïde
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 les effets de rendu couramment utilisés
ExtrudedTextGeometry	Fournit la géométrie d'un texte extrudé
GridGeometry	Un fournisseur de géométrie personnalisé pour les grilles de rendu
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'instance
InstanceRange	Spécifie une plage pour RandomInstancing
InstanceRepeater	Instancie les composants sur la base d'une table d'instance
LodManager	Gestionnaire qui gère les changements de visibilité du niveau de détail
LookAtNode	Un nœud d'aide qui pointe automatiquement vers un autre nœud
OrbitCameraController	Contrôleur de caméra qui tourne autour d'un point d'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 un cubemap de boîte à ciel HDR
ProceduralTextureData	Permet la création et la population de TextureData à partir de QML
RandomInstancing	Génère une table d'instanciation aléatoire
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 des touches et de la souris

Types QML de QtQuick3D.AssetUtils

Importez le module QtQuick3D.AssetUtils avec l'instruction suivante :

import QtQuick3D.AssetUtils

RuntimeLoader

Importe une ressource 3D au moment de l'exécution

QtQuick3D.Particles3D QML Types

Importez le module QtQuick3D.Particles3D avec la déclaration suivante :

import QtQuick3D.Particles3D

Affector3D	Les affecteurs modifient les attributs des particules pendant leur durée de vie
Attractor3D	Attire les particules vers une position ou une forme
Direction3D	Les directions assignent une vitesse aux particules émises.
DynamicBurst3D	Rafales d'émetteurs dynamiques
EmitBurst3D	Rafales d'émetteurs déclaratives
Gravity3D	Accélère les particules vers un vecteur de la magnitude spécifiée dans la direction spécifiée
LineParticle3D	Particule linéaire
ModelBlendParticle3D	Mélange l'effet de particule avec un modèle 3D
ModelParticle3D	Particule utilisant un modèle 3D Qt Quick
Particle3D	Particule logique abstraite
ParticleAbstractShape3D	Type de base abstrait des formes de particules
ParticleCustomShape3D	Charge des formes de particules personnalisées pour les émetteurs et les affectateurs
ParticleEmitter3D	Émetteur pour les particules logiques
ParticleModelShape3D	Offre une forme de particule à partir d'un modèle pour les émetteurs et les affecteurs
ParticleSceneShape3D	Offre une forme de particule à partir d'une scène pour les émetteurs et les affecteurs
ParticleShape3D	Offre des formes 3D pour les émetteurs et les affectateurs
ParticleSystem3D	Un système qui comprend des types de particules, d'émetteurs et d'affecteurs
ParticleSystem3DLogging	Fournit des informations sur le système de particules
PointRotator3D	Fait tourner 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 caractéristiques de séquence d'images pour les particules Sprite
TargetDirection3D	Pour spécifier une direction vers la position cible
TrailEmitter3D	Émetteur de particules logiques à partir d'autres particules
VectorDirection3D	Pour spécifier une direction vers la direction cible
Wander3D	Applique des courbes d'ondes aléatoires aux particules

Types QtQuick3D.Xr QML

Importez le module QtQuick3D.Xr avec l'instruction suivante :

import QtQuick3D.Xr

XrCamera	Suivi de la position spatiale et de l'orientation à partir desquelles l'utilisateur visualise une scène XR
XrController	Un nœud spatial suivi qui suit la position et l'orientation d'un contrôleur d'entrée.
XrErrorDialog	Dialogue d'erreur personnalisé pour les applications PCVR
XrHandModel	Représente un modèle 3D pour une main
XrHapticEffect	Représente un effet haptique
XrHapticFeedback	Contrôle le retour haptique pour un contrôleur XR
XrInputAction	Représente une action d'un contrôleur d'entrée
XrItem	Surface virtuelle dans l'espace 3D pouvant contenir du contenu d'interface utilisateur 2D
XrOrigin	Emplacement d'origine du XrView
XrRuntimeInfo	Affiche des informations sur le runtime XR
XrSimpleHapticEffect	Permet de définir l'haptique du contrôleur à l'aide de l'amplitude, de la durée et de 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 d'une application XR
XrVirtualMouse	Mappage de l'entrée du contrôleur 3D à l'entrée de la souris dans les éléments 2D

Types QML obsolètes

Les types QML suivants sont désormais obsolètes. Les types obsolètes ne sont plus maintenus. Ils sont fournis pour permettre à d'anciens codes sources de fonctionner, mais ils pourront être supprimés dans une prochaine version. Il est fortement déconseillé d'utiliser ces classes dans un nouveau code.

A: AdditiveColorGradient

B: Blur; BrushStrokes

C: ChromaticAberration; ColorMaster

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

E: EdgeDetect; Emboss

F: Flip; Fxaa

G: GaussianBlur

H: HDRBloomTonemap

M: MotionBlur

S: Scatter; SCurveTonemap; Settings

T: TiltShift

V: Vignette

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

Les types QML suivants contiennent une ou plusieurs propriétés ou méthodes qui sont désormais obsolètes. Les membres obsolètes ne sont plus maintenus. Ils sont fournis pour permettre à un ancien code source de fonctionner, mais ils pourront être supprimés dans une prochaine version. Il est fortement déconseillé d'utiliser ces membres obsolètes dans un nouveau code. Cliquez sur un type pour voir 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

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.