VaeDecodeTextureTrellis - ComfyUI Built-in Node Documentation

This node decodes a Trellis2 texture latent into voxel colors using a VAE. The input latent contains sparse feature samples with coordinates; the node reconstructs the color for each voxel and returns the result as a voxel grid that downstream nodes, such as PaintMesh, can use to color a 3D mesh.

Inputs

Parameter	Description	Data Type	Required	Range
`samples`	The texture latent to decode. It contains the sample features and sparse coordinates, and may include optional metadata such as coordinate counts, model frame, and coordinate resolution.	LATENT	Yes	—
`vae`	The Trellis2 VAE used to decode the texture latent into voxel colors.	VAE	Yes	—
`shape_subdivides`	Shape information used to guide higher-detail reconstruction during decoding. Helps preserve structure consistency at higher resolutions.	SHAPE_SUBDIVIDES	Yes	—

Note: When the samples latent includes coordinate counts, the counts must be non-negative, their total must match the number of coordinate rows, and each batch must have exactly the expected number of rows; otherwise the node raises an error. If the latent’s model frame is “z_up”, the decoded voxel coordinates are remapped to Y-up so they align with mesh vertices. When a coordinate resolution is supplied, the output texture resolution is that value multiplied by 16; otherwise it is inferred from the largest voxel coordinate and rounded up to one of 256, 512, 1024, 1536, or 2048 (1024 when no coordinates are available).

Outputs

Output Name	Description	Data Type
`voxel_colors`	Decoded voxel data containing coordinates, color features, and texture resolution. Each voxel has 6 color channels: base color (RGB), metallic, roughness, and alpha, all in the range [0, 1]. Vertex-color consumers such as PaintMesh use the first 3 channels.	VOXEL

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): cfbe59efb18d2c3c7c597c5212900fea54d660aa98005817debf4711401a6967

​Inputs

​Outputs

Inputs

Outputs