Skip to content

Commit fc53da2

Browse files
committed
Initialize the Load 3D documents
1 parent 8b5f5dd commit fc53da2

File tree

1 file changed

+35
-0
lines changed
  • comfyui_embedded_docs/docs/Load3d

1 file changed

+35
-0
lines changed
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
Load3D 节点是 ComfyUI 中用于加载和处理 3D 模型文件的核心节点
2+
3+
**文件读取**
4+
3D 模型文件从 ` ComfyUI/input/3d/` 目录读取,目录不存在时会自动创建。
5+
6+
**支持格式**
7+
目前该节点支持多种 3D 文件格式,包括 `.gltf``.glb``.obj``.fbx``.stl`
8+
9+
## 输入
10+
11+
| 参数名 | 类型 | 描述 | 默认值 | 范围 |
12+
|--------------|------------|--------------------------|--------|--------------|
13+
| model_file | 文件选择 | 3D 模型文件路径,支持上传 | - | 支持格式文件 |
14+
| image | LOAD_3D | 3D 渲染相关的图像数据 | - | - |
15+
| width | INT | 渲染宽度 | 1024 | 1-4096 |
16+
| height | INT | 渲染高度 | 1024 | 1-4096 |
17+
18+
## 输出
19+
20+
| 输出名称 | 数据类型 | 说明 |
21+
|------------------|----------------|------------------------|
22+
| image | IMAGE | 主渲染图像 |
23+
| mask | MASK | 遮罩图像 |
24+
| mesh_path | STRING | 网格文件路径 |
25+
| normal | IMAGE | 法线贴图 |
26+
| lineart | IMAGE | 线稿图像 |
27+
| camera_info | LOAD3D_CAMERA | 相机信息 |
28+
| recording_video | VIDEO | 录制视频(可选) |
29+
30+
## 处理流程
31+
32+
1. 文件路径解析:通过 `folder_paths.get_annotated_filepath()` 获取各类图像文件的完整路径。
33+
2. 图像加载:使用 `nodes.LoadImage()` 节点加载主图像、遮罩、法线贴图和线稿图像。
34+
3. 视频处理:如有录制文件,使用 `VideoFromFile` 创建视频对象。
35+
4. 结果返回:组装所有输出数据并返回。

0 commit comments

Comments
 (0)