75 lines
2.2 KiB
Markdown
75 lines
2.2 KiB
Markdown
|
# ShaderLoader::Load
|
|||
|
|
|
|||
|
|
## 方法签名
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
LoadResult Load(const Containers::String& path, const ImportSettings* settings = nullptr) override;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 详细描述
|
|||
|
|
|
|||
|
|
加载指定路径的着色器资源文件。加载过程包括：
|
|||
|
|
|
|||
|
|
1. 读取文件数据
|
|||
|
|
2. 将二进制数据转换为字符串形式的着色器源代码
|
|||
|
|
3. 创建 `Shader` 对象并设置基本信息（路径、名称、GUID）
|
|||
|
|
4. 根据文件扩展名检测着色器语言（HLSL 或 GLSL）
|
|||
|
|
5. 根据文件扩展名检测着色器类型（顶点、片段、几何、计算）
|
|||
|
|
6. 设置着色器源代码和有效性标志
|
|||
|
|
7. 计算并设置资源的内存占用
|
|||
|
|
|
|||
|
|
**语言检测规则：**
|
|||
|
|
- `.hlsl` 扩展名 → `ShaderLanguage::HLSL`
|
|||
|
|
- 其他扩展名 → `ShaderLanguage::GLSL`
|
|||
|
|
|
|||
|
|
**类型检测规则：**
|
|||
|
|
- `.vert` → `ShaderType::Vertex`
|
|||
|
|
- `.frag` → `ShaderType::Fragment`
|
|||
|
|
- `.geom` → `ShaderType::Geometry`
|
|||
|
|
- `.comp` → `ShaderType::Compute`
|
|||
|
|
- 其他扩展名 → `ShaderType::Fragment`（默认）
|
|||
|
|
|
|||
|
|
## 参数
|
|||
|
|
|
|||
|
|
| 参数 | 类型 | 默认值 | 描述 |
|
|||
|
|
|------|------|--------|------|
|
|||
|
|
| path | `const Containers::String&` | - | 着色器文件路径 |
|
|||
|
|
| settings | `const ImportSettings*` | `nullptr` | 导入设置（当前未使用） |
|
|||
|
|
|
|||
|
|
## 返回值
|
|||
|
|
|
|||
|
|
`LoadResult` - 加载结果对象，包含成功加载的 `Shader` 指针或错误信息
|
|||
|
|
|
|||
|
|
## 示例
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
#include "Resources/ShaderLoader.h"
|
|||
|
|
|
|||
|
|
using namespace XCEngine::Resources;
|
|||
|
|
|
|||
|
|
ShaderLoader loader;
|
|||
|
|
|
|||
|
|
// 加载顶点着色器
|
|||
|
|
LoadResult vertResult = loader.Load("assets/shaders/pbr.vert");
|
|||
|
|
if (vertResult.IsSuccess()) {
|
|||
|
|
Shader* vertShader = static_cast<Shader*>(vertResult.GetResource());
|
|||
|
|
printf("Loaded vertex shader: %s\n", vertShader->m_name.CStr());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 加载片段着色器
|
|||
|
|
LoadResult fragResult = loader.Load("assets/shaders/pbr.frag");
|
|||
|
|
if (fragResult.IsSuccess()) {
|
|||
|
|
Shader* fragShader = static_cast<Shader*>(fragResult.GetResource());
|
|||
|
|
printf("Loaded fragment shader: %s\n", fragShader->m_name.CStr());
|
|||
|
|
} else {
|
|||
|
|
printf("Failed to load fragment shader: %s\n", fragResult.GetError().CStr());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 加载 HLSL 着色器
|
|||
|
|
LoadResult hlslResult = loader.Load("assets/shaders/vertex.hlsl");
|
|||
|
|
if (hlslResult.IsSuccess()) {
|
|||
|
|
Shader* hlslShader = static_cast<Shader*>(hlslResult.GetResource());
|
|||
|
|
// HLSL 着色器...
|
|||
|
|
}
|
|||
|
|
```
|