Files
XCEngine/docs/api/rhi/opengl/render-target-view/clear.md

37 lines
940 B
Markdown
Raw Normal View History

# OpenGLRenderTargetView::Clear
```cpp
void Clear(float r, float g, float b, float a);
2026-03-20 02:35:45 +08:00
void Clear(float r, float g, float b, float a, float depth, uint8_t stencil);
```
2026-03-20 02:35:45 +08:00
清除渲染目标视图的颜色缓冲区和可选的深度/模板缓冲区。
2026-03-20 02:35:45 +08:00
**重载 1 参数(仅清除颜色):**
- `r` - 红色分量0.0f - 1.0f
- `g` - 绿色分量0.0f - 1.0f
- `b` - 蓝色分量0.0f - 1.0f
- `a` - Alpha 分量0.0f - 1.0f
**重载 2 参数(清除颜色、深度和模板):**
- `r` - 红色分量
- `g` - 绿色分量
- `b` - 蓝色分量
- `a` - Alpha 分量
2026-03-20 02:35:45 +08:00
- `depth` - 深度值(通常 0.0f 或 1.0f
- `stencil` - 模板值0-255
**示例:**
```cpp
// 仅清除颜色缓冲
rtv.Clear(0.1f, 0.1f, 0.1f, 1.0f);
// 清除颜色、深度和模板缓冲
rtv.Clear(0.1f, 0.1f, 0.1f, 1.0f, 1.0f, 0);
```
## 相关文档
- [OpenGLRenderTargetView 总览](render-target-view.md) - 返回类总览