nan
4c902ed7db
- Implemented `image_plane.py` to build the Image Plane Geometry Nodes group with customizable parameters for geometry, subdivide, and thickness. - Created `image_plane_validation.py` to validate the functionality of the image plane, ensuring correct geometry generation and material assignment. - Developed `material_layers.py` to construct shader node groups for image materials, including depth and normal handling. - Authored `plane_layouts.py` to define node arrangements for image geometry assets. - Introduced `shadeless.py` to create a shadeless shader node group that displays color without scene lighting while preserving shadows and reflections.
44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
# 程序架构
|
||
|
||
| 模块 | 职责 |
|
||
| --- | --- |
|
||
| `__init__.py` | 注册类型、工具、菜单、快捷键与 Runtime |
|
||
| `menu.py`、`panel.py` | Image Empty 上下文菜单与 Job Server 面板 |
|
||
| `preferences.py` | 扩展设置及读取入口 |
|
||
| `properties.py` | Scene 手势状态、视频帧数、模型状态与枚举 |
|
||
| `common/` | Blender 侧公共能力 |
|
||
| `operators/` | 交互、任务参数、结果导入和 Undo |
|
||
| `server/` | 独立环境内的媒体处理、推理和产物写出 |
|
||
|
||
## 注册与配置
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[register] --> B[按 CLASSES 顺序注册类型]
|
||
B --> C[注册 Frame、Mask、Rectify、Cutout 工具]
|
||
C --> D[挂载 Scene.anyimage_settings]
|
||
D --> E[挂载 View3D 与 Outliner 菜单及剪贴板快捷键]
|
||
E --> F[注册 JobRuntime]
|
||
```
|
||
|
||
注销先关闭 Runtime 和交互入口，再移除 Scene 属性，按 `CLASSES` 逆序注销类型。设备、存储目录、模型、材质显示适配和功能上限统一通过 `preferences.py` 读取。
|
||
|
||
**Maximum AI Input Size** 限制模型分析图和 Upscale 可提交源图；**Maximum Frame Resolution** 限制 Frame 输出；**Maximum Cutout Mesh Resolution** 限制轮廓网格采样。三者各自作用于对应数据阶段。
|
||
|
||
## 执行边界
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[Operator 在主线程读取 Blender 数据] --> B[准备输入文件]
|
||
B --> C[request 返回普通字典]
|
||
C --> D[BlendJob 队列执行 Server Job]
|
||
D --> E[模型与媒体处理写入 Job 目录]
|
||
E --> F[主线程 response 加载结果]
|
||
F --> G[提交 Image 或 Object 修改及 Undo]
|
||
G --> H[清理临时输入]
|
||
```
|
||
|
||
Plane、Frame、Mask、Rectify 和无需 AI 的 Cutout 在 Blender 内执行。Server 的 `jobs/` 编排任务，`models/` 负责模型适配，`geometry/` 处理深度与法线产物。Server 模块通过内部相对导入共享能力，Blender 侧通过 `common/` 复用。
|
||
|
||
MoGe-2 输出统一为 `GeometryFrame`：包含 Depth、Validity、Intrinsics，以及按需提供的 Normal 和 Points。产物写入器消费同一个 Frame，保持深度、法线和相机数据一致。参见 [Runtime](runtime.md) 与 [产物协议](outputs.md)。
|