Files
XCEngine/docs/api/rhi/d3d12/command-list/clear-render-target-view.md

34 lines
800 B
Markdown
Raw Normal View History

# D3D12CommandList::ClearRenderTargetView
清除渲染目标视图(资源指针重载)。
```cpp
void ClearRenderTargetView(ID3D12Resource* renderTarget, const float color[4], uint32_t rectCount = 0, const D3D12_RECT* rects = nullptr);
```
## 参数
- `renderTarget` - D3D12 资源指针
- `color` - 清除颜色 RGBA
- `rectCount` - 矩形数量默认为0表示整个资源
- `rects` - 要清除的矩形数组默认为nullptr表示整个资源
## 返回值
**线程安全:** ❌
**复杂度:** O(n)
## 示例
```cpp
float color[4] = { 0.0f, 0.0f, 0.0f, 1.0f };
commandList.ClearRenderTargetView(renderTarget.GetResource(), color);
```
## 相关文档
- [D3D12CommandList 总览](command-list.md)
- [ClearRenderTarget](clear-render-target.md) - 清除渲染目标