UnwrapMesh - ComfyUI Built-in Node Documentation

Generates a UV atlas for a 3D mesh.

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