# Perspective Tool

`operators/perspective_tool/` 对应独立的 Image Perspective WorkspaceTool。它采集四个图片角点，把透视四边形重采样为指定宽高比的矩形，不使用 Job Server。

## 对应文件

```text
operators/perspective_tool/
├── __init__.py            # 类型清单与对外导出
└── edit_perspective.py    # 四点交互、预览、Homography 与写回
```

图片坐标投射、Alpha 裁切和 Empty 写回复用 `operators/common/` 的基础能力；四点数据始终称为 Quad，不与 Image Region 或 Image Mask Operator 共享业务状态。

## 矫正流程

```mermaid
flowchart TD
    Click["任意顺序的四个角点"] --> Quad["规范为凸四边形"]
    Quad --> Preview["生成一次 512 × 512 预览"]
    Preview --> Ratio["鼠标调整目标宽高比"]
    Ratio --> Size["计算受限输出尺寸"]
    Size --> Warp["全分辨率 Homography"]
    Warp --> Crop["按可见 Alpha 紧裁切"]
    Crop --> Write["Pack 并写回当前 Empty"]
```

四点输入顺序不决定输出方向；规范化阶段依据源图 X/Y 方向得到不交错的凸四边形。第四点之后只创建一次低分辨率纹理，交互阶段改变 UI 宽高比，确认时才执行全分辨率重采样。

Homography 使用预乘 Alpha 插值，避免透明边缘混入黑色。输出最长边限制为 8192 px，总像素限制为 16,777,216，并按 256 行分块计算，控制中间数组大小。

Perspective 是 deform 工具，不提供 Refine 或反选。它通过公共 `image_pixels()` 读取供预览与最终 Warp 共用的源像素，并与 Image Mask 共用像素结果创建和 Image Empty 替换入口。结果比例可能不同于原四边形的轴对齐范围，因此 Empty 写回保持中心和覆盖尺度近似一致，而不是假设当前 3D View 相机等于图片拍摄相机。