Files
XCEngine/docs/api/rhi/command-list/set-viewports.md

34 lines
821 B
Markdown
Raw Normal View History

# RHICommandList::SetViewports
```cpp
virtual void SetViewports(uint32_t count, const Viewport* viewports) = 0;
```
2026-03-20 02:35:45 +08:00
批量设置多个渲染视口。用于需要多重渲染Multi-Rendering的场景如立体渲染或分屏渲染。
**参数:**
2026-03-20 02:35:45 +08:00
- `count` - 视口数量(最大 16
- `viewports` - 视口数组指针
2026-03-20 02:35:45 +08:00
**返回:** `void`
**异常:** 无
**线程安全:** ❌
**复杂度:** O(n)n 为视口数量
**示例:**
```cpp
Viewport viewports[2];
viewports[0] = {0, 0, 640, 720, 0.0f, 1.0f};
viewports[1] = {640, 0, 640, 720, 0.0f, 1.0f};
cmdList->SetViewports(2, viewports);
```
## 相关文档
- [RHICommandList 总览](command-list.md) - 返回类总览
2026-03-20 02:35:45 +08:00
- [SetViewport](set-viewport.md) - 设置单个视口
- [SetScissorRects](set-scissor-rects.md) - 设置多个裁剪矩形