68 lines
1.7 KiB
Markdown
68 lines
1.7 KiB
Markdown
|
# OpenGLDevice::CreateBuffer
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
RHIBuffer* CreateBuffer(const BufferDesc& desc) override
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
创建 OpenGL 缓冲区对象。
|
|||
|
|
|
|||
|
|
## 详细描述
|
|||
|
|
|
|||
|
|
根据 `BufferDesc` 创建一个 OpenGL 缓冲区对象。缓冲区类型映射：
|
|||
|
|
|
|||
|
|
| BufferDesc.bufferType | OpenGLBufferType |
|
|||
|
|
|----------------------|------------------|
|
|||
|
|
| 0 (默认) | Vertex (顶点缓冲区) |
|
|||
|
|
| 1 | Index (索引缓冲区) |
|
|||
|
|
| 2 | Uniform (常量缓冲区/Uniform Buffer) |
|
|||
|
|
|
|||
|
|
### 缓冲区类型
|
|||
|
|
|
|||
|
|
- **Vertex Buffer**: 存储顶点属性数据（位置、法线、UV 等）
|
|||
|
|
- **Index Buffer**: 存储顶点索引，用于索引绘制
|
|||
|
|
- **Uniform Buffer**: 存储着色器 uniforms 数据
|
|||
|
|
|
|||
|
|
## 参数
|
|||
|
|
|
|||
|
|
- `desc` - 缓冲区描述符
|
|||
|
|
|
|||
|
|
### BufferDesc 字段
|
|||
|
|
|
|||
|
|
| 字段 | 描述 |
|
|||
|
|
|------|------|
|
|||
|
|
| `bufferType` | 缓冲区类型 (0=顶点, 1=索引, 2=Uniform) |
|
|||
|
|
| `size` | 缓冲区大小（字节） |
|
|||
|
|
|
|||
|
|
## 返回值
|
|||
|
|
|
|||
|
|
`RHIBuffer*` - 创建的缓冲区指针，失败返回 `nullptr`
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
- 当前实现创建的缓冲区初始数据为 `nullptr`（空缓冲区）
|
|||
|
|
- 缓冲区创建后可使用 `OpenGLBuffer` 的接口进行数据更新
|
|||
|
|
- 返回的缓冲区对象归调用者所有，需自行管理生命周期
|
|||
|
|
|
|||
|
|
## 示例
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
// 创建顶点缓冲区
|
|||
|
|
BufferDesc vertexDesc;
|
|||
|
|
vertexDesc.bufferType = 0; // Vertex
|
|||
|
|
vertexDesc.size = sizeof(Vertex) * vertexCount;
|
|||
|
|
|
|||
|
|
RHIBuffer* vertexBuffer = device.CreateBuffer(vertexDesc);
|
|||
|
|
|
|||
|
|
// 创建索引缓冲区
|
|||
|
|
BufferDesc indexDesc;
|
|||
|
|
indexDesc.bufferType = 1; // Index
|
|||
|
|
indexDesc.size = sizeof(uint32_t) * indexCount;
|
|||
|
|
|
|||
|
|
RHIBuffer* indexBuffer = device.CreateBuffer(indexDesc);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 相关文档
|
|||
|
|
|
|||
|
|
- [OpenGLDevice](device.md) - 类总览
|
|||
|
|
- [OpenGLBuffer](../opengl-buffer.md) - OpenGL 缓冲区实现
|