> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-giscus-unauthenticated-handling.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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/load3d_outputs.jpg?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=5e456e8aeabf748d38c01a3b553cb6b6" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/load3d_ui.jpg?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=61c86969cc60aef3120baaf247289c93" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/view_operations.mp4?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=adfabec67fe3ba5ea7fd868cade951da" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/menu.jpg?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=8433c710c87e7ad328e225cd65c784a8" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/menu_scene.jpg?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=9ec69595300005780ba8372b5778fde2" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/menu_model.jpg?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=09cf56d149493534a9b07f0aa7f54076" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/menu_camera.jpg?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=d48bd5a212e8ea610c9b5990b9bcaf72" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/menu_light.jpg?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=a26c4e68f32b24e131111f6d691ee99a" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/menu_export.jpg?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=42ad4ee6552eaedb16a6172480a51fda" 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-feat-giscus-unauthenticated-handling/hhDBsFue28iPO-jE/images/comfy_core/load3d/recording.mp4?fit=max&auto=format&n=hhDBsFue28iPO-jE&q=85&s=c80665f9aed64ae058243774292c3c96" 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
