VaeDecodeTextureTrellis - ComfyUI Built-in Node Documentation - ComfyUI

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

Source fingerprint (SHA-256): cfbe59efb18d2c3c7c597c5212900fea54d660aa98005817debf4711401a6967