BakeTextureFromVoxel - ComfyUI Built-in Node Documentation - ComfyUI

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): 419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c