Trellis2 VAE 解码纹理 - ComfyUI Built-in Node Documentation

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

此节点使用 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 上编辑

Source fingerprint (SHA-256): 952ea7d7a0147519392bebe352a0da731462db278c8640fa527aa5b6f64e4aa7