44 lines
1.2 KiB
Markdown
44 lines
1.2 KiB
Markdown
# RHIShader::SetVec4
|
|
|
|
```cpp
|
|
virtual void SetVec4(const char* name, float x, float y, float z, float w) = 0;
|
|
```
|
|
|
|
设置四维向量 uniform 变量。
|
|
|
|
通过名称查找并设置着色器中的四维向量 uniform 变量。常见用途包括设置齐次坐标、颜色（带透明度）、平面方程等。
|
|
|
|
**参数：**
|
|
- `name` - uniform 变量名称
|
|
- `x` - 向量的 X 分量
|
|
- `y` - 向量的 Y 分量
|
|
- `z` - 向量的 Z 分量
|
|
- `w` - 向量的 W 分量（齐次坐标或透明度）
|
|
|
|
**线程安全：** ❌（需要在渲染线程调用）
|
|
|
|
**复杂度：** O(1)（通常为哈希表查找）
|
|
|
|
**示例：**
|
|
|
|
```cpp
|
|
RHIShader* shader = device->CreateShader();
|
|
shader->CompileFromFile(L"shaders/pixel.cso", "PSMain", "ps_5_0");
|
|
shader->Bind();
|
|
|
|
// 设置带透明度的颜色
|
|
shader->SetVec4("u_color", 1.0f, 0.0f, 0.0f, 0.8f);
|
|
|
|
// 设置平面方程 (ax + by + cz + d = 0)
|
|
shader->SetVec4("u_clipPlane", 0.0f, 1.0f, 0.0f, 0.0f);
|
|
|
|
// 设置纹理坐标变换
|
|
shader->SetVec4("u_texOffset", 0.1f, 0.1f, 2.0f, 2.0f);
|
|
```
|
|
|
|
## 相关文档
|
|
|
|
- [RHIShader](shader.md) - 返回类总览
|
|
- [`SetVec3`](set-vec3.md) - 设置三维向量 uniform
|
|
- [`SetMat4`](set-mat4.md) - 设置 4x4 矩阵 uniform
|