Files
XCEngine/docs/api/XCEngine/Debug/RenderDocCapture/EndCapture.md

49 lines
924 B
Markdown

# RenderDocCapture::EndCapture
结束当前正在进行的 RenderDoc 抓帧。
```cpp
bool EndCapture();
```
## 行为说明
当前实现会先检查:
- RenderDoc 是否已加载。
- 当前是否确实处于抓帧状态。
如果任一条件不成立,会记录警告并返回 `false`。条件成立时会调用:
```cpp
m_api->EndFrameCapture(m_device, m_window);
```
## 参数
- 无。
## 返回值
- `bool` - `true` 表示已发出结束抓帧请求;`false` 表示当前没有可结束的抓帧。
## 线程语义
- 应与 [BeginCapture](BeginCapture.md) 在同一渲染工作流中配对调用。
## 示例
```cpp
if (XCEngine::Debug::RenderDocCapture::Get().EndCapture()) {
XCEngine::Debug::Logger::Get().Info(
XCEngine::Debug::LogCategory::RenderDoc,
"Capture ended"
);
}
```
## 相关文档
- [返回类型总览](RenderDocCapture.md)
- [BeginCapture](BeginCapture.md)