> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Load3DAdvanced - ComfyUI Built-in Node Documentation

> The Load 3D (Advanced) node loads a 3D model file from ComfyUI's input/3d directory and provides the model data together with model placement and camera information captured in the

The Load 3D (Advanced) node loads a 3D model file from ComfyUI's `input/3d` directory and provides the model data together with model placement and camera information captured in the 3D viewer's viewport state. It supports common 3D file formats and lets you set the render width and height of the viewport in pixels. This node is experimental.

## Inputs

| Parameter        | Description                                                                                                           | Data Type | Required | Range                                                              |
| ---------------- | --------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ------------------------------------------------------------------ |
| `model_file`     | The 3D model file to load. Select "none" to skip loading a model file. Files can also be uploaded through the widget. | COMBO     | Yes      | `"none"`<br />Available 3D model files in the `input/3d` directory |
| `viewport_state` | The current viewport state containing camera and model information from the 3D viewer.                                | LOAD3D    | Yes      | -                                                                  |
| `width`          | Render width of the viewport in pixels (default: 1024).                                                               | INT       | Yes      | Min: 1<br />Max: 4096<br />Default: 1024<br />Step: 1              |
| `height`         | Render height of the viewport in pixels (default: 1024).                                                              | INT       | Yes      | Min: 1<br />Max: 4096<br />Default: 1024<br />Step: 1              |

**Notes on Parameters:**

* The `model_file` parameter only lists files with the following extensions: .gltf, .glb, .obj, .fbx, .stl
* Files must be placed in the `input/3d` directory of your ComfyUI installation; subfolders are searched as well, and file paths are shown relative to the input directory
* If `model_file` is "none", no model data is loaded and the `model_3d` output will be empty
* If `model_file` is set to a file that does not exist, the node returns a validation error: "Invalid 3D model file: \{model\_file}"
* If `viewport_state` is not a valid viewport state object, it is treated as empty, so `model_3d_info` becomes an empty list and `camera_info` is returned as empty

## Outputs

| Output Name     | Description                                                                             | Data Type       |
| --------------- | --------------------------------------------------------------------------------------- | --------------- |
| `model_3d`      | Loaded 3D model file (glb/obj/stl/etc.). Empty if no model file was selected.           | FILE3DANY       |
| `model_3d_info` | Placement of each model in the scene: position, rotation, and scale (Y-up world space). | LOAD3DMODELINFO |
| `camera_info`   | Viewport camera information: position, look-at target, zoom, and type.                  | LOAD3DCAMERA    |
| `width`         | Render width of the viewport in pixels.                                                 | INT             |
| `height`        | Render height of the viewport in pixels.                                                | INT             |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3DAdvanced/en.md)

***

**Source fingerprint (SHA-256):** `c79c53dde0c8b3afb7df7b972df749f5040c92d48b47e355c4497d9b0cbf1c22`
