Files
XCEngine/docs/api/rhi/shader/set-vec4.md
2026-03-20 02:35:45 +08:00

1.2 KiB

RHIShader::SetVec4

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)(通常为哈希表查找)

示例:

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);

相关文档