Sur cette page

Qt3DRender::QGeometryRenderer Class

class Qt3DRender::QGeometryRenderer

Gère le rendu géométrique. En savoir plus...

En-tête : #include <qgeometryrenderer.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : GeometryRenderer
Hérite de : Qt3DCore::QBoundingVolume
Hérité par :

Qt3DExtras::QConeMesh, Qt3DExtras::QCuboidMesh, Qt3DExtras::QCylinderMesh, Qt3DExtras::QExtrudedTextMesh, Qt3DExtras::QPlaneMesh, Qt3DExtras::QSphereMesh, Qt3DExtras::QTorusMesh, et Qt3DRender::QMesh

Statut : Obsolète

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Types publics

enum PrimitiveType { Points, Lines, LineLoop, LineStrip, Triangles, …, Patches }

Propriétés

Fonctions publiques

QGeometryRenderer(Qt3DCore::QNode *parent = nullptr)
int firstInstance() const
int firstVertex() const
Qt3DCore::QGeometry *geometry() const
int indexBufferByteOffset() const
int indexOffset() const
int instanceCount() const
bool primitiveRestartEnabled() const
Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType() const
int restartIndexValue() const
float sortIndex() const
int vertexCount() const
int verticesPerPatch() const

Emplacements publics

void setFirstInstance(int firstInstance)
void setFirstVertex(int firstVertex)
void setGeometry(Qt3DCore::QGeometry *geometry)
void setIndexBufferByteOffset(int offset)
void setIndexOffset(int indexOffset)
void setInstanceCount(int instanceCount)
void setPrimitiveRestartEnabled(bool enabled)
void setPrimitiveType(Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType)
void setRestartIndexValue(int index)
void setSortIndex(float sortIndex)
void setVertexCount(int vertexCount)
void setVerticesPerPatch(int verticesPerPatch)

Signaux

void firstInstanceChanged(int firstInstance)
void firstVertexChanged(int firstVertex)
void geometryChanged(Qt3DCore::QGeometry *geometry)
void indexBufferByteOffsetChanged(int offset)
void indexOffsetChanged(int indexOffset)
void instanceCountChanged(int instanceCount)
void primitiveRestartEnabledChanged(bool primitiveRestartEnabled)
void primitiveTypeChanged(Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType)
void restartIndexValueChanged(int restartIndexValue)
void sortIndexChanged(float sortIndex)
void vertexCountChanged(int vertexCount)
void verticesPerPatchChanged(int verticesPerPatch)

Description détaillée

Un objet ` Qt3DRender::QGeometryRenderer ` contient toutes les informations nécessaires au tracé d'une ` Qt3DCore::QGeometry`. Un objet `QGeometry` contient les coordonnées des données géométriques ; `QGeometryRenderer` spécifie comment interpréter ces données.

Documentation sur les types de membres

enum QGeometryRenderer::PrimitiveType

Le type de la primitive.

ConstanteValeurDescription
Qt3DRender::QGeometryRenderer::Points0x0000Liste de points
Qt3DRender::QGeometryRenderer::Lines0x0001Liste de lignes
Qt3DRender::QGeometryRenderer::LineLoop0x0002Groupe de lignes connectées par leurs extrémités formant une boucle
Qt3DRender::QGeometryRenderer::LineStrip0x0003Groupe de lignes connectées
Qt3DRender::QGeometryRenderer::Triangles0x0004Liste des triangles
Qt3DRender::QGeometryRenderer::TriangleStrip0x0005Liste des triangles connectés
Qt3DRender::QGeometryRenderer::TriangleFan0x0006Liste des triangles connectés dont tous les triangles partagent le premier sommet
Qt3DRender::QGeometryRenderer::LinesAdjacency0x000APermet au shader géométrique d'accéder aux lignes adjacentes dans une liste de lignes
Qt3DRender::QGeometryRenderer::TrianglesAdjacency0x000CPermet au shader de géométrie d'accéder aux triangles adjacents dans une liste de triangles
Qt3DRender::QGeometryRenderer::LineStripAdjacency0x000BPermet au shader géométrique d'accéder aux lignes adjacentes dans une bande de lignes
Qt3DRender::QGeometryRenderer::TriangleStripAdjacency0x000DPermet au shader géométrique d'accéder aux triangles adjacents dans une bande de triangles
Qt3DRender::QGeometryRenderer::Patches0x000ESeul type de primitive accepté par le shader de tessellation, où un patch est constitué d’un nombre arbitraire de sommets

Documentation des propriétés

firstInstance : int

Contient l'instance de base.

Fonctions d'accès :

int firstInstance() const
void setFirstInstance(int firstInstance)

Signal de notification :

void firstInstanceChanged(int firstInstance)

firstVertex : int

Contient le sommet de base.

Fonctions d'accès :

int firstVertex() const
void setFirstVertex(int firstVertex)

Signal de notification :

void firstVertexChanged(int firstVertex)

geometry : Qt3DCore::QGeometry*

Contient la géométrie.

Fonctions d'accès :

Qt3DCore::QGeometry *geometry() const
void setGeometry(Qt3DCore::QGeometry *geometry)

Signal de notification :

void geometryChanged(Qt3DCore::QGeometry *geometry)

indexBufferByteOffset : int

Contient le décalage en octets dans le tampon d'index.

Fonctions d'accès :

int indexBufferByteOffset() const
void setIndexBufferByteOffset(int offset)

Signal de notification :

void indexBufferByteOffsetChanged(int offset)

indexOffset : int

Contient le sommet de base.

Fonctions d'accès :

int indexOffset() const
void setIndexOffset(int indexOffset)

Signal de notification :

void indexOffsetChanged(int indexOffset)

instanceCount : int

Contient le nombre d'instances.

Fonctions d'accès :

int instanceCount() const
void setInstanceCount(int instanceCount)

Signal de notification :

void instanceCountChanged(int instanceCount)

primitiveRestartEnabled : bool

Contient l'indicateur de redémarrage de la primitive.

Fonctions d'accès :

bool primitiveRestartEnabled() const
void setPrimitiveRestartEnabled(bool enabled)

Signal de notification :

void primitiveRestartEnabledChanged(bool primitiveRestartEnabled)

primitiveType : PrimitiveType

Contient le type primitif.

Fonctions d'accès :

Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType() const
void setPrimitiveType(Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType)

Signal de notification :

void primitiveTypeChanged(Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType)

restartIndexValue : int

Contient l'index de redémarrage.

Fonctions d'accès :

int restartIndexValue() const
void setRestartIndexValue(int index)

Signal de notification :

void restartIndexValueChanged(int restartIndexValue)

[since 6.0] sortIndex : float

Remplace l'index de tri lorsque le tri en profondeur est activé.

Si le tri en profondeur est activé dans le graphe de trame, le moteur de rendu triera les objets en fonction de la distance entre le centre du volume englobant et la caméra, et les affichera du plus éloigné au plus proche.

Cette propriété permet de remplacer l'index de profondeur et de contrôler avec précision l'ordre de rendu des objets. Cela s'avère utile lorsque tous les objets se trouvent à la même distance physique de la caméra.

Les valeurs réelles n’ont pas d’importance ; elles servent uniquement à définir un ordre de tri des objets. Ceux-ci sont triés de telle sorte que l’objet ayant la plus petite valeur soit affiché en premier, puis le deuxième plus petit, et ainsi de suite.

Remarque : définir cette valeur sur -1.f désactive le tri explicite pour cette entité et rétablit l’utilisation de la distance par rapport au centre du volume englobant.

Cette énumération a été introduite dans Qt 6.0.

Fonctions d'accès :

float sortIndex() const
void setSortIndex(float sortIndex)

Signal de notification :

void sortIndexChanged(float sortIndex)

Voir aussi Qt3DRender::QSortPolicy.

vertexCount : int

Contient le nombre de primitives.

Fonctions d'accès :

int vertexCount() const
void setVertexCount(int vertexCount)

Signal de notification :

void vertexCountChanged(int vertexCount)

verticesPerPatch : int

Contient les sommets de chaque patch.

Fonctions d'accès :

int verticesPerPatch() const
void setVerticesPerPatch(int verticesPerPatch)

Signal de notification :

void verticesPerPatchChanged(int verticesPerPatch)

Documentation des fonctions membres

[explicit] QGeometryRenderer::QGeometryRenderer(Qt3DCore::QNode *parent = nullptr)

Crée un nouvel objet `QGeometryRenderer` avec ` parent`.

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