XCEngine/docs/api/rhi/opengl/device/compile-shader.md

OpenGLDevice::CompileShader

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 为空，不执行编译但仍返回着色器对象
• 返回的着色器对象归调用者所有，需自行管理生命周期

示例

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 - 类总览
• OpenGLShader - OpenGL 着色器实现