> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/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 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"<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, 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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/UnwrapMesh/en.md)

***

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