74 lines
1.7 KiB
Markdown
74 lines
1.7 KiB
Markdown
# OpenGLDevice::CompileShader
|
||
|
||
```cpp
|
||
RHIShader* CompileShader(const ShaderCompileDesc& desc) override
|
||
```
|
||
|
||
编译着色器程序。
|
||
|
||
## 详细描述
|
||
|
||
从文件加载并编译着色器代码。
|
||
|
||
### 支持的着色器类型
|
||
|
||
通过 `profile` 参数指定：
|
||
- `"vs"` / `"vert"` - 顶点着色器
|
||
- `"fs"` / `"frag"` - 片段着色器
|
||
- `"gs"` - 几何着色器
|
||
- `"cs"` / `"compute"` - 计算着色器
|
||
- `"ts"` / `"tess"` - 曲面细分着色器
|
||
|
||
### 着色器编译流程
|
||
|
||
1. 从文件读取着色器源码
|
||
2. 根据 `profile` 选择着色器类型
|
||
3. 编译着色器源码
|
||
4. 链接程序（如果需要）
|
||
|
||
## 参数
|
||
|
||
- `desc` - 着色器编译描述符
|
||
|
||
### ShaderCompileDesc 字段
|
||
|
||
| 字段 | 描述 |
|
||
|------|------|
|
||
| `fileName` | 着色器文件路径（宽字符） |
|
||
| `entryPoint` | 入口点名称（默认 "main"） |
|
||
| `profile` | 着色器配置文件（如 "vs", "fs"） |
|
||
|
||
## 返回值
|
||
|
||
`RHIShader*` - 创建的着色器指针，编译失败返回包含错误的着色器对象
|
||
|
||
## 注意事项
|
||
|
||
- `fileName` 使用宽字符 (`std::wstring`)
|
||
- `entryPoint` 和 `profile` 从宽字符转换为窄字符
|
||
- 如果 `fileName` 为空，不执行编译但仍返回着色器对象
|
||
- 返回的着色器对象归调用者所有，需自行管理生命周期
|
||
|
||
## 示例
|
||
|
||
```cpp
|
||
ShaderCompileDesc vsDesc;
|
||
vsDesc.fileName = L"shaders/triangle.vert";
|
||
vsDesc.entryPoint = L"main";
|
||
vsDesc.profile = L"vs";
|
||
|
||
RHIShader* vertexShader = device.CompileShader(vsDesc);
|
||
|
||
ShaderCompileDesc fsDesc;
|
||
fsDesc.fileName = L"shaders/triangle.frag";
|
||
fsDesc.entryPoint = L"main";
|
||
fsDesc.profile = L"fs";
|
||
|
||
RHIShader* fragmentShader = device.CompileShader(fsDesc);
|
||
```
|
||
|
||
## 相关文档
|
||
|
||
- [OpenGLDevice](device.md) - 类总览
|
||
- [OpenGLShader](../opengl-shader.md) - OpenGL 着色器实现
|