File tree Expand file tree Collapse file tree 1 file changed +35
-0
lines changed
comfyui_embedded_docs/docs/Load3d Expand file tree Collapse file tree 1 file changed +35
-0
lines changed Original file line number Diff line number Diff line change 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 . 结果返回:组装所有输出数据并返回。
You can’t perform that action at this time.
0 commit comments