> ## 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.

# BakeTextureFromVoxel - ComfyUI Built-in Node Documentation

> This node bakes PBR textures onto a 3D mesh using the mesh's existing UV layout.

This node bakes PBR textures onto a 3D mesh using the mesh's existing UV layout. It samples color and material attributes from a sparse voxel volume at each texel and outputs a base color image plus metallic and roughness maps. It does not unwrap the mesh, so a UV unwrap node must be connected upstream.

## Inputs

| Parameter        | Description                                                                                                                                   | Data Type | Required | Range      |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ---------- |
| `mesh`           | The 3D mesh to bake textures onto. Must already have a UV layout; a UV unwrap node must be connected upstream.                                | MESH      | Yes      |            |
| `voxel_colors`   | Sparse voxel volume containing per-voxel colors and optional PBR attributes (metallic and roughness channels).                                | VOXEL     | Yes      |            |
| `texture_size`   | Square UV atlas resolution (display name: "resolution", default: 2048).                                                                       | INT       | Yes      | 64 to 8192 |
| `reference_mesh` | Optional dense pre-decimation mesh; back-projects each texel onto its true surface before sampling, removing faceted baking on coarse meshes. | MESH      | No       |            |

Notes:

* The input mesh must have UVs. If no UVs are present, the node raises an error. UVs must be 1:1 with the vertices (one UV per vertex).
* When the mesh and voxel coordinates contain a batch dimension, each batch item is baked separately. If a batch item has no voxels or no faces, it is skipped and a black texture is emitted for it.
* When `reference_mesh` is provided for a batch, it is matched by batch index unless it contains only a single mesh, in which case that mesh is used for all items.

## Outputs

| Output Name  | Description                                                                                     | Data Type |
| ------------ | ----------------------------------------------------------------------------------------------- | --------- |
| `base_color` | RGB base color texture map. Values are float in the 0–1 range.                                  | IMAGE     |
| `metallic`   | Grayscale metallic map (float, 0–1). Black when the voxel colors contain no metallic channel.   | IMAGE     |
| `roughness`  | Grayscale roughness map (float, 0–1). Black when the voxel colors contain no roughness channel. | IMAGE     |

> 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/BakeTextureFromVoxel/en.md)

***

**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c`