Files
XCEngine/docs/api/rhi/shader/shader.md
ssdfasd 870cb3116e docs: 修正 API 文档准确性 (第三轮检查)
修复问题:
- containers: HashMap include 路径修复
- core: RefCounted 析构函数访问级别, Event::begin/end 返回值说明
- memory: LinearAllocator::GetMarker 返回偏移量非指针
- resources: LoadAsync 示例使用不存在的模板方法
- rhi: OpenGL 链接错误, ShaderType 枚举缺失8个类型, 链接修复
- threading: SpinLock STL 兼容方法说明, Mutex const 方法说明
2026-03-19 00:35:26 +08:00

83 lines
2.0 KiB
Markdown

# RHIShader
**命名空间**: `XCEngine::RHI`
**类型**: `class` (abstract)
**描述**: GPU 着色器资源抽象接口,用于管理着色器代码的编译和绑定。
## 公共方法
### 编译
| 方法 | 文档 |
|------|------|
| `CompileFromFile` | [详细文档](compile-from-file.md) |
| `Compile` | [详细文档](compile.md) |
### 属性访问
| 方法 | 文档 |
|------|------|
| `GetType` | [详细文档](get-type.md) |
| `IsValid` | [详细文档](is-valid.md) |
### 绑定/解绑
| 方法 | 文档 |
|------|------|
| `Bind` | [详细文档](bind.md) |
| `Unbind` | [详细文档](unbind.md) |
### Uniform 设置
| 方法 | 文档 |
|------|------|
| `SetInt` | [详细文档](set-int.md) |
| `SetFloat` | [详细文档](set-float.md) |
| `SetVec3` | [详细文档](set-vec3.md) |
| `SetVec4` | [详细文档](set-vec4.md) |
| `SetMat4` | [详细文档](set-mat4.md) |
### 生命周期
| 方法 | 文档 |
|------|------|
| `Shutdown` | [详细文档](shutdown.md) |
### 其他
| 方法 | 文档 |
|------|------|
| `GetNativeHandle` | [详细文档](get-native-handle.md) |
## 着色器类型 (ShaderType)
| 枚举值 | 描述 |
|--------|------|
| `ShaderType::Vertex` | 顶点着色器 |
| `ShaderType::Fragment` | 片元着色器 |
| `ShaderType::Geometry` | 几何着色器 |
| `ShaderType::Compute` | 计算着色器 |
| `ShaderType::TessControl` | 曲面细分控制着色器 |
| `ShaderType::TessEvaluation` | 曲面细分评估着色器 |
| `ShaderType::Hull` | Hull 着色器 (D3D12) |
| `ShaderType::Domain` | Domain 着色器 (D3D12) |
| `ShaderType::Amplification` | 放大着色器 (Mesh Shader) |
| `ShaderType::Mesh` | Mesh 着色器 |
| `ShaderType::Library` | 着色器库 |
## 使用示例
```cpp
RHIShader* vs = device->CompileShader({});
vs->CompileFromFile(L"shaders/vertex.hlsl", "main", "vs_6_0");
vs->SetMat4("modelMatrix", modelMatrix);
vs->Bind();
```
## 相关文档
- [../rhi/rhi.md](../rhi.md) - RHI 模块总览
- [RHIDevice](../device/device.md) - 创建设备