Qt3DCore::QAttribute Class
class Qt3DCore::QAttributeDéfinit un attribut et la manière dont les données doivent être lues à partir d'un site QBuffer. 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 : | Qt3DCore::QNode |
| Statut : | Déclassé |
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() |
Non-membres apparentés
Description détaillée
Il existe 3 types d'attributs.
- VertexAttributeAttributs de sommet : utilisés pour définir les données à lire pour chaque sommet.
- IndexAttributeAttributs d'indexation : utilisés pour définir les index des sommets lorsque des appels de dessin indexés doivent être utilisés.
- DrawIndirectAttributeAttribut DrawIndirect : utilisé pour spécifier le tampon DrawIndirect à utiliser lorsque des appels de dessin indirects doivent être utilisés.
Remarque : lorsqu'un attribut est de type DrawIndirectAttribute, seuls count, stride et offset sont pertinents.
Lorsque vous fournissez vos propres attributs, il peut être judicieux de les nommer à l'aide d'aides telles que QAttribute::defaultPositionAttributeName(), car cela garantira la compatibilité de votre géométrie avec la sélection et les différents matériaux fournis dans le module Qt3DExtras.
Voir aussi QBuffer.
Documentation sur les types de membres
enum QAttribute::AttributeType
Le type de l'attribut.
| Constante | Valeur |
|---|---|
Qt3DCore::QAttribute::VertexAttribute | 0 |
Qt3DCore::QAttribute::IndexAttribute | 1 |
Qt3DCore::QAttribute::DrawIndirectAttribute | 2 |
enum QAttribute::VertexBaseType
Le type de données.
| Constante | Valeur |
|---|---|
Qt3DCore::QAttribute::Byte | 0 |
Qt3DCore::QAttribute::UnsignedByte | 1 |
Qt3DCore::QAttribute::Short | 2 |
Qt3DCore::QAttribute::UnsignedShort | 3 |
Qt3DCore::QAttribute::Int | 4 |
Qt3DCore::QAttribute::UnsignedInt | 5 |
Qt3DCore::QAttribute::HalfFloat | 6 |
Qt3DCore::QAttribute::Float | 7 |
Qt3DCore::QAttribute::Double | 8 |
Propriété Documentation
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*
Tient 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 d'un octet.
Fonctions d'accès :
| uint | byteOffset() const |
| void | setByteOffset(uint byteOffset) |
Signal de notification :
| void | byteOffsetChanged(uint byteOffset) |
byteStride : uint
Contient la chaîne d'octets.
Fonctions d'accès :
| uint | byteStride() const |
| void | setByteStride(uint byteStride) |
Signal de notification :
| void | byteStrideChanged(uint byteStride) |
count : uint
Tient le compte.
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] |
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[read-only] defaultJointIndicesAttributeName : const QString
Cette propriété contient le nom de l'attribut des indices de jointure par défaut.
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 de poids par défaut de l'articulation.
Renvoie le nom de l'attribut de poids des joints par défaut : "vertexJointWeights".
Fonctions d'accès :
| QString | defaultJointWeightsAttributeName() |
[read-only] defaultNormalAttributeName : const QString
Cette propriété contient le nom de l'attribut normal par défaut.
Renvoie le nom de l'attribut normal par défaut : "vertexNormal".
Fonctions d'accès :
| QString | defaultNormalAttributeName() | [see note below] |
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de 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] |
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de 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] |
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[read-only] defaultTextureCoordinate1AttributeName : const QString
Cette propriété contient le nom de l'attribut par défaut pour 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] |
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de 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 3x3) ou 16 unités (matrices 4x4).
Fonctions d'accès :
| uint | vertexSize() const |
| void | setVertexSize(uint size) |
Signal de notification :
| void | vertexSizeChanged(uint vertexSize) |
Member Function Documentation
[explicit] QAttribute::QAttribute(Qt3DCore::QNode *parent = nullptr)
Construit un nouveau 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)
Construit un nouveau QAttribute à partir de buf 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)
Construit un nouveau 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 à l'adresse vertexSize lorsque la taille des données change.
[signal] void QAttribute::dataTypeChanged(Qt3DCore::QAttribute::VertexBaseType vertexBaseType)
Le signal est émis à l'adresse vertexBaseType lorsque le type de données a changé.
[static invokable] QString QAttribute::defaultColorAttributeName()
QAttribute::defaultColorAttributeName Renvoie le nom de l'attribut de couleur par défaut.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Note : Fonction Getter pour la propriété defaultColorAttributeName.
[static] QString QAttribute::defaultJointIndicesAttributeName()
QAttribute::defaultJointIndicesAttributeName Renvoie le nom de l'attribut par défaut des indices de jointure.
Note : Fonction Getter pour la propriété defaultJointIndicesAttributeName.
[static] QString QAttribute::defaultJointWeightsAttributeName()
QAttribute::defaultJointIndicesAttributeName Renvoie le nom de l'attribut par défaut des poids des articulations
Note : Fonction Getter 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 invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Note : Fonction Getter 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 invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Note : Fonction Getter 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 invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Note : Fonction Getter pour la propriété defaultTangentAttributeName.
[static] QString QAttribute::defaultTextureCoordinate1AttributeName()
QAttribute::defaultTextureCoordinate1AttributeName Renvoie le nom de l'attribut par défaut pour la deuxième couche de coordonnées de texture.
Note : Fonction Getter pour la propriété defaultTextureCoordinate1AttributeName.
[static] QString QAttribute::defaultTextureCoordinate2AttributeName()
QAttribute::defaultTextureCoordinate2AttributeName Renvoie le nom de l'attribut par défaut pour la troisième couche de coordonnées de texture.
Note : Fonction Getter 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 invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Remarque : fonction Getter pour la propriété defaultTextureCoordinateAttributeName.
© 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.
