Preview3DAdvanced - ComfyUI Built-in Node Documentation

This node displays a 3D model preview in the UI without saving the file to the ComfyUI output directory. It saves the model to a temporary file and passes through the model data, model information, camera information, and preview dimensions for further processing downstream.

Inputs

Parameter	Description	Data Type	Required	Range
`model_3d`	3D model file from an upstream 3D node.	FILE3D	Yes	GLB, GLTF, FBX, OBJ, STL, USDZ, or any supported 3D format
`model_3d_info`	Placement of each model in the scene: position, rotation, and scale (Y-up world space). Optional. Advanced option.	LOAD3DMODELINFO	No	-
`viewport_state`	The current viewport state containing camera and model information.	LOAD3D	Yes	-
`camera_info`	Viewport camera information: position, look-at target, zoom, and type. Optional. Advanced option.	LOAD3DCAMERA	No	-
`width`	Render width of the viewport in pixels. Default: 1024.	INT	Yes	1 to 4096
`height`	Render height of the viewport in pixels. Default: 1024.	INT	Yes	1 to 4096

Note: When camera_info or model_3d_info are not connected, their values are taken from viewport_state when available. If viewport_state contains no camera information, camera_info is None. If viewport_state has no model information, model_3d_info defaults to an empty list. If viewport_state is not a dictionary, it is treated as empty.

Outputs

Output Name	Description	Data Type
`model_3d`	3D model file (glb/obj/stl/etc.) from an upstream 3D node, passed through unchanged.	FILE3D
`model_3d_info`	Placement of each model in the scene: position, rotation, and scale (Y-up world space). Uses the input value, or falls back to the value stored in `viewport_state`.	LOAD3DMODELINFO
`camera_info`	Viewport camera information: position, look-at target, zoom, and type. Uses the input value, or falls back to the value stored in `viewport_state`.	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

Source fingerprint (SHA-256): f2d3d35ed35fe68edebcde8fd8421d26850b04e3ae5b7147f1020c8ed904c480

​Inputs

​Outputs

Inputs

Outputs