UnwrapMesh - ComfyUI Built-in Node Documentation

Generates a UV atlas for a 3D mesh. The mesh surface is split into charts, each chart is flattened into two dimensions, and the flattened charts are packed into a [0,1] UV atlas. Vertices on chart seams are duplicated (one copy per chart, same position, own UV), so the output mesh can contain more vertices than the input mesh, and the output faces may differ in count from the input.

Inputs

Parameter	Description	Data Type	Required	Range
`mesh`	The input mesh to unwrap. Accepts a single mesh or a batch of meshes; batches are processed one item at a time.	MESH	Yes	—
`segmenter`	Charting algorithm to use. `pec`: fast parallel-edge-collapse charting on GPU. `adaptive`: CPU, slower. (default: “pec”)	COMBO	Yes	”pec" "adaptive”
`resolution`	Target atlas resolution for texel-density auto-scale (0 = fit-to-content). (default: 1024)	INT	Yes	0 to 8192 (step 256)
`padding`	Texel padding between charts. (default: 1)	INT	Yes	0 to 16
`weld_distance`	Coincident-vert merge radius as a fraction of mesh extent (0 = auto). Raise to ~0.001 if you get per-triangle charts (unwelded input). (default: 0.0)	FLOAT	Yes	0.0 to 1.0 (step 0.0001)

Note: if the input mesh contains unwelded vertices, the node may warn that face adjacency is low and produce per-face UV charts; increasing weld_distance merges coincident vertices before unwrapping. Degenerate faces (faces that reuse the same vertex index) are dropped during processing.

Outputs

Output Name	Description	Data Type
`mesh`	The input mesh with a generated UV atlas in the range [0,1]. Seam vertices are duplicated, so the output vertex count can exceed the input. Vertex colors and texture from the input mesh are preserved.	MESH

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): fcab6f0b621693d862ee74b5ec498498d2f1f247a66f478704377598a6b39388

​Inputs

​Outputs

Inputs

Outputs