# VertexAttribute

**命名空间**: `XCEngine::RHI`

**描述**: 顶点属性描述结构体，用于定义顶点缓冲区中单个属性的布局。

## 成员

| 成员 | 类型 | 描述 |
|------|------|------|
| `index` | `unsigned int` | 属性索引，对应着色器中 `layout(location = n)` |
| `count` | `int` | 分量数量（1-4），如位置用 3，纹理坐标用 2 |
| `type` | `unsigned int` | OpenGL 数据类型，如 `GL_FLOAT`、`GL_INT` |
| `normalized` | `bool` | 是否归一化Fixed-point类型 |
| `stride` | `size_t` | 连续顶点属性之间的字节偏移 |
| `offset` | `size_t` | 此属性在顶点结构体中的字节偏移 |

## 类型取值参考

| 类型常量 | 描述 |
|----------|------|
| `GL_BYTE` | 有符号字节 |
| `GL_UNSIGNED_BYTE` | 无符号字节 |
| `GL_SHORT` | 有符号短整型 |
| `GL_UNSIGNED_SHORT` | 无符号短整型 |
| `GL_INT` | 有符号整型 |
| `GL_UNSIGNED_INT` | 无符号整型 |
| `GL_FLOAT` | 单精度浮点 |
| `GL_DOUBLE` | 双精度浮点 |

## 使用示例

```cpp
// 定义顶点结构体
struct Vertex {
    float position[3];
    float normal[3];
    float texCoord[2];
};

// 位置属性 (index=0)
VertexAttribute posAttr;
posAttr.index = 0;
posAttr.count = 3;
posAttr.type = GL_FLOAT;
posAttr.normalized = GL_FALSE;
posAttr.stride = sizeof(Vertex);
posAttr.offset = 0;

// 法线属性 (index=1)
VertexAttribute normalAttr;
normalAttr.index = 1;
normalAttr.count = 3;
normalAttr.type = GL_FLOAT;
normalAttr.normalized = GL_FALSE;
normalAttr.stride = sizeof(Vertex);
normalAttr.offset = offsetof(Vertex, normal);

// 纹理坐标属性 (index=2)
VertexAttribute texAttr;
texAttr.index = 2;
texAttr.count = 2;
texAttr.type = GL_FLOAT;
texAttr.normalized = GL_FALSE;
texAttr.stride = sizeof(Vertex);
texAttr.offset = offsetof(Vertex, texCoord);
```

## 相关文档

- [OpenGLVertexArray](vertex-array.md) - 返回类总览
- [AddVertexBuffer](add-vertex-buffer.md) - 添加顶点缓冲方法