> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/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 (`coord_counts`), model frame (`model_frame`, default: "y\_up"), and coordinate resolution (`coord_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 `coord_counts`, the counts must be non-negative, their total must match the number of coordinate rows, and each batch must contain 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 `coord_resolution` is supplied, the output texture resolution is that value multiplied by 16. Otherwise it is inferred from the largest voxel coordinate plus one, rounded up to one of 256, 512, 1024, 1536, or 2048; if the needed value exceeds 2048, that larger value is used. If no coordinates are available, the resolution defaults to 1024.

## 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):** `952ea7d7a0147519392bebe352a0da731462db278c8640fa527aa5b6f64e4aa7`