72 lines
1.9 KiB
Markdown
72 lines
1.9 KiB
Markdown
# 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) - 添加顶点缓冲方法 |