336 lines
8.8 KiB
Markdown
336 lines
8.8 KiB
Markdown
# 第三阶段计划：OpenGL 后端实现
|
||
|
||
> **目标**：实现 OpenGL 后端，完成 RHI 跨平台图形抽象
|
||
> **阶段**：第三阶段
|
||
> **前置依赖**：第二阶段 RHI 抽象层与 D3D12 后端
|
||
|
||
---
|
||
|
||
## 3.1 阶段目标
|
||
|
||
在已有 RHI 抽象层和 D3D12 后端的基础上，实现 OpenGL 后端：
|
||
- 复用现有抽象接口
|
||
- 对接 OpenGL (GLFW + GLAD)
|
||
- 支持最小渲染系统验证
|
||
|
||
---
|
||
|
||
## 3.2 目录结构
|
||
|
||
```
|
||
engine/include/XCEngine/RHI/OpenGL/
|
||
├── OpenGLCommon.h # OpenGL 公共定义与辅助函数
|
||
├── OpenGLEnum.h # RHI 枚举 → OpenGL 枚举转换层
|
||
├── OpenGLDevice.h # 设备初始化
|
||
├── OpenGLDevice.cpp
|
||
├── OpenGLSwapChain.h # 交换链（GLFW 窗口）
|
||
├── OpenGLSwapChain.cpp
|
||
├── OpenGLCommandList.h # 命令列表封装
|
||
├── OpenGLCommandList.cpp
|
||
├── OpenGLBuffer.h # VBO/IBO/UBO 管理
|
||
├── OpenGLBuffer.cpp
|
||
├── OpenGLTexture.h # 纹理管理
|
||
├── OpenGLTexture.cpp
|
||
├── OpenGLShader.h # GLSL 着色器
|
||
├── OpenGLShader.cpp
|
||
├── OpenGLPipelineState.h # VAO + Program + State
|
||
├── OpenGLPipelineState.cpp
|
||
├── OpenGLRenderTarget.h # FBO + RTV
|
||
├── OpenGLRenderTarget.cpp
|
||
├── OpenGLDepthStencil.h # 深度模板
|
||
├── OpenGLDepthStencil.cpp
|
||
├── OpenGLDescriptorHeap.h # Texture Unit 模拟
|
||
├── OpenGLDescriptorHeap.cpp
|
||
├── OpenGLFence.h # 同步
|
||
├── OpenGLFence.cpp
|
||
├── OpenGLQueryHeap.h # 查询堆
|
||
├── OpenGLQueryHeap.cpp
|
||
├── OpenGLRootSignature.h # 简化实现
|
||
├── OpenGLRootSignature.cpp
|
||
├── OpenGLSampler.h # 采样器
|
||
├── OpenGLSampler.cpp
|
||
├── OpenGLResourceView.h # 视图基类
|
||
├── OpenGLResourceView.cpp
|
||
└── OpenGLRenderTargetView.h # 渲染目标视图
|
||
├── OpenGLRenderTargetView.cpp
|
||
├── OpenGLDepthStencilView.h
|
||
├── OpenGLDepthStencilView.cpp
|
||
├── OpenGLShaderResourceView.h
|
||
├── OpenGLShaderResourceView.cpp
|
||
├── OpenGLUnorderedAccessView.h
|
||
├── OpenGLUnorderedAccessView.cpp
|
||
├── OpenGLConstantBufferView.h
|
||
└── OpenGLConstantBufferView.cpp
|
||
```
|
||
|
||
---
|
||
|
||
## 3.3 任务拆分
|
||
|
||
### 3.3.1 基础准备
|
||
|
||
**任务 3.1：OpenGLEnum.h - 枚举转换层**
|
||
|
||
实现 RHI 枚举到 OpenGL 枚举的转换：
|
||
- `Format` → `GLenum`
|
||
- `PrimitiveTopology` → `GLenum`
|
||
- `BlendOp` / `BlendFactor` → `GLenum`
|
||
- `ComparisonFunc` → `GLenum`
|
||
- `ResourceStates` → `GLenum` (简化)
|
||
- `ShaderType` → `GLenum`
|
||
|
||
**任务 3.2：OpenGLCommon.h - 公共定义**
|
||
|
||
- OpenGL 初始化辅助函数
|
||
- 格式支持检测
|
||
- 错误检查宏
|
||
- GLAD 加载器封装
|
||
|
||
---
|
||
|
||
### 3.3.2 核心组件实现
|
||
|
||
**任务 3.3：OpenGLDevice - 设备实现**
|
||
|
||
实现 `OpenGLDevice` 类：
|
||
- GLFW 窗口创建
|
||
- GLAD 初始化
|
||
- OpenGL 上下文配置
|
||
- 设备信息查询
|
||
|
||
```cpp
|
||
class OpenGLDevice : public IRHIDevice {
|
||
public:
|
||
bool Initialize(void* windowHandle, bool enableDebug = false);
|
||
GLFWwindow* GetWindow() const { return m_window; }
|
||
|
||
// IRHIDevice 实现...
|
||
|
||
private:
|
||
GLFWwindow* m_window;
|
||
HGLRC m_glContext;
|
||
};
|
||
```
|
||
|
||
**任务 3.4：OpenGLSwapChain - 交换链实现**
|
||
|
||
实现 `OpenGLSwapChain` 类：
|
||
- GLFW 窗口管理
|
||
- 双缓冲切换
|
||
- 帧缓冲 resize 处理
|
||
|
||
**任务 3.5：OpenGLShader - 着色器实现**
|
||
|
||
实现 `OpenGLShader` 类：
|
||
- GLSL 源码加载
|
||
- `glShaderSource` + `glCompileShader`
|
||
- 编译错误获取
|
||
- 反射数据提取（可选）
|
||
|
||
**任务 3.6：OpenGLBuffer - 缓冲区实现**
|
||
|
||
实现 `OpenGLBuffer` 类：
|
||
- VBO 创建与管理
|
||
- IBO 索引缓冲
|
||
- UBO uniform 缓冲
|
||
- Buffer mapping
|
||
|
||
**任务 3.7：OpenGLTexture - 纹理实现**
|
||
|
||
实现 `OpenGLTexture` 类：
|
||
- 2D 纹理创建
|
||
- 纹理参数设置
|
||
- Mipmap 生成
|
||
- 纹理绑定
|
||
|
||
**任务 3.8：OpenGLPipelineState - 管线状态实现**
|
||
|
||
实现 `OpenGLPipelineState` 类：
|
||
- VAO 管理
|
||
- Shader Program 链接
|
||
- 状态缓存（blend, depth, rasterizer）
|
||
- 输入布局映射
|
||
|
||
**任务 3.9：OpenGLCommandList - 命令列表实现**
|
||
|
||
实现 `OpenGLCommandList` 类：
|
||
- 状态缓存与批量提交
|
||
- `glDrawArrays` / `glDrawElements` 封装
|
||
- 视口裁剪设置
|
||
- 渲染目标绑定
|
||
|
||
**任务 3.10：OpenGLFence - 同步实现**
|
||
|
||
实现 `OpenGLFence` 类：
|
||
- `glFenceSync` 封装
|
||
- CPU 等待实现
|
||
|
||
**任务 3.11：OpenGLDescriptorHeap - 描述符堆实现**
|
||
|
||
实现 `OpenGLDescriptorHeap` 类：
|
||
- Texture Unit 数组管理
|
||
- 简化版描述符绑定
|
||
|
||
---
|
||
|
||
### 3.3.3 视图实现
|
||
|
||
**任务 3.12：OpenGLRenderTargetView - 渲染目标视图**
|
||
|
||
- Framebuffer 对象管理
|
||
- 颜色附件绑定
|
||
|
||
**任务 3.13：OpenGLDepthStencilView - 深度模板视图**
|
||
|
||
- Depth/stencil buffer 管理
|
||
- FBO 深度附件
|
||
|
||
**任务 3.14：OpenGLShaderResourceView - 着色器资源视图**
|
||
|
||
- 纹理视图绑定到 Texture Unit
|
||
|
||
**任务 3.15：OpenGLUnorderedAccessView - 无序访问视图**
|
||
|
||
- SSBO 管理
|
||
|
||
**任务 3.16：OpenGLConstantBufferView - 常量缓冲区视图**
|
||
|
||
- UBO 绑定
|
||
|
||
---
|
||
|
||
## 3.4 D3D12 与 OpenGL 关键差异
|
||
|
||
| D3D12 组件 | OpenGL 对应 | 差异说明 |
|
||
|------------|-------------|----------|
|
||
| `ID3D12Device` | `OpenGLDevice` | GLFW + GLAD 初始化 |
|
||
| `ID3D12CommandQueue` | 简化 | OpenGL 无需显式命令队列 |
|
||
| `ID3D12CommandList` | `OpenGLCommandList` | 封装立即模式渲染 |
|
||
| `ID3D12DescriptorHeap` | `OpenGLDescriptorHeap` | 使用 Texture Unit 模拟 |
|
||
| `ID3D12PipelineState` | `OpenGLPipelineState` | VAO + Program + State |
|
||
| `ID3D12RootSignature` | 简化 | 使用 uniform binding |
|
||
| `ID3D12Fence` | `OpenGLFence` | glFenceSync |
|
||
| `ID3D12SwapChain` | `OpenGLSwapChain` | GLFW 窗口管理 |
|
||
| `ID3D12Buffer` | `OpenGLBuffer` | VBO/IBO/UBO |
|
||
| `ID3D12Texture` | `OpenGLTexture` | GL 纹理对象 |
|
||
| `ID3D12Shader` | `OpenGLShader` | GLSL 编译 |
|
||
| `ID3D12QueryHeap` | `OpenGLQueryHeap` | GL 查询对象 |
|
||
|
||
---
|
||
|
||
## 3.5 实现顺序
|
||
|
||
```
|
||
阶段 3.1: 基础准备 (1天)
|
||
├── 3.1.1 OpenGLEnum.h (枚举转换)
|
||
└── 3.1.2 OpenGLCommon.h (公共定义)
|
||
|
||
阶段 3.2: 核心组件 (4天)
|
||
├── 3.2.1 OpenGLDevice
|
||
├── 3.2.2 OpenGLSwapChain
|
||
├── 3.2.3 OpenGLShader
|
||
├── 3.2.4 OpenGLBuffer
|
||
├── 3.2.5 OpenGLTexture
|
||
├── 3.2.6 OpenGLPipelineState
|
||
└── 3.2.7 OpenGLCommandList
|
||
|
||
阶段 3.3: 辅助组件 (2天)
|
||
├── 3.3.1 OpenGLFence
|
||
├── 3.3.2 OpenGLDescriptorHeap
|
||
├── 3.3.3 OpenGLQueryHeap
|
||
├── 3.3.4 OpenGLSampler
|
||
└── 3.3.5 OpenGLRootSignature
|
||
|
||
阶段 3.4: 视图实现 (1天)
|
||
├── 3.4.1 OpenGLRenderTargetView
|
||
├── 3.4.2 OpenGLDepthStencilView
|
||
├── 3.4.3 OpenGLShaderResourceView
|
||
├── 3.4.4 OpenGLUnorderedAccessView
|
||
└── 3.4.5 OpenGLConstantBufferView
|
||
|
||
阶段 3.5: 集成测试 (1天)
|
||
├── 窗口创建与渲染循环
|
||
├── 简单模型渲染测试
|
||
└── 与 mvs/OpenGL 功能对比验证
|
||
```
|
||
|
||
---
|
||
|
||
## 3.6 关键技术点
|
||
|
||
### 3.6.1 状态管理
|
||
|
||
OpenGL 是状态机模式：
|
||
- 在 `OpenGLCommandList` 中缓存当前状态
|
||
- 绘制前检查状态变化，仅调用变化的 GL 函数
|
||
- 避免冗余状态设置
|
||
|
||
### 3.6.2 资源绑定
|
||
|
||
D3D12: Descriptor Heap + Root Signature
|
||
OpenGL: Texture Unit + Uniform Location
|
||
|
||
```cpp
|
||
// OpenGL 方式
|
||
glActiveTexture(GL_TEXTURE0 + slot);
|
||
glBindTexture(GL_TEXTURE_2D, textureID);
|
||
glUniform1i(location, slot);
|
||
```
|
||
|
||
### 3.6.3 着色器编译
|
||
|
||
```cpp
|
||
// GLSL 编译
|
||
GLuint vertexShader = glCreateShader(GL_VERTEX_SHADER);
|
||
glShaderSource(vertexShader, 1, &vertexSource, nullptr);
|
||
glCompileShader(vertexShader);
|
||
|
||
GLuint program = glCreateProgram();
|
||
glAttachShader(program, vertexShader);
|
||
glAttachShader(program, fragmentShader);
|
||
glLinkProgram(program);
|
||
```
|
||
|
||
### 3.6.4 VAO 管理
|
||
|
||
```cpp
|
||
// Vertex Array Object
|
||
GLuint vao;
|
||
glGenVertexArrays(1, &vao);
|
||
glBindVertexArray(vao);
|
||
glEnableVertexAttribArray(0);
|
||
glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, sizeof(Vertex), (void*)0);
|
||
```
|
||
|
||
### 3.6.5 帧缓冲
|
||
|
||
```cpp
|
||
// Framebuffer Object
|
||
GLuint fbo;
|
||
glGenFramebuffers(1, &fbo);
|
||
glBindFramebuffer(GL_FRAMEBUFFER, fbo);
|
||
glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, textureID, 0);
|
||
glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, depthID, 0);
|
||
```
|
||
|
||
---
|
||
|
||
## 3.7 验收标准
|
||
|
||
1. **编译通过**：所有头文件和实现文件能够无错误编译
|
||
2. **接口完整**：所有 RHI 抽象接口都有 OpenGL 实现
|
||
3. **功能验证**：
|
||
- 能够创建 GLFW 窗口并初始化 OpenGL 上下文
|
||
- 能够渲染简单的几何体
|
||
- 能够加载和显示纹理
|
||
- 能够呈现到屏幕
|
||
4. **功能对比**：与现有 mvs/OpenGL 功能一致
|
||
|
||
---
|
||
|
||
## 3.8 后续阶段依赖
|
||
|
||
- 第四阶段：渲染管线（RenderPipeline）需要 RHI 多后端支持
|
||
- 材质系统需要统一的 Shader 接口
|
||
- 跨平台渲染验证需要 OpenGL 后端
|