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

# Trellis2TextureStage - ComfyUI Built-in Node Documentation

> 此节点为 Trellis2 生成设置纹理阶段的采样过程。

此节点为 Trellis2 生成设置纹理阶段的采样过程。它从传入的 shape latent 中读取坐标布局和逐体素 shape latent，在相同坐标布局下构建一个具有 32 个通道的空稀疏 latent，并将所需的纹理阶段元数据附加到 conditioning。

## 输入

| 参数             | 描述                                                                                                                                                                | 数据类型         | 是否必需 | 范围 |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ---- | -- |
| `正面`           | 用于纹理生成过程的 positive conditioning。纹理阶段元数据会附加到其上。                                                                                                                    | CONDITIONING | 是    | -  |
| `负面`           | 用于纹理生成过程的 negative conditioning。纹理阶段元数据会附加到其上。                                                                                                                    | CONDITIONING | 是    | -  |
| `shape_latent` | 由 Trellis2ShapeStage 或 Trellis2UpsampleStage 生成的 latent 字典。它必须包含 `coords`（坐标布局，形状为 \[N, 4]）和 `samples`（逐体素 shape latent）；`coord_resolution` 和 `model_frame` 为可选项。 | LATENT       | 是    | -  |

注意：

* `shape_latent` 必须是 Trellis2ShapeStage 或 Trellis2UpsampleStage 的输出；它提供纹理阶段使用的坐标布局和逐体素 shape latent。
* 坐标布局会经过校验：`coords` 第一列中的 batch ID 必须为非负且连续，总行数必须与坐标数量匹配。
* 当 `positive` 携带投影特征包（Pixal3D conditioning）且 `shape_latent` 包含 `coord_resolution` 时，会计算 1024 纹理分辨率下的投影特征并将其附加到 conditioning 上。
* 模型坐标系会从 `shape_latent` 中读取；当不存在时，如果存在投影特征则默认为 `"y_up"`，否则默认为 `"z_up"`。

## 输出

| 输出名称     | 描述                                                                                                                                                          | 数据类型         |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| `正面`     | 附加了纹理阶段元数据的 positive conditioning（包括生成模式、坐标、坐标数量、shape latent、模型坐标系，以及适用时的投影特征）。                                                                            | CONDITIONING |
| `负面`     | 附加了相同纹理阶段元数据的 negative conditioning。                                                                                                                        | CONDITIONING |
| `latent` | 一个与传入 shape latent 具有相同坐标布局的新空稀疏 latent，包含 32 个通道。其字典包含 `samples`、`type`（`"trellis2"`）、`coords`、`coord_counts` 和 `model_frame`；当可用时还会包含 `coord_resolution`。 | LATENT       |

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

***

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