# GenerateTracks

`GenerateTracks` 節點為影片生成建立多條平行的運動路徑（軌道）。它定義從起始位置到結束位置的主路徑，然後生成一組與此路徑平行且均勻間隔的軌道。您可以控制路徑的形狀（直線或貝茲曲線）、沿路徑移動的速度，以及軌道在哪些影格中可見。

## 輸入

| 參數 | 描述 | 資料型別 | 必填 | 範圍 |
| --- | --- | --- | --- | --- |
| `width` | 影片影格的寬度（像素）。預設值為 832。 | INT | 是 | 16 - 4096 |
| `height` | 影片影格的高度（像素）。預設值為 480。 | INT | 是 | 16 - 4096 |
| `start_x` | 起始位置的正規化 X 座標（0-1）。預設值為 0.0。 | FLOAT | 是 | 0.0 - 1.0 |
| `start_y` | 起始位置的正規化 Y 座標（0-1）。預設值為 0.0。 | FLOAT | 是 | 0.0 - 1.0 |
| `end_x` | 結束位置的正規化 X 座標（0-1）。預設值為 1.0。 | FLOAT | 是 | 0.0 - 1.0 |
| `end_y` | 結束位置的正規化 Y 座標（0-1）。預設值為 1.0。 | FLOAT | 是 | 0.0 - 1.0 |
| `num_frames` | 要生成軌道位置的影格總數。預設值為 81。 | INT | 是 | 1 - 1024 |
| `num_tracks` | 要生成的平行軌道數量。預設值為 5。 | INT | 是 | 1 - 100 |
| `track_spread` | 軌道之間的正規化距離。軌道垂直於運動方向分佈。預設值為 0.025。 | FLOAT | 是 | 0.0 - 1.0 |
| `bezier` | 使用中點作為控制點，啟用貝茲曲線路徑。預設值為 False。 | BOOLEAN | 是 | True / False |
| `mid_x` | 貝茲曲線的正規化 X 控制點。僅在啟用 `bezier` 時使用。預設值為 0.5。 | FLOAT | 是 | 0.0 - 1.0 |
| `mid_y` | 貝茲曲線的正規化 Y 控制點。僅在啟用 `bezier` 時使用。預設值為 0.5。 | FLOAT | 是 | 0.0 - 1.0 |
| `interpolation` | 控制沿路徑移動的時間/速度（預設為 "linear"）：<br>"linear" - 恆定速度<br>"ease_in" - 開始慢，然後加速<br>"ease_out" - 開始快，然後減速<br>"ease_in_out" - 平穩的加速與減速<br>"constant" - 將所有位置保持在起始點 | COMBO | 是 | `"linear"`<br>`"ease_in"`<br>`"ease_out"`<br>`"ease_in_out"`<br>`"constant"` |
| `track_mask` | 可選遮罩，用於指示可見影格。若提供，遮罩中任何非零像素所在的影格會被標記為所有軌道可見。 | MASK | 否 | - |

**注意：** `mid_x` 和 `mid_y` 參數僅在 `bezier` 參數設為 `True` 時使用。當 `bezier` 為 `False` 時，路徑是從起始點到結束點的直線。

## 輸出

| 輸出名稱 | 描述 | 資料型別 |
| --- | --- | --- |
| `TRACKS` | 一個軌道物件，包含生成的路徑座標及所有影格中所有軌道的可見性資訊。 | TRACKS |
| `track_length` | 生成軌道所對應的影格數，與輸入的 `num_frames` 相符。 | INT |

> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議，歡迎貢獻！ [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GenerateTracks/zh-TW.md)

---
**Source fingerprint (SHA-256):** `4bd4d03a84f4b7ea260555b43f217af0b90dd4ca5196aca94e8f3886875ab912`
