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

> 此节点使用 VAE 将 Trellis2 纹理潜在变量解码为体素颜色。

此节点使用 VAE 将 Trellis2 纹理潜在变量解码为体素颜色。输入的潜在变量包含带有坐标的稀疏特征样本；节点为每个体素重建颜色，并将结果作为体素网格返回，供下游节点（如 PaintMesh）用于为 3D 网格着色。

## 输入

| 参数     | 描述                                                     | 数据类型              | 必填 | 范围 |
| ------ | ------------------------------------------------------ | ----------------- | -- | -- |
| `样本`   | 要解码的纹理潜在变量。它包含样本特征和稀疏坐标，并可能包含可选元数据，例如坐标计数、模型坐标系和坐标分辨率。 | LATENT            | 是  | —  |
| `vae`  | 用于将纹理潜在变量解码为体素颜色的 Trellis2 VAE。                        | VAE               | 是  | —  |
| `形状细分` | 用于在解码过程中引导更高细节重建的形状信息。有助于在更高分辨率下保持结构一致性。               | SHAPE\_SUBDIVIDES | 是  | —  |

注意：当 `samples` 潜在变量包含坐标计数时，计数必须为非负数，其总和必须与坐标行数匹配，且每个批次必须恰好具有预期的行数；否则节点将引发错误。如果潜在变量的模型坐标系为 "z\_up"，则解码后的体素坐标会重新映射为 Y-up，以便与网格顶点对齐。当提供了坐标分辨率时，输出纹理分辨率等于该值乘以 16；否则，将从最大体素坐标推断，并向上取整为 256、512、1024、1536 或 2048 之一（当没有可用坐标时为 1024）。

## 输出

| 输出名    | 描述                                                                                                         | 数据类型  |
| ------ | ---------------------------------------------------------------------------------------------------------- | ----- |
| `体素颜色` | 包含坐标、颜色特征和纹理分辨率的已解码体素数据。每个体素具有 6 个颜色通道：基础颜色 (RGB)、金属度、粗糙度和透明度，取值范围为 \[0, 1]。顶点颜色消费方（如 PaintMesh）使用前 3 个通道。 | VOXEL |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/VaeDecodeTextureTrellis/zh.md)

***

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