nan
32bcd45d7b
- Implemented `build_mesh_plane.py` to create a geometry node group for mesh planes with customizable parameters. - Created `build_shadeless.py` for a shader node group that displays color without scene lighting while preserving shadows and reflections. - Added `validate.py` to validate the integrity of the newly created node groups and their inputs. - Introduced `validate_cutout.py` to ensure the functionality of cutout node groups and their dependencies. - Developed `validate_mesh_plane.py` to test the mesh plane creation and its modifier settings.
33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
# Perspective Tool
|
||
|
||
`operators/perspective_tool/` 对应独立的 Image Perspective WorkspaceTool。它采集四个图片角点，把透视四边形重采样为指定宽高比的矩形，不使用 Job Server。
|
||
|
||
## 对应文件
|
||
|
||
```text
|
||
operators/perspective_tool/
|
||
├── __init__.py # 类型清单与对外导出
|
||
└── edit_perspective.py # 四点交互、预览、Homography 与写回
|
||
```
|
||
|
||
图片选择、裁切和 Empty 写回复用 `operators/common/` 的基础能力，不与 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 或反选。结果比例可能不同于原四边形的轴对齐范围，因此 Empty 写回保持中心和覆盖尺度近似一致，而不是假设当前 3D View 相机等于图片拍摄相机。
|