En esta página

Qt3DCore::QAttribute Class

class Qt3DCore::QAttribute

Define un atributo y cómo deben leerse los datos de un QBuffer. Más información...

Encabezado: #include <Qt3DCore/QAttribute>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
En QML: Attribute
Heredado de: Qt3DCore::QNode
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Tipos públicos

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

Propiedades

Funciones públicas

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

Ranuras públicas

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)

Señales

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)

Miembros públicos estáticos

Descripción detallada

Hay tres tipos de atributos.

  • VertexAttribute: se utilizan para definir los datos que se van a leer por vértice
  • IndexAttribute: se utilizan para definir los índices de vértices cuando se van a utilizar llamadas de dibujo indexadas
  • DrawIndirectAttribute: se utilizan para especificar el búfer DrawIndirect que se empleará cuando se utilicen llamadas de dibujo indirectas

Nota: cuando un atributo es de tipo DrawIndirectAttribute, solo son relevantes «count», «stride» y «offset».

Al proporcionar tus propios atributos, puede ser conveniente nombrarlos utilizando funciones auxiliares como ` QAttribute::defaultPositionAttributeName()`, ya que así te asegurarás de que tu geometría sea compatible con la selección y con los diversos materiales proporcionados en el módulo ` Qt3DExtras `.

Véase también QBuffer.

Documentación sobre tipos de miembros

enum QAttribute::AttributeType

El tipo del atributo.

ConstanteValor
Qt3DCore::QAttribute::VertexAttribute0
Qt3DCore::QAttribute::IndexAttribute1
Qt3DCore::QAttribute::DrawIndirectAttribute2

enum QAttribute::VertexBaseType

El tipo de los datos.

ConstanteValor
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

Documentación de la propiedad

attributeType : AttributeType

Contiene el tipo de atributo.

Funciones de acceso:

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

Señal de notificación:

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

buffer : Qt3DCore::QBuffer*

Almacena el búfer.

Funciones de acceso:

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

Señal de notificación:

void bufferChanged(Qt3DCore::QBuffer *buffer)

byteOffset : uint

Almacena el desplazamiento en bytes.

Funciones de acceso:

uint byteOffset() const
void setByteOffset(uint byteOffset)

Señal de notificación:

void byteOffsetChanged(uint byteOffset)

byteStride : uint

Almacena el paso de bytes.

Funciones de acceso:

uint byteStride() const
void setByteStride(uint byteStride)

Señal del notificador:

void byteStrideChanged(uint byteStride)

count : uint

Guarda el recuento.

Funciones de acceso:

uint count() const
void setCount(uint count)

Señal de notificación:

void countChanged(uint count)

[read-only] defaultColorAttributeName : const QString

Esta propiedad contiene el nombre del atributo de color predeterminado.

Devuelve el nombre del atributo de color predeterminado: «vertexColor».

Funciones de acceso:

QString defaultColorAttributeName()[see note below]

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[read-only] defaultJointIndicesAttributeName : const QString

Esta propiedad contiene el nombre del atributo predeterminado de índices de articulaciones.

Devuelve el nombre del atributo predeterminado de índices de unión: «vertexJointIndices».

Funciones de acceso:

[read-only] defaultJointWeightsAttributeName : const QString

Esta propiedad contiene el nombre del atributo predeterminado de pesos de articulaciones.

Devuelve el nombre del atributo predeterminado de pesos de articulaciones: «vertexJointWeights».

Funciones de acceso:

[read-only] defaultNormalAttributeName : const QString

Esta propiedad contiene el nombre del atributo de normal predeterminado.

Devuelve el nombre del atributo normal por defecto: «vertexNormal».

Funciones de acceso:

QString defaultNormalAttributeName()[see note below]

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[read-only] defaultPositionAttributeName : const QString

Esta propiedad contiene el nombre del atributo de posición predeterminado.

Devuelve el nombre del atributo de posición predeterminado: «vertexPosition».

Funciones de acceso:

QString defaultPositionAttributeName()[see note below]

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[read-only] defaultTangentAttributeName : const QString

Esta propiedad contiene el nombre del atributo tangente por defecto.

Devuelve el nombre del atributo tangente por defecto: «vertexTangent».

Funciones de acceso:

QString defaultTangentAttributeName()[see note below]

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[read-only] defaultTextureCoordinate1AttributeName : const QString

Esta propiedad contiene el nombre del atributo predeterminado para la segunda capa de coordenadas de textura.

Devuelve el nombre del atributo predeterminado para la segunda capa de coordenadas de textura: «vertexTexCoord1».

Funciones de acceso:

[read-only] defaultTextureCoordinate2AttributeName : const QString

Esta propiedad contiene el nombre del atributo predeterminado para la tercera capa de coordenadas de textura.

Devuelve el nombre del atributo predeterminado de la tercera capa de coordenadas de textura: «vertexTexCoord2».

Funciones de acceso:

[read-only] defaultTextureCoordinateAttributeName : const QString

Esta propiedad contiene el nombre del atributo de coordenadas de textura predeterminado.

Devuelve el nombre del atributo de coordenadas de textura predeterminado: «vertexTexCoord».

Funciones de acceso:

QString defaultTextureCoordinateAttributeName()[see note below]

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

divisor : uint

Almacena el divisor.

Funciones de acceso:

uint divisor() const
void setDivisor(uint divisor)

Señal de notificación:

void divisorChanged(uint divisor)

name : QString

Contiene el nombre.

Funciones de acceso:

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

Señal de notificación:

void nameChanged(const QString &name)

vertexBaseType : VertexBaseType

Almacena el tipo de datos.

Funciones de acceso:

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

Señal de notificación:

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

vertexSize : uint

Almacena el tamaño de los datos; solo puede ser de 1 a 4 unidades (escalares y vectores), 9 unidades (matrices de 3x3) o 16 unidades (matrices de 4x4).

Funciones de acceso:

uint vertexSize() const
void setVertexSize(uint size)

Señal de notificación:

void vertexSizeChanged(uint vertexSize)

Documentación de las funciones de miembro

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

Crea un nuevo objeto `QAttribute` con ` 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)

Crea un nuevo QAttribute a partir de un objeto « buf » de « type », « », « dataSize », « count », « offset » y « stride » con « 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)

Crea un nuevo QAttribute denominado « name » a partir de « buf » de « type », « dataSize », « count », « offset » y « stride » con « parent ».

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

La señal se emite mediante un evento « vertexSize » cuando cambia el valor de «dataSize».

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

La señal se emite con el evento « vertexBaseType » cuando cambia el tipo de datos.

[static invokable] QString QAttribute::defaultColorAttributeName()

QAttribute::defaultColorAttributeName Devuelve el nombre del atributo de color predeterminado

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Nota: Funcióngetter para la propiedad defaultColorAttributeName.

[static] QString QAttribute::defaultJointIndicesAttributeName()

QAttribute::defaultJointIndicesAttributeName Devuelve el nombre del atributo predeterminado de índices de articulaciones

Nota: Funcióngetter para la propiedad defaultJointIndicesAttributeName.

[static] QString QAttribute::defaultJointWeightsAttributeName()

QAttribute::defaultJointIndicesAttributeName Devuelve el nombre del atributo predeterminado de pesos de las articulaciones

Nota: Funcióngetter para la propiedad defaultJointWeightsAttributeName.

[static invokable] QString QAttribute::defaultNormalAttributeName()

QAttribute::defaultNormalAttributeName Devuelve el nombre del atributo «normal» predeterminado

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Nota: Funcióngetter para la propiedad defaultNormalAttributeName.

[static invokable] QString QAttribute::defaultPositionAttributeName()

QAttribute::defaultPositionAttributeName Devuelve el nombre del atributo de posición predeterminada

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Nota: Funcióngetter para la propiedad defaultPositionAttributeName.

[static invokable] QString QAttribute::defaultTangentAttributeName()

QAttribute::defaultTangentAttributeName Devuelve el nombre del atributo tangente por defecto

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Nota: Funcióngetter para la propiedad defaultTangentAttributeName.

[static] QString QAttribute::defaultTextureCoordinate1AttributeName()

QAttribute::defaultTextureCoordinate1AttributeName Devuelve el nombre del atributo predeterminado para la segunda capa de coordenadas de textura

Nota: Funcióngetter para la propiedad defaultTextureCoordinate1AttributeName.

[static] QString QAttribute::defaultTextureCoordinate2AttributeName()

QAttribute::defaultTextureCoordinate2AttributeName Devuelve el nombre del atributo predeterminado para la tercera capa de coordenadas de textura

Nota: Funcióngetter para la propiedad defaultTextureCoordinate2AttributeName.

[static invokable] QString QAttribute::defaultTextureCoordinateAttributeName()

QAttribute::defaultTextureCoordinateAttributeName Devuelve el nombre del atributo de coordenadas de textura predeterminado

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Nota: Funcióngetter para la propiedad defaultTextureCoordinateAttributeName.

Elementos no miembros relacionados

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.