UnwrapMesh - ComfyUI Built-in Node Documentation - ComfyUI

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, so the output mesh can contain more vertices than the input mesh.

Inputs

Parameter	Description	Data Type	Required	Range
`mesh`	The input mesh to unwrap. Accepts a single mesh or a batch of meshes.	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.

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