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

# Load3D - ComfyUI Built-in Node Documentation

> The Load3D node is a core node in ComfyUI for loading and previewing various 3D model files, supporting multi-format import and rich three-dimensional view operations.

The Load3D node is a core node for loading and processing 3D model files. When loading the node, it automatically retrieves available 3D resources from `ComfyUI/input/3d/`. You can also upload supported 3D files for preview using the upload function.

**Supported Formats**
Currently, this node supports multiple 3D file formats, including `.gltf`, `.glb`, `.obj`, `.fbx`, and `.stl`.

**3D Node Preferences**
Some related preferences for 3D nodes can be configured in ComfyUI's settings menu. Please refer to the following documentation for corresponding settings:

[Settings Menu - 3D](/interface/settings/3d)

Besides regular node outputs, Load3D has lots of 3D view-related settings in the canvas menu.

## Inputs

| Parameter Name | Type           | Description                                                                                   | Default | Range             |
| -------------- | -------------- | --------------------------------------------------------------------------------------------- | ------- | ----------------- |
| model\_file    | File Selection | 3D model file path, supports upload, defaults to reading model files from `ComfyUI/input/3d/` | -       | Supported formats |
| width          | INT            | Canvas rendering width                                                                        | 1024    | 1-4096            |
| height         | INT            | Canvas rendering height                                                                       | 1024    | 1-4096            |

## Outputs

| Parameter Name   | Data Type      | Description                                                                                    |
| ---------------- | -------------- | ---------------------------------------------------------------------------------------------- |
| image            | IMAGE          | Canvas rendered image                                                                          |
| mask             | MASK           | Mask containing current model position                                                         |
| mesh\_path       | STRING         | Model file path                                                                                |
| normal           | IMAGE          | Normal map                                                                                     |
| lineart          | IMAGE          | Line art image output, corresponding `edge_threshold` can be adjusted in the canvas model menu |
| camera\_info     | LOAD3D\_CAMERA | Camera information                                                                             |
| recording\_video | VIDEO          | Recorded video (only when recording exists)                                                    |

All corresponding outputs preview

<img src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/load3d_outputs.jpg?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=e20c650bc32875738947201617c88975" alt="View Operation Demo" width="2594" height="1272" data-path="images/comfy_core/load3d/load3d_outputs.jpg" />

## Canvas Area Description

The Load3D node's Canvas area contains numerous view operations, including:

* Preview view settings (grid, background color, preview view)
* Camera control: Control FOV, camera type
* Global illumination intensity: Adjust lighting intensity
* Video recording: Record and export videos
* Model export: Supports `GLB`, `OBJ`, `STL` formats
* And more

<img src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/load3d_ui.jpg?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=f47a4a55ab562e591cad6fa736681684" alt="Load 3D Node UI" width="2025" height="1696" data-path="images/comfy_core/load3d/load3d_ui.jpg" />

1. Contains multiple menus and hidden menus of the Load 3D node
2. Menu for `resizing preview window` and `canvas video recording`
3. 3D view operation axis
4. Preview thumbnail
5. Preview size settings, scale preview view display by setting dimensions and then resizing window

### 1. View Operations

<video controls muted loop playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/view_operations.mp4?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=bcf08946a6ed60a34b3438b4826e8b98" data-path="images/comfy_core/load3d/view_operations.mp4" />

View control operations:

* Left-click + drag: Rotate the view
* Right-click + drag: Pan the view
* Middle wheel scroll or middle-click + drag: Zoom in/out
* Coordinate axis: Switch views

### 2. Left Menu Functions

<img src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/menu.jpg?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=d7ec2202e57b1041f2b5ed92e49d600c" alt="Menu" width="1184" height="1582" data-path="images/comfy_core/load3d/menu.jpg" />

In the canvas, some settings are hidden in the menu. Click the menu button to expand different menus

* 1. Scene: Contains preview window grid, background color, preview settings
* 2. Model: Model rendering mode, texture materials, up direction settings
* 3. Camera: Switch between orthographic and perspective views, and set the perspective angle size
* 4. Light: Scene global illumination intensity
* 5. Export: Export model to other formats (GLB, OBJ, STL)

#### Scene

<img src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/menu_scene.jpg?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=1fe438e170739b3b153fd0cf781d0cfe" alt="scene menu" width="1671" height="1106" data-path="images/comfy_core/load3d/menu_scene.jpg" />

The Scene menu provides some basic scene setting functions

1. Show/Hide grid
2. Set background color
3. Click to upload a background image
4. Hide the preview

#### Model

<img src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/menu_model.jpg?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=684ef8f745dd35ca0c4ddb5b8676a2dd" alt="Menu_Scene" width="3605" height="1911" data-path="images/comfy_core/load3d/menu_model.jpg" />

The Model menu provides some model-related functions

1. **Up direction**: Determine which axis is the up direction for the model
2. **Material mode**: Switch model rendering modes - Original, Normal, Wireframe, Lineart

#### Camera

<img src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/menu_camera.jpg?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=05594b759791dec614d22327b9b4cf13" alt="menu_modelmenu_camera" width="1729" height="1434" data-path="images/comfy_core/load3d/menu_camera.jpg" />

This menu provides switching between orthographic and perspective views, and perspective angle size settings

1. **Camera**: Quickly switch between orthographic and orthographic views
2. **FOV**: Adjust FOV angle

#### Light

<img src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/menu_light.jpg?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=edd1c1409f678aea732f19782c88dbd3" alt="menu_modelmenu_camera" width="1729" height="740" data-path="images/comfy_core/load3d/menu_light.jpg" />

Through this menu, you can quickly adjust the scene's global illumination intensity

#### Export

<img src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/menu_export.jpg?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=7eeead4eafcf0d6a0654c01e7dfb2e09" alt="menu_export" width="1729" height="740" data-path="images/comfy_core/load3d/menu_export.jpg" />

This menu provides the ability to quickly convert and export model formats

### 3. Right Menu Functions

<video controls muted loop playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/dripart-mintlify-linear-mode-interface-docs-53934/KGfBPdkzkTj_-gwc/images/comfy_core/load3d/recording.mp4?fit=max&auto=format&n=KGfBPdkzkTj_-gwc&q=85&s=b27c93a6c11d51e60f07d510c51ddcd0" data-path="images/comfy_core/load3d/recording.mp4" />

The right menu has two main functions:

1. **Reset view ratio**: After clicking the button, the view will adjust the canvas rendering area ratio according to the set width and height
2. **Video recording**: Allows you to record current 3D view operations as video, allows import, and can be output as `recording_video` to subsequent nodes
