Files
XCEngine/docs/api/resources/shader-loader/index.md
ssdfasd 8df04c120f docs: 更新 API 文档 - 多模块修复和完善
- audio: 更新 audio-system 方法文档
- components: 新增 audio-listener/audio-source 组件方法文档,新增 remove-component 方法
- core: 更新 filewriter, types 文档
- math: 更新 box 方法文档
- memory: 更新 proxy-allocator 文档
- resources: 更新 loader 和 texture 文档
- rhi: 更新 opengl 设备、shader、swap-chain 文档
- threading: 更新 mutex 和 task-system 文档
2026-03-26 01:58:45 +08:00

2.3 KiB
Raw Blame History

ShaderLoader

命名空间

XCEngine::Resources

类型

类 (Class)

描述

着色器资源加载器,负责从磁盘加载 .vert.frag.geom.comp.glsl.hlsl.shader 格式的着色器资源文件。

概述

ShaderLoader 继承自 IResourceLoader,实现了着色器资源的加载功能。它支持多种图形 API 的着色器格式,包括 GLSLOpenGL/Vulkan和 HLSLDirectX。加载过程中会根据文件扩展名自动检测着色器类型和语言创建 Shader 对象并设置相应的元数据。当前实现专注于文件读取和基础资源创建,着色器编译和实际绑定由渲染层完成。

公共方法

方法 签名 描述
ShaderLoader ShaderLoader() 默认构造函数
~ShaderLoader virtual ~ShaderLoader() 析构函数
GetResourceType ResourceType GetResourceType() const 返回资源类型为 Shader
GetSupportedExtensions Array<String> GetSupportedExtensions() const 返回支持的扩展名列表
CanLoad bool CanLoad(const String& path) const 检查给定路径是否可被加载
Load LoadResult Load(const String& path, const ImportSettings* settings = nullptr) 加载指定路径的着色器资源
GetDefaultSettings ImportSettings* GetDefaultSettings() const 返回默认导入设置

使用示例

#include "Resources/ShaderLoader.h"
#include "Resources/ResourceManager.h"

using namespace XCEngine::Resources;

// 通过 ResourceManager 加载着色器
auto shaderHandle = ResourceManager::Get().Load<Shader>("assets/shaders/pbr.vert");
if (shaderHandle.IsValid()) {
    Shader* shader = shaderHandle.Get();
    // 使用着色器...
}

// 直接使用 ShaderLoader
ShaderLoader loader;
LoadResult result = loader.Load("assets/shaders/pbr.frag");
if (result.IsSuccess()) {
    Shader* shader = static_cast<Shader*>(result.GetResource());
    // 使用着色器...
}

相关文档