XCEngine/docs/api/rhi/opengl/command-list/set-viewport.md

# OpenGLCommandList::SetViewport

```cpp
void SetViewport(const Viewport& viewport)
```

设置渲染视口区域。

**参数：**
- `viewport` - 视口结构，包含以下成员：
  - `topLeftX` - 视口左下角 X 坐标
  - `topLeftY` - 视口左下角 Y 坐标
  - `width` - 视口宽度
  - `height` - 视口高度
  - `minDepth` - 最小深度值（通常为 0.0f）
  - `maxDepth` - 最大深度值（通常为 1.0f）

**返回值**：无

**示例：**

```cpp
Viewport viewport;
viewport.topLeftX = 0.0f;
viewport.topLeftY = 0.0f;
viewport.width = 800.0f;
viewport.height = 600.0f;
viewport.minDepth = 0.0f;
viewport.maxDepth = 1.0f;
commandList->SetViewport(viewport);
```

## 相关文档

- [OpenGLCommandList 总览](command-list.md) - 返回类总览
- [SetViewports](set-viewports.md) - 批量设置视口