Load3DAdvanced - ComfyUI Built-in Node Documentation - ComfyUI

The Load 3D (Advanced) node loads a 3D model file from your ComfyUI input directory and provides the model data along with camera and viewport information. It supports common 3D file formats and allows you to specify the output image dimensions.

Inputs

Parameter	Description	Data Type	Required	Range
`model_file`	The 3D model file to load. Select “none” to skip loading a model.	STRING	Yes	`"none"` List of available 3D files in the `input/3d` directory
`viewport_state`	The current viewport state containing camera and model information from the 3D viewer.	LOAD3D	Yes	-
`width`	The width of the output image in pixels (default: 1024).	INT	Yes	Min: 1 Max: 4096 Step: 1
`height`	The height of the output image in pixels (default: 1024).	INT	Yes	Min: 1 Max: 4096 Step: 1

Notes on Parameters:

The model_file parameter only shows files with the following extensions: .gltf, .glb, .obj, .fbx, .stl
Files must be placed in the input/3d directory of your ComfyUI installation
If model_file is set to “none”, no 3D model data will be loaded (the output model_3d 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}“

Outputs

Output Name	Description	Data Type
`model_3d`	The loaded 3D model data, or empty if no model file was selected.	FILE3DANY
`model_3d_info`	Information about the loaded 3D model from the viewport state.	LOAD3DMODELINFO
`camera_info`	Camera information from the viewport state.	LOAD3DCAMERA
`width`	The specified output image width.	INT
`height`	The specified output image height.	INT

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

Source fingerprint (SHA-256): 682edf36af114661e42556b3f461d0e2a4b38db34a2d3cdfd9319b7f10698645