Sur cette page

Qt 3D Render QML Types

Ce module est obsolète depuis Qt3D.Render 6.8. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Pour importer et utiliser les types QML du module, utilisez l'instruction suivante :

import Qt3D.Render 2.11

Sélection d'un backend de rendu

L'aspect Render est livré avec deux backends de rendu.

  • Backend OpenGL (ES 2, ES 3.2, GL 2, GL 3, GL 3.2, GL 4.3)
  • Le backend RHI (ES 2, GL, DirectX, Vulkan, Metal)

Si vous ciblez exclusivement OpenGL et que vous utilisez des fonctionnalités OpenGL spécifiques, il est préférable d'utiliser le backend OpenGL. C'est le backend OpenGL que Qt 3D a exclusivement utilisé dans la série Qt 5.

Dans les cas où vous n'utilisez pas de fonctionnalités OpenGL spécifiques et que vous souhaitez cibler différentes plates-formes qui pourraient avoir déprécié OpenGL, l'utilisation du backend RHI est une meilleure alternative.

Pour sélectionner votre moteur de rendu, la variable d'environnement QT3D_RENDERER doit être réglée sur "opengl" ou "rhi". La valeur par défaut est OpenGL.

Lorsque vous utilisez le backend RHI, vous pouvez forcer le backend RHI interne en définissant QSG_RHI_BACKEND à l'une des valeurs suivantes :

  • opengl -> RHI OpenGL backend
  • gl -> RHI OpenGL backend
  • gles2 -> RHI OpenGL backend
  • metal -> RHI Metal backend
  • vulkan -> RHI Vulkan backend
  • d3d11 -> RHI DirectX 11 backend

S'il n'est pas spécifié, RHI utilisera par défaut ce qu'il estime être le meilleur backend pour la plateforme.

Alternativement, si vous utilisez QQuickWindow, QQuickWindow::setGraphicsApi() peut être utilisé pour spécifier le backend de rendu interne de RHI.

AbstractRayCaster

Une classe de base abstraite pour le lancer de rayon dans les scènes 3D

AbstractTexture

Une classe de base à utiliser pour fournir des textures

AbstractTextureImage

Encapsule les informations nécessaires à la création d'une image de texture OpenGL

AlphaCoverage

Activer le mode multi-échantillonnage alpha-to-coverage

AlphaTest

Spécifie le test de référence alpha

BlendEquation

Spécifie l'équation utilisée pour l'équation de mélange RVB et l'équation de mélange alpha.

BlendEquationArguments

Encapsule les informations de mélange : spécifie comment les valeurs entrantes (ce qui va être dessiné) vont affecter les valeurs existantes (ce qui est déjà dessiné).

BlitFramebuffer

Le nœud FrameGraph permet de transférer un rectangle de valeurs de pixels d'une région d'une cible de rendu à une autre.

BufferCapture

Échange des données de la mémoire tampon entre le GPU et le CPU

Camera

Définit un point de vue à travers lequel la scène sera rendue

CameraLens

Fournit la matrice de projection utilisée pour définir une caméra pour une scène 3D

CameraSelector

Classe permettant de sélectionner la caméra à utiliser

ClearBuffers

Classe permettant d'effacer les tampons

ClipPlane

Active un plan d'écrêtage OpenGL supplémentaire qui peut être utilisé dans les shaders à l'aide de gl_ClipDistance

ColorMask

Permet de spécifier quelles composantes de couleur doivent être écrites dans le tampon d'image actuellement lié

ComputeCommand

Composant permettant d'effectuer du travail pour le shader de calcul sur le GPU

CullFace

Le type spécifie si l'élimination des faces avant ou arrière est activée

DebugOverlay

Active une superposition visuelle avec les détails de la scène

DepthRange

Permet le remappage des valeurs de profondeur écrites dans le tampon de profondeur

DepthTest

Le type teste la valeur de profondeur du nuanceur de fragment par rapport à la profondeur d'un échantillon en cours d'écriture.

DirectionalLight

Encapsuler un objet Lumière directionnelle dans une scène Qt 3D

DispatchCompute

Nœud FrameGraph pour émettre du travail pour le shader de calcul sur le GPU

Dithering

Activer le tramage

Effect

Classe de base pour les effets dans une scène Qt 3D

EnvironmentLight

Encapsule un objet de lumière environnementale dans une scène Qt 3D

FilterKey

Stocke les clés de filtre et leurs valeurs

FrameGraphNode

Classe de base de tous les nœuds de configuration FrameGraph

FrontFace

Le type définit les polygones frontaux et dorsaux

FrustumCulling

Active l'élimination des frustes pour le FrameGraph

GeometryRenderer

Encapsule le rendu de la géométrie

GraphicsApiFilter

Pour OpenGL, identifie l'API requise pour la technique attachée

Layer

Permet de filtrer les entités qui seront rendues

LayerFilter

Contrôle les couches dessinées dans une branche du FrameGraph

LevelOfDetail

Moyen de contrôler la complexité des entités rendues en fonction de leur taille à l'écran

LevelOfDetailLoader

Un chargeur d'entités qui change en fonction de la distance à la caméra ou de la taille de l'écran

LevelOfDetailSwitch

Permet d'activer les entités enfants en fonction de la distance ou de la taille de l'écran

Light

Encapsuler un objet QAbstractLight dans une scène Qt 3D

LineWidth

Spécifie la largeur des lignes tramées

Material

Base abstraite non créable pour les matériaux

MemoryBarrier

Classe permettant de placer une barrière mémoire

Mesh

Un chargeur de maillage personnalisé

MultiSampleAntiAliasing

Activer l'anti-crénelage multi-échantillon

NoDepthMask

Désactiver l'écriture de la profondeur

NoDraw

Lorsqu'un noeud NoDraw est présent dans une branche FrameGraph, cela empêche le moteur de rendu d'effectuer le rendu d'une primitive.

NoPicking

Lorsqu'un noeud NoPicking est présent dans une branche FrameGraph, cela empêche le moteur de rendu d'effectuer une sélection de picking pour la branche en question.

ObjectPicker

Instancie un composant qui peut être utilisé pour interagir avec une entité par un processus connu sous le nom de sélection.

Parameter

Fournit un espace de stockage pour une paire nom/valeur. Cela correspond à un uniforme de shader

PickEvent

Contient des informations lorsqu'un objet est prélevé. Cette information est reçue en tant que paramètre dans la plupart des signaux du composant QObjectPicker lorsque le prélèvement est réussi.

PickLineEvent

Détient des informations lorsqu'un segment d'une ligne est prélevé.

PickPointEvent

Détient des informations lorsqu'un segment d'un nuage de points est prélevé

PickTriangleEvent

Détient des informations lorsqu'un triangle est prélevé

PickingProxy

Peut être utilisé pour fournir un GeometryView alternatif utilisé uniquement pour le prélèvement

PickingSettings

Spécifie comment le prélèvement d'entités est géré

PointLight

Encapsuler un objet Point Light dans une scène Qt 3D

PointSize

Spécifie la taille des points tramés. Elle peut être définie de manière statique ou par des programmes de shaders.

PolygonOffset

Type définit l'échelle et les étapes de calcul des valeurs de profondeur pour les décalages de polygones.

ProximityFilter

Sélectionne les entités qui se trouvent dans un certain seuil de distance par rapport à une entité cible.

RasterMode

L'état de rendu permet de contrôler le type de tramage à effectuer.

RayCaster

Utilisé pour effectuer des tests de lancer de rayon en coordonnées du monde 3D

RenderCapabilities

La classe QRenderCapabilities contient les paramètres relatifs aux moteurs de rendu disponibles.

RenderCapture

Capture du rendu

RenderCaptureReply

Reçoit le résultat de la capture du rendu

RenderPass

Encapsule une passe de rendu

RenderPassFilter

Fournit un espace de stockage pour les vecteurs de clés et de paramètres de filtre

RenderSettings

Le type contient les paramètres liés au processus de rendu et héberge le FrameGraph actif.

RenderState

Un type de base abstrait pour tous les états de rendu

RenderStateSet

Le nœud FrameGraph permet de spécifier un ensemble d'objets RenderState à appliquer lors de l'exécution d'une branche FrameGraph.

RenderSurfaceSelector

Permet de spécifier la surface de rendu

RenderTarget

Encapsule une cible (généralement un objet de tampon d'image) dans laquelle le moteur de rendu peut effectuer le rendu

RenderTargetOutput

Le type permet de spécifier l'attachement d'une cible de rendu (qu'il s'agisse d'une texture de couleur, d'une texture de profondeur, etc... )

RenderTargetSelector

Fournit un moyen de spécifier une cible de rendu

SceneLoader

Permet de charger une scène existante.

ScissorTest

Le type élimine les fragments qui tombent en dehors d'une certaine partie rectangulaire de l'écran.

ScreenRayCaster

Effectue un test de lancer de rayon basé sur les coordonnées de l'écran

SeamlessCubemap

Permet un filtrage transparent des textures cubemap

ShaderImage

Fournit un accès par image aux programmes de shaders

ShaderProgram

Encapsule un programme de nuanceurs

ShaderProgramBuilder

Génère le contenu d'un programme de shaders à partir de graphiques chargés

SharedGLTexture

Permet d'utiliser un textureId d'un contexte OpenGL séparé dans une scène Qt 3D

SortPolicy

Fournit un espace de stockage pour les types de tri à utiliser

SpotLight

Encapsule un objet Spot Light dans une scène Qt 3D

StencilMask

Le type contrôle l'écriture avant et arrière des bits individuels dans les plans du pochoir.

StencilOperation

Le type spécifie le fonctionnement du pochoir

StencilOperationArguments

Type définit les actions à entreprendre lorsque les tests de stencil et de profondeur échouent

StencilTest

Type spécifie les arguments pour le test du pochoir

StencilTestArguments

Type spécifie les arguments pour le test du pochoir

SubtreeEnabler

Active ou désactive des sous-arbres entiers de nœuds du graphe de trame

Technique

Encapsule une technique

TechniqueFilter

Un FrameGraphNode utilisé pour sélectionner les techniques utilisées

Texture1D

Une texture abstraite avec un format cible Target1D

Texture1DArray

Une texture abstraite avec un format cible Target1DArray

Texture2D

Une texture abstraite avec un format cible Target2D

Texture2DArray

Une texture abstraite avec un format cible Target2DArray

Texture2DMultisample

Une texture abstraite avec un format cible Target2DMultisample

Texture2DMultisampleArray

Une texture abstraite avec le format cible Target2DMultisampleArray

Texture3D

Une texture abstraite avec un format cible Target3D

TextureBuffer

Une texture abstraite avec un format cible TargetBuffer

TextureCubeMap

Une texture abstraite avec un format de cible TargetCubeMap

TextureCubeMapArray

Une texture abstraite avec un format cible TargetCubeMapArray

TextureImage

Encapsule les informations nécessaires pour créer une image de texture OpenGL à partir d'une source d'image

TextureLoader

Gère le chargement de la texture et la définition de ses propriétés.

TextureRectangle

Une AbstractTexture avec un format cible TargetRectangle

Viewport

Un point de vue sur la scène Qt3D

levelOfDetailBoundingSphere

Le type QML fournit un volume sphérique simple, défini par son centre et son rayon.

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