Add new node asset scripts for geometry and shader operations

- 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.
This commit is contained in:
2026-08-30 00:17:29 +08:00
parent 7d39fe8c5e
commit 32bcd45d7b
168 changed files with 7213 additions and 13121 deletions

View File

@@ -0,0 +1,40 @@
# 五分钟上手
这个流程会把一张静态图片转换为可继续编辑的 Depth Plane。
## 1. 导入图片
在 3D View 中选择 **Add > Image > Reference**,导入一张主体清晰、前后关系明确的图片。Blender 会创建一个 Image Empty。
## 2. 检查深度设置
打开 **Edit > Preferences > Extensions > AnyImage**。第一次使用建议保持默认:
- **Mesh Depth Model**:MoGe-2 ViT-S Normal
- **MoGe Resolution Level**:5
- **Device**:使用自动列出的首选设备
这些是扩展级默认值,转换时不会再弹出参数对话框。
## 3. 开始转换
选中 Image Empty,在 3D View 中右键选择 **AnyImage > Convert to Depth Plane**。如果环境或必需模型尚未就绪,AnyImage 会先引导完成安装或下载。
任务运行时,状态栏会显示准备输入、模型推理和结果导入进度。转换完成后,源 Image Empty 会被新的网格对象替代。
## 4. 调整结果
打开对象的 `O Image Depth Plane` Geometry Nodes 修改器:
- **Subdivide** 控制网格密度;
- **Thickness** 增加背面和侧壁,`0` 保持单面;
- **Depth Amount** 控制深度位移强度。
建议先用较低 Subdivide 调整 Depth Amount,再按成品需要增加细分。
## 接下来可以尝试
- 只需要普通图片卡片:[Plane](../guides/mesh-plane.md)
- 先获得透明前景:[去除背景](../guides/remove-background.md)
- 从局部选择生成透视表面:[Cutout](../guides/cutout.md)
- 了解深度数据如何进入节点:[Convert to Plane 实现原理](../internals/operators/convert-to-plane.md)