XCEngine/docs/api/rhi/opengl/vertex-array/vertex-array.md

# 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 后端总览](../overview.md)
- [VertexAttribute 结构体](vertex-attribute.md)