- 修复opengl/下13个文件对overview.md的错误引用,改为opengl.md - 修复opengl/shader/下2处get-native-handle.md的错误路径引用 - 修复rhi.md中rhifactory路径错误 - 修复opengl.md中对d3d12.md的错误引用 - 修复opengl/README.md中的overview.md引用 - 新增RHIFramebuffer完整文档(7个文件) - 新增RHIRenderPass完整文档(7个文件) - 更新rhi.md总览页,添加RHIFramebuffer和RHIRenderPass分类
69 lines
1.9 KiB
Markdown
69 lines
1.9 KiB
Markdown
# OpenGLVertexArray
|
|
|
|
**命名空间**: `XCEngine::RHI`
|
|
|
|
**描述**: OpenGL 顶点数组对象 (VAO) 封装。管理顶点属性配置和索引缓冲绑定。
|
|
|
|
## 概述
|
|
|
|
`OpenGLVertexArray` 封装了 OpenGL 顶点数组对象 (Vertex Array Object, VAO),用于:
|
|
- 存储顶点属性配置
|
|
- 绑定顶点缓冲区和索引缓冲区
|
|
- 提供便捷的绑定/解绑接口
|
|
|
|
## 类型
|
|
|
|
| 类型 | 描述 |
|
|
|------|------|
|
|
| [`VertexAttribute`](vertex-attribute.md) | 顶点属性描述结构体 |
|
|
|
|
## 构造函数/析构函数
|
|
|
|
| 方法 | 描述 |
|
|
|------|------|
|
|
| [`OpenGLVertexArray()`](constructor.md) | 默认构造函数 |
|
|
| [`~OpenGLVertexArray()`](destructor.md) | 析构函数,调用 `Shutdown()` 释放资源 |
|
|
|
|
## 公共方法
|
|
|
|
| 方法 | 描述 |
|
|
|------|------|
|
|
| [`Initialize`](initialize.md) | 初始化顶点数组,生成 VAO |
|
|
| [`AddVertexBuffer`](add-vertex-buffer.md) | 添加顶点缓冲并配置属性 |
|
|
| [`SetIndexBuffer`](set-index-buffer.md) | 设置索引缓冲 |
|
|
| [`Shutdown`](shutdown.md) | 关闭顶点数组,释放 VAO 资源 |
|
|
| [`Bind`](bind.md) | 绑定顶点数组到当前 OpenGL 上下文 |
|
|
| [`Unbind`](unbind.md) | 解绑顶点数组 |
|
|
| [`GetID`](get-id.md) | 获取 OpenGL VAO ID |
|
|
| [`GetIndexBuffer`](get-index-buffer.md) | 获取索引缓冲区 ID |
|
|
| [`GetIndexCount`](get-index-count.md) | 获取索引数量(需手动维护) |
|
|
|
|
## 使用示例
|
|
|
|
```cpp
|
|
// 创建 VAO
|
|
OpenGLVertexArray vao;
|
|
vao.Initialize();
|
|
|
|
// 添加顶点缓冲和属性
|
|
vao.AddVertexBuffer(vbo, positionAttr);
|
|
vao.AddVertexBuffer(vbo, normalAttr);
|
|
vao.AddVertexBuffer(vbo, texCoordAttr);
|
|
|
|
// 设置索引缓冲
|
|
vao.SetIndexBuffer(ibo, GL_UNSIGNED_INT);
|
|
|
|
// 绑定并绘制
|
|
vao.Bind();
|
|
glDrawElements(GL_TRIANGLES, indexCount, GL_UNSIGNED_INT, 0);
|
|
vao.Unbind();
|
|
|
|
// 销毁
|
|
vao.Shutdown();
|
|
```
|
|
|
|
## 相关文档
|
|
|
|
- [OpenGL 后端总览](../opengl.md)
|
|
- [VertexAttribute 结构体](vertex-attribute.md)
|