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.
55 lines
2.9 KiB
Markdown
55 lines
2.9 KiB
Markdown
# Blender 公共能力
|
||
|
||
`src/anyimage/common/` 按业务职责提供公共函数，调用方从对应模块直接导入。
|
||
|
||
| 模块 | 职责与主要入口 |
|
||
| --- | --- |
|
||
| `ai.py` | 环境和模型就绪检查、输入路径校验、`production_device()`、`moge2_parameters()` 与安装 UI |
|
||
| `image.py` | `image_rgba()`、动画帧设置、Job 输入准备、像素采样、结果 Image 和 `replace_empty_image()` |
|
||
| `selection.py` | `SelectionPath`、`SelectionMask`、non-zero winding 栅格化与 Alpha 修整 |
|
||
| `viewport.py` | 原生点选、屏幕投影、`ImageGesture`、Lasso / Brush / Polyline 与 Overlay |
|
||
| `depth.py` | 深度图片和元数据加载、相机坐标与显示范围的尺度换算 |
|
||
| `material.py` | Image Layer、Normal、Alpha、Shadeless 和动画材质 |
|
||
| `object.py` | Modifier 输入设置与结果对象激活、源对象替换 |
|
||
| `node.py` | `node_asset_path()` 与 `load_node_group()` |
|
||
|
||
## 图像生命周期
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[Image 与 Image Empty] --> B[image_rgba 读取业务像素]
|
||
B --> C{处理位置}
|
||
C -- 本地 --> D[像素算法]
|
||
C -- Server --> E[prepare_image_input 或 prepare_image_bounds_input]
|
||
E --> F[Job 输出文件]
|
||
F --> G[加载并 Pack]
|
||
D --> G
|
||
G --> H[replace_empty_image]
|
||
H --> I[保留身份、共享引用、帧设置和画框]
|
||
```
|
||
|
||
业务像素采用 Top-down RGBA，`image_pixels()` 使用 Blender 像素顺序。预乘采样用于投影插值；文件或 Packed 图像的业务读取保留隐藏 RGB。直接编辑结果通过统一入口处理共享 Image、失败恢复和源数据清理。
|
||
|
||
`prepare_image_input()` 返回路径及临时标记；`cleanup_image_input()` 与创建方配对。Cutout 的 `prepare_image_bounds_input()` 复用已读取的源 RGBA，输出指定几何 bounds 的矩形图片。
|
||
|
||
## 手势与 Selection
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[原生对象点选] --> B[ImageGesture 冻结源图与交互状态]
|
||
B --> C[屏幕路径与 Overlay]
|
||
C --> D[提交时投影到图片空间]
|
||
D --> E[SelectionPath]
|
||
E --> F[局部 non-zero winding 栅格化]
|
||
F --> G[SelectionMask values 与 bounds]
|
||
G --> H[Mask Alpha 运算或 Cutout 内容轮廓]
|
||
```
|
||
|
||
Brush 的圆形印记和连接条由 `brush_footprint_polygons()` 生成，供预览与提交共用。拖动时维护屏幕路径与局部 Overlay，提交时生成覆盖值。Mask、Rectify 与 Cutout 的空命中保留 active Image Empty；点中另一对象时完成原生选择。
|
||
|
||
## 材质、节点与对象
|
||
|
||
`create_image_material()` 连接颜色、法线、Alpha 和动画帧设置；材质显示适配读取当前 Preferences。`set_modifier_input()` 按实际 RNA 输入形式设置值，`finalize_object_result()` 完成结果对象激活和源对象处理。
|
||
|
||
Geometry Nodes 从 `src/anyimage/assets/O_AnyImage.blend` 按公开名称加载。构建与布局职责见[节点资产](node-assets.md)，深度字段见[Job 产物](outputs.md)。
|