Qt3DCore::QAttribute Class
class Qt3DCore::QAttributeDefiniert ein Attribut und legt fest, wie Daten aus einem „ QBuffer “ ausgelesen werden sollen. Mehr dazu...
| Header: | #include <Qt3DCore/QAttribute> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3DCore) target_link_libraries(mytarget PRIVATE Qt6::3DCore) |
| qmake: | QT += 3dcore |
| In QML: | Attribute |
| Erbt von: | Qt3DCore::QNode |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Typen
| enum | AttributeType { VertexAttribute, IndexAttribute, DrawIndirectAttribute } |
| enum | VertexBaseType { Byte, UnsignedByte, Short, UnsignedShort, Int, …, Double } |
Eigenschaften
|
|
Öffentliche Funktionen
| 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 |
Öffentliche Slots
| 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) |
Signale
| 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) |
Statische öffentliche Mitglieder
| QString | defaultColorAttributeName() |
| QString | defaultJointIndicesAttributeName() |
| QString | defaultJointWeightsAttributeName() |
| QString | defaultNormalAttributeName() |
| QString | defaultPositionAttributeName() |
| QString | defaultTangentAttributeName() |
| QString | defaultTextureCoordinate1AttributeName() |
| QString | defaultTextureCoordinate2AttributeName() |
| QString | defaultTextureCoordinateAttributeName() |
Verwandte Nicht-Mitglieder
Detaillierte Beschreibung
Es gibt drei Arten von Attributen.
- VertexAttribute: dienen zur Definition von Daten, die pro Scheitelpunkt gelesen werden sollen
- IndexAttribute: dienen zur Definition von Vertex-Indizes, wenn indizierte Draw-Aufrufe verwendet werden sollen
- DrawIndirectAttribute: dient zur Angabe des „DrawIndirect“-Puffers, der bei der Verwendung von indirekten Draw-Aufrufen verwendet werden soll
Hinweis: Wenn ein Attribut vom Typ „ DrawIndirectAttribute “ ist, sind nur „count“, „stride“ und „offset“ relevant.
Wenn Sie eigene Attribute bereitstellen, kann es sinnvoll sein, Ihr Attribut mithilfe von Hilfsfunktionen wie „ QAttribute::defaultPositionAttributeName()“ zu benennen, da dies sicherstellt, dass Ihre Geometrie mit dem Picking und den verschiedenen im Modul „ Qt3DExtras “ bereitgestellten Materialien kompatibel ist.
Siehe auch „ QBuffer “.
Dokumentation zu Mitgliedstypen
enum QAttribute::AttributeType
Der Typ des Attributs.
| Konstante | Wert |
|---|---|
Qt3DCore::QAttribute::VertexAttribute | 0 |
Qt3DCore::QAttribute::IndexAttribute | 1 |
Qt3DCore::QAttribute::DrawIndirectAttribute | 2 |
enum QAttribute::VertexBaseType
Der Datentyp.
| Konstante | Wert |
|---|---|
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 |
Eigenschaftsdokumentation
attributeType : AttributeType
Enthält den Attributtyp.
Zugriffsfunktionen:
| Qt3DCore::QAttribute::AttributeType | attributeType() const |
| void | setAttributeType(Qt3DCore::QAttribute::AttributeType attributeType) |
Benachrichtigungssignal:
| void | attributeTypeChanged(Qt3DCore::QAttribute::AttributeType attributeType) |
buffer : Qt3DCore::QBuffer*
Enthält den Puffer.
Zugriffsfunktionen:
| Qt3DCore::QBuffer * | buffer() const |
| void | setBuffer(Qt3DCore::QBuffer *buffer) |
Benachrichtigungssignal:
| void | bufferChanged(Qt3DCore::QBuffer *buffer) |
byteOffset : uint
Enthält den Byte-Offset.
Zugriffsfunktionen:
| uint | byteOffset() const |
| void | setByteOffset(uint byteOffset) |
Benachrichtigungssignal:
| void | byteOffsetChanged(uint byteOffset) |
byteStride : uint
Enthält den Byte-Schritt.
Zugriffsfunktionen:
| uint | byteStride() const |
| void | setByteStride(uint byteStride) |
Benachrichtigungssignal:
| void | byteStrideChanged(uint byteStride) |
count : uint
Speichert den Zählwert.
Zugriffsfunktionen:
| uint | count() const |
| void | setCount(uint count) |
Benachrichtigungssignal:
| void | countChanged(uint count) |
[read-only] defaultColorAttributeName : const QString
Diese Eigenschaft enthält den Namen des Standard-Farbattributs.
Gibt den Namen des Standard-Farbattributs zurück: „vertexColor“.
Zugriffsfunktionen:
| QString | defaultColorAttributeName() | [see note below] |
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[read-only] defaultJointIndicesAttributeName : const QString
Diese Eigenschaft enthält den Namen des Standardattributs für Gelenkindizes.
Gibt den Namen des Standardattributs für Verbindungsindizes zurück: „vertexJointIndices“.
Zugriffsfunktionen:
| QString | defaultJointIndicesAttributeName() |
[read-only] defaultJointWeightsAttributeName : const QString
Diese Eigenschaft enthält den Namen des Standardattributs für Gelenkgewichte.
Gibt den Namen des Standardattributs für Gelenkgewichte zurück: „vertexJointWeights“.
Zugriffsfunktionen:
| QString | defaultJointWeightsAttributeName() |
[read-only] defaultNormalAttributeName : const QString
Diese Eigenschaft enthält den Namen des Standard-Normalattributs.
Gibt den Namen des Standard-Normalattributs zurück: „vertexNormal“.
Zugriffsfunktionen:
| QString | defaultNormalAttributeName() | [see note below] |
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[read-only] defaultPositionAttributeName : const QString
Diese Eigenschaft enthält den Namen des Standard-Positionsattributs.
Gibt den Namen des Standard-Positionsattributs zurück: „vertexPosition“.
Zugriffsfunktionen:
| QString | defaultPositionAttributeName() | [see note below] |
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[read-only] defaultTangentAttributeName : const QString
Diese Eigenschaft enthält den Namen des Standard-Tangentenattributs.
Gibt den Namen des Standard-Tangentenattributs zurück: „vertexTangent“.
Zugriffsfunktionen:
| QString | defaultTangentAttributeName() | [see note below] |
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[read-only] defaultTextureCoordinate1AttributeName : const QString
Diese Eigenschaft enthält den Namen des Standardattributs für die zweite Ebene der Texturkoordinaten.
Gibt den Namen des Standardattributs für die zweite Ebene der Texturkoordinaten zurück: „vertexTexCoord1“.
Zugriffsfunktionen:
| QString | defaultTextureCoordinate1AttributeName() |
[read-only] defaultTextureCoordinate2AttributeName : const QString
Diese Eigenschaft enthält den Namen des Standardattributs für die dritte Ebene der Texturkoordinaten.
Gibt den Namen des Standardattributs für die dritte Ebene der Texturkoordinaten zurück: „vertexTexCoord2“.
Zugriffsfunktionen:
| QString | defaultTextureCoordinate2AttributeName() |
[read-only] defaultTextureCoordinateAttributeName : const QString
Diese Eigenschaft enthält den Namen des Standardattributs für Texturkoordinaten.
Gibt den Namen des Standard-Texturkoordinatenattributs zurück: „vertexTexCoord“.
Zugriffsfunktionen:
| QString | defaultTextureCoordinateAttributeName() | [see note below] |
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
divisor : uint
Enthält den Divisor.
Zugriffsfunktionen:
| uint | divisor() const |
| void | setDivisor(uint divisor) |
Benachrichtigungssignal:
| void | divisorChanged(uint divisor) |
name : QString
Enthält den Namen.
Zugriffsfunktionen:
| QString | name() const |
| void | setName(const QString &name) |
Benachrichtigungssignal:
| void | nameChanged(const QString &name) |
vertexBaseType : VertexBaseType
Enthält den Datentyp.
Zugriffsfunktionen:
| Qt3DCore::QAttribute::VertexBaseType | vertexBaseType() const |
| void | setVertexBaseType(Qt3DCore::QAttribute::VertexBaseType type) |
Benachrichtigungssignal:
| void | vertexBaseTypeChanged(Qt3DCore::QAttribute::VertexBaseType vertexBaseType) |
vertexSize : uint
Gibt die Datengröße an; sie kann nur 1 bis 4 Einheiten (Skalaren und Vektoren), 9 Einheiten (3×3-Matrizen) oder 16 Einheiten (4×4-Matrizen) betragen.
Zugriffsfunktionen:
| uint | vertexSize() const |
| void | setVertexSize(uint size) |
Benachrichtigungssignal:
| void | vertexSizeChanged(uint vertexSize) |
Dokumentation der Mitgliedsfunktionen
[explicit] QAttribute::QAttribute(Qt3DCore::QNode *parent = nullptr)
Erstellt ein neues QAttribute mit der Eigenschaft „ 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)
Erstellt ein neues QAttribute aus buf von type, dataSize, count, offset und stride mit 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)
Erstellt ein neues QAttribute namens „ name “ aus „ buf “ von „ type “, „ dataSize “, „ count “, „ offset “ und „ stride “ mit „ parent “.
[signal] void QAttribute::dataSizeChanged(uint vertexSize)
Das Signal wird bei einer Änderung von „dataSize“ mit „ vertexSize “ ausgelöst.
[signal] void QAttribute::dataTypeChanged(Qt3DCore::QAttribute::VertexBaseType vertexBaseType)
Das Signal wird mit „ vertexBaseType “ ausgelöst, wenn sich der Datentyp geändert hat.
[static invokable] QString QAttribute::defaultColorAttributeName()
QAttribute::defaultColorAttributeName Gibt den Namen des Standardfarbattributs zurück
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Hinweis: Getter -Funktion für die Eigenschaft `defaultColorAttributeName`.
[static] QString QAttribute::defaultJointIndicesAttributeName()
QAttribute::defaultJointIndicesAttributeName Gibt den Namen des Standardattributs für Gelenkindizes zurück
Hinweis: Getter -Funktion für die Eigenschaft „defaultJointIndicesAttributeName“.
[static] QString QAttribute::defaultJointWeightsAttributeName()
QAttribute::defaultJointIndicesAttributeName Gibt den Namen des Standardattributs für Gelenkgewichte zurück
Hinweis: Getter -Funktion für die Eigenschaft „defaultJointWeightsAttributeName“.
[static invokable] QString QAttribute::defaultNormalAttributeName()
QAttribute::defaultNormalAttributeName Gibt den Namen des Standard-Normalattributs zurück
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Hinweis: Getter -Funktion für die Eigenschaft `defaultNormalAttributeName`.
[static invokable] QString QAttribute::defaultPositionAttributeName()
QAttribute::defaultPositionAttributeName Gibt den Namen des Standardpositionsattributs zurück
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Hinweis: Getter -Funktion für die Eigenschaft `defaultPositionAttributeName`.
[static invokable] QString QAttribute::defaultTangentAttributeName()
QAttribute::defaultTangentAttributeName Gibt den Namen des Standard-Tangentenattributs zurück
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Hinweis: Getter -Funktion für die Eigenschaft `defaultTangentAttributeName`.
[static] QString QAttribute::defaultTextureCoordinate1AttributeName()
QAttribute::defaultTextureCoordinate1AttributeName Gibt den Namen des Standardattributs für die zweite Ebene der Texturkoordinaten zurück
Hinweis: Getter -Funktion für die Eigenschaft „defaultTextureCoordinate1AttributeName“.
[static] QString QAttribute::defaultTextureCoordinate2AttributeName()
QAttribute::defaultTextureCoordinate2AttributeName Gibt den Namen des Standardattributs für die dritte Ebene der Texturkoordinaten zurück
Hinweis: Getter -Funktion für die Eigenschaft „defaultTextureCoordinate2AttributeName“.
[static invokable] QString QAttribute::defaultTextureCoordinateAttributeName()
QAttribute::defaultTextureCoordinateAttributeName Gibt den Namen des Standardattributs für Texturkoordinaten zurück
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Hinweis: Getter -Funktion für die Eigenschaft `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.
