> ## 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 rasterizes the mesh in UV space and samples color and material attributes from a sparse voxel volume at each texel, outputting a base color image plus metallic and roughness maps. It does not unwrap the mesh, so a UV unwrap node must be connected upstream; the resulting images are intended to be paired with the same mesh in ApplyTextureToMesh for saving as GLB.

## 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.
* Texels that are not covered by any UV triangle are filled from the nearest covered texel so that texture seams do not pull in black.

## 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):** `080dcb670620f1cb97523d04fc45293e03d139e513845d0fa7b1c4d2f8bdf32d`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.