XCEngine/docs/api/rhi/shader/shader.md

# 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) | 解绑着色器 |
| [`SetInt`](set-int.md) | 设置整数 uniform |
| [`SetFloat`](set-float.md) | 设置浮点数 uniform |
| [`SetVec3`](set-vec3.md) | 设置 vec3 uniform |
| [`SetVec4`](set-vec4.md) | 设置 vec4 uniform |
| [`SetMat4`](set-mat4.md) | 设置 mat4 uniform |
| [`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) - 创建设备