Load3D - ComfyUI Built-in Node Documentation

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 Besides regular node outputs, Load3D has lots of 3D view-related settings in the canvas menu.

Inputs

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

Outputs

Parameter Name	Description	Data Type
image	Canvas rendered image	IMAGE
mask	Mask containing current model position	MASK
mesh_path	Model file path	STRING
normal	Normal map	IMAGE
lineart	Line art image output, corresponding `edge_threshold` can be adjusted in the canvas model menu	IMAGE
camera_info	Camera information	LOAD3D_CAMERA
recording_video	Recorded video (only when recording exists)	VIDEO

All the outputs preview:

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

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

1. View Operations

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

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
1. Model: Model rendering mode, texture materials, up direction settings
1. Camera: Switch between orthographic and perspective views, and set the perspective angle size
1. Light: Scene global illumination intensity
1. Export: Export model to other formats (GLB, OBJ, STL)

Scene

The Scene menu provides some basic scene setting functions

Show/Hide grid
Set background color
Click to upload a background image
Hide the preview

Model

The Model menu provides some model-related functions

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

Camera

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

Camera: Quickly switch between orthographic and orthographic views
FOV: Adjust FOV angle

Light

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

Export

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

The right menu has two main functions:

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

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Load3D - ComfyUI Built-in Node Documentation

Inputs

Outputs