Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

Qt3DCore::QAttribute Class

class Qt3DCore::QAttribute

Définit un attribut et la manière dont les données doivent être lues à partir d'un QBuffer. En savoir plus...

En-tête : #include <Qt3DCore/QAttribute>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake : QT += 3dcore
En QML : Attribute
Hérite de : Qt3DCore::QNode
Statut : Obsolète

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

Types publics

enum AttributeType { VertexAttribute, IndexAttribute, DrawIndirectAttribute }
enum VertexBaseType { Byte, UnsignedByte, Short, UnsignedShort, Int, …, Double }

Propriétés

Fonctions publiques

QAttribute(Qt3DCore::QNode *parent = nullptr)
QAttribute(Qt3DCore::QBuffer *buf, Qt3DCore::QAttribute::VertexBaseType type, uint dataSize, uint count, uint offset = 0, uint stride = 0, Qt3DCore::QNode *parent = nullptr)
QAttribute(Qt3DCore::QBuffer *buf, const QString &name, Qt3DCore::QAttribute::VertexBaseType type, uint dataSize, uint count, uint offset = 0, uint stride = 0, Qt3DCore::QNode *parent = nullptr)
Qt3DCore::QAttribute::AttributeType attributeType() const
Qt3DCore::QBuffer *buffer() const
uint byteOffset() const
uint byteStride() const
uint count() const
uint divisor() const
QString name() const
Qt3DCore::QAttribute::VertexBaseType vertexBaseType() const
uint vertexSize() const

Emplacements publics

void setAttributeType(Qt3DCore::QAttribute::AttributeType attributeType)
void setBuffer(Qt3DCore::QBuffer *buffer)
void setByteOffset(uint byteOffset)
void setByteStride(uint byteStride)
void setCount(uint count)
void setDivisor(uint divisor)
void setName(const QString &name)
void setVertexBaseType(Qt3DCore::QAttribute::VertexBaseType type)
void setVertexSize(uint size)

Signaux

void attributeTypeChanged(Qt3DCore::QAttribute::AttributeType attributeType)
void bufferChanged(Qt3DCore::QBuffer *buffer)
void byteOffsetChanged(uint byteOffset)
void byteStrideChanged(uint byteStride)
void countChanged(uint count)
void dataSizeChanged(uint vertexSize)
void dataTypeChanged(Qt3DCore::QAttribute::VertexBaseType vertexBaseType)
void divisorChanged(uint divisor)
void nameChanged(const QString &name)
void vertexBaseTypeChanged(Qt3DCore::QAttribute::VertexBaseType vertexBaseType)
void vertexSizeChanged(uint vertexSize)

Membres publics statiques

QString defaultColorAttributeName()
QString defaultJointIndicesAttributeName()
QString defaultJointWeightsAttributeName()
QString defaultNormalAttributeName()
QString defaultPositionAttributeName()
QString defaultTangentAttributeName()
QString defaultTextureCoordinate1AttributeName()
QString defaultTextureCoordinate2AttributeName()
QString defaultTextureCoordinateAttributeName()
QBufferPtr

Description détaillée

Il existe 3 types d'attributs.

  • VertexAttribute: utilisés pour définir les données à lire pour chaque sommet
  • IndexAttribute: utilisés pour définir les indices de sommets lorsque des appels de dessin indexés doivent être utilisés
  • DrawIndirectAttribute: sert à spécifier le tampon DrawIndirect à utiliser lorsque des appels de dessin indirects sont utilisés

Remarque : lorsqu’un attribut est de type DrawIndirectAttribute, seuls les paramètres « count », « stride » et « offset » sont pertinents.

Lorsque vous définissez vos propres attributs, il peut être judicieux de les nommer à l’aide de fonctions d’aide telles que ` QAttribute::defaultPositionAttributeName()`, car cela garantira la compatibilité de votre géométrie avec le picking et les différents matériaux fournis dans le module ` Qt3DExtras `.

Voir également QBuffer.

Documentation sur les types de membres

enum QAttribute::AttributeType

Le type de l'attribut.

ConstanteValeur
Qt3DCore::QAttribute::VertexAttribute0
Qt3DCore::QAttribute::IndexAttribute1
Qt3DCore::QAttribute::DrawIndirectAttribute2

enum QAttribute::VertexBaseType

Le type des données.

ConstanteValeur
Qt3DCore::QAttribute::Byte0
Qt3DCore::QAttribute::UnsignedByte1
Qt3DCore::QAttribute::Short2
Qt3DCore::QAttribute::UnsignedShort3
Qt3DCore::QAttribute::Int4
Qt3DCore::QAttribute::UnsignedInt5
Qt3DCore::QAttribute::HalfFloat6
Qt3DCore::QAttribute::Float7
Qt3DCore::QAttribute::Double8

Documentation sur les propriétés

attributeType : AttributeType

Contient le type d'attribut.

Fonctions d'accès :

Qt3DCore::QAttribute::AttributeType attributeType() const
void setAttributeType(Qt3DCore::QAttribute::AttributeType attributeType)

Signal de notification :

void attributeTypeChanged(Qt3DCore::QAttribute::AttributeType attributeType)

buffer : Qt3DCore::QBuffer*

Contient la mémoire tampon.

Fonctions d'accès :

Qt3DCore::QBuffer *buffer() const
void setBuffer(Qt3DCore::QBuffer *buffer)

Signal de notification :

void bufferChanged(Qt3DCore::QBuffer *buffer)

byteOffset : uint

Contient le décalage en octets.

Fonctions d'accès :

uint byteOffset() const
void setByteOffset(uint byteOffset)

Signal de notification :

void byteOffsetChanged(uint byteOffset)

byteStride : uint

Contient le pas d'octet.

Fonctions d'accès :

uint byteStride() const
void setByteStride(uint byteStride)

Signal de notification :

void byteStrideChanged(uint byteStride)

count : uint

Contient le compteur.

Fonctions d'accès :

uint count() const
void setCount(uint count)

Signal de notification :

void countChanged(uint count)

[read-only] defaultColorAttributeName : const QString

Cette propriété contient le nom de l'attribut de couleur par défaut.

Renvoie le nom de l'attribut de couleur par défaut : « vertexColor ».

Fonctions d'accès :

QString defaultColorAttributeName()[see note below]

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[read-only] defaultJointIndicesAttributeName : const QString

Cette propriété contient le nom de l'attribut par défaut des indices de jointure.

Renvoie le nom de l'attribut d'indices de jointure par défaut : « vertexJointIndices ».

Fonctions d'accès :

QString defaultJointIndicesAttributeName()

[read-only] defaultJointWeightsAttributeName : const QString

Cette propriété contient le nom de l'attribut par défaut des poids des articulations.

Renvoie le nom de l'attribut de poids des articulations par défaut : « vertexJointWeights ».

Fonctions d'accès :

QString defaultJointWeightsAttributeName()

[read-only] defaultNormalAttributeName : const QString

Cette propriété contient le nom de l'attribut de normale par défaut.

Renvoie le nom de l'attribut normal par défaut : « vertexNormal ».

Fonctions d'accès :

QString defaultNormalAttributeName()[see note below]

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[read-only] defaultPositionAttributeName : const QString

Cette propriété contient le nom de l'attribut de position par défaut.

Renvoie le nom de l’attribut de position par défaut : « vertexPosition ».

Fonctions d'accès :

QString defaultPositionAttributeName()[see note below]

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[read-only] defaultTangentAttributeName : const QString

Cette propriété contient le nom de l'attribut tangent par défaut.

Renvoie le nom de l'attribut tangent par défaut : « vertexTangent ».

Fonctions d'accès :

QString defaultTangentAttributeName()[see note below]

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[read-only] defaultTextureCoordinate1AttributeName : const QString

Cette propriété contient le nom de l'attribut par défaut de la deuxième couche de coordonnées de texture.

Renvoie le nom de l'attribut par défaut de la deuxième couche de coordonnées de texture : « vertexTexCoord1 ».

Fonctions d'accès :

QString defaultTextureCoordinate1AttributeName()

[read-only] defaultTextureCoordinate2AttributeName : const QString

Cette propriété contient le nom de l'attribut par défaut de la troisième couche de coordonnées de texture.

Renvoie le nom de l’attribut par défaut de la troisième couche de coordonnées de texture : « vertexTexCoord2 ».

Fonctions d'accès :

QString defaultTextureCoordinate2AttributeName()

[read-only] defaultTextureCoordinateAttributeName : const QString

Cette propriété contient le nom de l'attribut de coordonnées de texture par défaut.

Renvoie le nom de l'attribut de coordonnées de texture par défaut : « vertexTexCoord ».

Fonctions d'accès :

QString defaultTextureCoordinateAttributeName()[see note below]

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

divisor : uint

Contient le diviseur.

Fonctions d'accès :

uint divisor() const
void setDivisor(uint divisor)

Signal de notification :

void divisorChanged(uint divisor)

name : QString

Contient le nom.

Fonctions d'accès :

QString name() const
void setName(const QString &name)

Signal de notification :

void nameChanged(const QString &name)

vertexBaseType : VertexBaseType

Contient le type de données.

Fonctions d'accès :

Qt3DCore::QAttribute::VertexBaseType vertexBaseType() const
void setVertexBaseType(Qt3DCore::QAttribute::VertexBaseType type)

Signal de notification :

void vertexBaseTypeChanged(Qt3DCore::QAttribute::VertexBaseType vertexBaseType)

vertexSize : uint

Contient la taille des données ; elle ne peut être que de 1 à 4 unités (scalaires et vecteurs), 9 unités (matrices 3×3) ou 16 unités (matrices 4×4).

Fonctions d'accès :

uint vertexSize() const
void setVertexSize(uint size)

Signal de notification :

void vertexSizeChanged(uint vertexSize)

Documentation des fonctions membres

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

Crée un nouvel objet QAttribute avec parent.

[explicit] QAttribute::QAttribute(Qt3DCore::QBuffer *buf, Qt3DCore::QAttribute::VertexBaseType type, uint dataSize, uint count, uint offset = 0, uint stride = 0, Qt3DCore::QNode *parent = nullptr)

Crée un nouvel objet `QAttribute` à partir d'buf, qui sont respectivement issus de type, dataSize, count, offset et stride, avec parent.

[explicit] QAttribute::QAttribute(Qt3DCore::QBuffer *buf, const QString &name, Qt3DCore::QAttribute::VertexBaseType type, uint dataSize, uint count, uint offset = 0, uint stride = 0, Qt3DCore::QNode *parent = nullptr)

Crée un nouvel attribut QAttribute nommé « name » à partir de « buf » de « type », « dataSize », « count », « offset » et « stride » avec « parent ».

[signal] void QAttribute::dataSizeChanged(uint vertexSize)

Le signal est émis avec l'vertexSize lorsque la valeur de dataSize change.

[signal] void QAttribute::dataTypeChanged(Qt3DCore::QAttribute::VertexBaseType vertexBaseType)

Le signal est émis avec l'vertexBaseType lorsque le type de données change.

[static invokable] QString QAttribute::defaultColorAttributeName()

QAttribute::defaultColorAttributeName Renvoie le nom de l'attribut de couleur par défaut

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Remarque : fonctionde lecture pour la propriété defaultColorAttributeName.

[static] QString QAttribute::defaultJointIndicesAttributeName()

QAttribute::defaultJointIndicesAttributeName Renvoie le nom de l'attribut par défaut des indices de jointure

Remarque : fonctionde récupération pour la propriété defaultJointIndicesAttributeName.

[static] QString QAttribute::defaultJointWeightsAttributeName()

QAttribute::defaultJointIndicesAttributeName Renvoie le nom de l'attribut par défaut des poids des articulations

Remarque : fonctiongetter pour la propriété defaultJointWeightsAttributeName.

[static invokable] QString QAttribute::defaultNormalAttributeName()

QAttribute::defaultNormalAttributeName Renvoie le nom de l'attribut normal par défaut

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Remarque : fonctionde lecture pour la propriété defaultNormalAttributeName.

[static invokable] QString QAttribute::defaultPositionAttributeName()

QAttribute::defaultPositionAttributeName Renvoie le nom de l'attribut de position par défaut

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Remarque : Fonctiongetter pour la propriété defaultPositionAttributeName.

[static invokable] QString QAttribute::defaultTangentAttributeName()

QAttribute::defaultTangentAttributeName Renvoie le nom de l'attribut tangent par défaut

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Remarque : fonctionde lecture pour la propriété defaultTangentAttributeName.

[static] QString QAttribute::defaultTextureCoordinate1AttributeName()

QAttribute::defaultTextureCoordinate1AttributeName Renvoie le nom de l'attribut par défaut correspondant au deuxième niveau de coordonnées de texture

Remarque : fonctionde lecture pour la propriété defaultTextureCoordinate1AttributeName.

[static] QString QAttribute::defaultTextureCoordinate2AttributeName()

QAttribute::defaultTextureCoordinate2AttributeName Renvoie le nom de l'attribut par défaut correspondant à la troisième couche de coordonnées de texture

Remarque : fonctionde lecture pour la propriété defaultTextureCoordinate2AttributeName.

[static invokable] QString QAttribute::defaultTextureCoordinateAttributeName()

QAttribute::defaultTextureCoordinateAttributeName Renvoie le nom de l'attribut de coordonnées de texture par défaut

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Remarque : fonctiongetter pour la propriété defaultTextureCoordinateAttributeName.

Éléments non membres associés

QBufferPtr

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