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

# VaeDecodeTextureTrellis - ComfyUI Built-in Node Documentation

> This node decodes a Trellis2 texture latent into voxel colors using a VAE.

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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/VaeDecodeTextureTrellis/en.md)

***

**Source fingerprint (SHA-256):** `cfbe59efb18d2c3c7c597c5212900fea54d660aa98005817debf4711401a6967`