> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# UnwrapMesh - ComfyUI Built-in Node Documentation

> Generates a UV atlas for a 3D mesh.

Generates a UV atlas for a 3D mesh. The surface is split into charts, each chart is flattened into two dimensions, and the results 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.

## 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"<br />"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 (triangle soup), 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 \[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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/UnwrapMesh/en.md)

***

**Source fingerprint (SHA-256):** `cf0dbbe43df507921e6e9795b42d5cb5691ccc2ae98a8bb17e02e3928ea0b815`