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

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

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

## 输入

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

注意：当 `samples` 潜变量包含 `coord_counts` 时，计数必须非负，其总和必须与坐标行数匹配，并且每个批次必须恰好包含预期的行数；否则节点会引发错误。如果潜变量的 `model_frame` 为 "z\_up"，则解码后的体素坐标会重新映射为 Y-up，以便与网格顶点对齐。当提供 `coord_resolution` 时，输出纹理分辨率是该值乘以 16。否则，它会从最大体素坐标加一推断得出，并向上舍入到 256、512、1024、1536 或 2048 之一；如果需要值超过 2048，则使用该更大值。如果没有可用坐标，分辨率默认为 1024。

## 输出

| 输出名称           | 描述                                                                                                                | 数据类型  |
| -------------- | ----------------------------------------------------------------------------------------------------------------- | ----- |
| `voxel_colors` | 解码后的体素数据，包含坐标、颜色特征和纹理分辨率。每个体素有 6 个颜色通道：基础颜色 (RGB)、金属度、粗糙度和 alpha，全部在 \[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):** `952ea7d7a0147519392bebe352a0da731462db278c8640fa527aa5b6f64e4aa7`