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

---

Source fingerprint (SHA-256): 080dcb670620f1cb97523d04fc45293e03d139e513845d0fa7b1c4d2f8bdf32d