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

# Trellis2ShapeStage - ComfyUI Built-in Node Documentation

> このノードは、Trellis2 パイプラインの最初のシェイプ生成サンプリングパスをセットアップします。

このノードは、Trellis2 パイプラインの最初のシェイプ生成サンプリングパスをセットアップします。`VaeDecodeStructureTrellis2` が生成した高密度構造ボクセルを受け取り、塗りつぶされたボクセルのスパース座標を抽出し、空のスパース潜在変数を作成して、サンプリング中にモデルが読み取れるようにサンプリングメタデータをコンディショニングに添付します。アップサンプリング後の2番目のシェイプパスには、カスケードと2番目のパスのステージセットアップを組み合わせた `Trellis2UpsampleStage` を使用してください。

## 入力

| パラメータ      | 説明                                                                                                                                                 | データ型         | 必須 | 範囲                                                   |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | -- | ---------------------------------------------------- |
| `positive` | シェイプステージ用に準備するポジティブコンディショニング。標準の Trellis2 コンディショニングでも、投影フィーチャパックを提供する Pixal3D コンディショニングでも構いません。投影フィーチャが存在する場合は、選択されたステージ用に計算され、出力コンディショニングに添付されます。 | CONDITIONING | はい | 任意の Trellis2 または Pixal3D コンディショニング                   |
| `negative` | シェイプステージ用に準備するネガティブコンディショニング。ポジティブコンディショニングと同じシェイプステージメタデータが添付されます。                                                                                | CONDITIONING | はい | 任意の Trellis2 または Pixal3D コンディショニング                   |
| `voxel`    | `VaeDecodeStructureTrellis2` からの高密度構造ボクセル。                                                                                                         | VOXEL        | はい | 任意のボクセルグリッド。グリッド解像度（軸ごとのボクセル数）によってパイプラインステージが選択されます。 |

### 注記

* ボクセルグリッドの解像度によってパイプラインステージが選択されます。解像度が32以下の場合は `shape_512` ステージの `shape_generation_512` モードを使用し、解像度が32より大きい場合は `shape_1024` ステージの `shape_generation` モードを使用します。
* ボクセルには少なくとも1つの塗りつぶされたボクセルが含まれている必要があります。空のボクセルの場合はエラーが発生します。ボクセルから導出されるバッチインデックスは、非負かつ連続している必要があります。
* `positive` コンディショニングに `proj_feat_pack`（Pixal3D コンディショニングによって提供される）が含まれている場合、選択されたステージ用の投影フィーチャが計算され、出力潜在変数のモデルフレームが `y_up` に設定されます。それ以外の場合は、投影フィーチャは添付されず、モデルフレームは `z_up` に設定されます。

## 出力

| 出力名        | 説明                                                                                                 | データ型         |
| ---------- | -------------------------------------------------------------------------------------------------- | ------------ |
| `positive` | シェイプステージのメタデータ（生成モード、スパース座標、バッチごとの座標数、ソースコンディショニングが提供する場合は投影フィーチャ）が添付されたポジティブコンディショニング。            | CONDITIONING |
| `negative` | 同じシェイプステージのメタデータが添付されたネガティブコンディショニング。                                                              | CONDITIONING |
| `latent`   | 抽出されたスパース座標、バッチごとの座標数、座標解像度、型マーカー `trellis2`、モデルフレームの向きとともに、空のスパース潜在変数テンソル（形状: バッチサイズ、32、トークン数、1）。 | LATENT       |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Trellis2ShapeStage/ja.md)

***

**Source fingerprint (SHA-256):** `7dbee8a5b6ef7111f07def4dbe1cc4908533e00ffcb775f5a284099360c7eed3`