49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
|
# Viewport
|
|||
|
|
|
|||
|
|
**命名空间**: `XCEngine::Math`
|
|||
|
|
|
|||
|
|
**类型**: `struct`
|
|||
|
|
|
|||
|
|
**头文件**: `XCEngine/Math/Viewport.h`
|
|||
|
|
|
|||
|
|
**描述**: 视口，用于渲染目标区域和坐标映射
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
|
|||
|
|
Viewport 结构体表示一个渲染视口，除了位置和尺寸外，还包含深度范围 `(minDepth, maxDepth)`。主要用于屏幕到归一化设备坐标（NDC）的映射，以及渲染目标区域的定义。
|
|||
|
|
|
|||
|
|
## 公共方法
|
|||
|
|
|
|||
|
|
| 方法 | 描述 |
|
|||
|
|
|------|------|
|
|||
|
|
| [`GetAspectRatio`](getaspectratio.md) | 获取视口宽高比 |
|
|||
|
|
| [`GetRect`](getrect.md) | 转换为 Rect |
|
|||
|
|
|
|||
|
|
## 使用示例
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
#include "XCEngine/Math/Rect.h"
|
|||
|
|
#include <iostream>
|
|||
|
|
|
|||
|
|
using namespace XCEngine::Math;
|
|||
|
|
|
|||
|
|
int main() {
|
|||
|
|
Viewport viewport(0.0f, 0.0f, 1920.0f, 1080.0f, 0.0f, 1.0f);
|
|||
|
|
|
|||
|
|
std::cout << "Position: (" << viewport.x << ", " << viewport.y << ")\n";
|
|||
|
|
std::cout << "Size: " << viewport.width << " x " << viewport.height << "\n";
|
|||
|
|
std::cout << "Depth: " << viewport.minDepth << " to " << viewport.maxDepth << "\n";
|
|||
|
|
std::cout << "Aspect Ratio: " << viewport.GetAspectRatio() << "\n";
|
|||
|
|
|
|||
|
|
Rect rect = viewport.GetRect();
|
|||
|
|
std::cout << "As Rect: (" << rect.x << ", " << rect.y << ", " << rect.width << ", " << rect.height << ")\n";
|
|||
|
|
|
|||
|
|
return 0;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 相关文档
|
|||
|
|
|
|||
|
|
- [`Rect`](../rect/rect.md) - 浮点矩形
|
|||
|
|
- [`RectInt`](../rect/rectint.md) - 整数矩形
|
|||
|
|
- [`Vector2`](../vector2/vector2.md) - 二维向量
|