40 lines
800 B
Markdown
40 lines
800 B
Markdown
# RenderDocCapture::TriggerCapture
|
|
|
|
请求 RenderDoc 触发一次 capture。
|
|
|
|
```cpp
|
|
void TriggerCapture();
|
|
```
|
|
|
|
## 行为说明
|
|
|
|
如果 RenderDoc 尚未加载，当前实现直接返回。否则：
|
|
|
|
- 如果 `m_window` 非空，会先把窗口设为前台并设置焦点。
|
|
- 调用底层 `TriggerCapture()` 请求 RenderDoc 执行一次捕获。
|
|
|
|
与 [BeginCapture](BeginCapture.md) / [EndCapture](EndCapture.md) 相比，这个方法更适合交给 RenderDoc 自己决定具体捕获时机。
|
|
|
|
## 参数
|
|
|
|
- 无。
|
|
|
|
## 返回值
|
|
|
|
- 无。
|
|
|
|
## 线程语义
|
|
|
|
- 建议在拥有目标窗口焦点控制权的线程调用。
|
|
|
|
## 示例
|
|
|
|
```cpp
|
|
XCEngine::Debug::RenderDocCapture::Get().TriggerCapture();
|
|
```
|
|
|
|
## 相关文档
|
|
|
|
- [返回类型总览](RenderDocCapture.md)
|
|
- [BeginCapture](BeginCapture.md)
|