> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# GenerateTracks - ComfyUI Built-in Node Documentation
> GenerateTracks 节点为视频生成创建多条平行的运动路径（轨道）。
`GenerateTracks` 节点为视频生成创建多条平行的运动路径（轨道）。它定义一条从起始位置到结束位置的主路径，然后生成一组与该路径平行的轨道，均匀间隔。您可以控制路径的形状（直线或贝塞尔曲线）、沿路径移动的速度以及轨道在哪些帧中可见。
## 输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -- | ------------------------------------------------------------------------------------ |
| `宽度` | 视频帧的宽度（以像素为单位）。默认值为 832。 | INT | 是 | 16 - 4096 |
| `高度` | 视频帧的高度（以像素为单位）。默认值为 480。 | INT | 是 | 16 - 4096 |
| `起始点X` | 起始位置的归一化 X 坐标（0-1）。默认值为 0.0。 | FLOAT | 是 | 0.0 - 1.0 |
| `起始点Y` | 起始位置的归一化 Y 坐标（0-1）。默认值为 0.0。 | FLOAT | 是 | 0.0 - 1.0 |
| `结束点X` | 结束位置的归一化 X 坐标（0-1）。默认值为 1.0。 | FLOAT | 是 | 0.0 - 1.0 |
| `结束点Y` | 结束位置的归一化 Y 坐标（0-1）。默认值为 1.0。 | FLOAT | 是 | 0.0 - 1.0 |
| `帧数` | 要生成轨道位置的总帧数。默认值为 81。 | INT | 是 | 1 - 1024 |
| `轨迹数` | 要生成的平行轨道数量。默认值为 5。 | INT | 是 | 1 - 100 |
| `轨道分布` | 轨道之间的归一化距离。轨道垂直于运动方向展开。默认值为 0.025。 | FLOAT | 是 | 0.0 - 1.0 |
| `贝塞尔曲线` | 启用贝塞尔曲线路径，使用中点作为控制点。默认值为 False。 | BOOLEAN | 是 | True / False |
| `中间点Y` | 贝塞尔曲线的归一化 X 控制点。仅在 `bezier` 启用时使用。默认值为 0.5。 | FLOAT | 是 | 0.0 - 1.0 |
| `中间点Y` | 贝塞尔曲线的归一化 Y 控制点。仅在 `bezier` 启用时使用。默认值为 0.5。 | FLOAT | 是 | 0.0 - 1.0 |
| `插值` | 控制沿路径移动的时序/速度（默认："linear"）：
"linear" - 匀速
"ease\_in" - 缓慢开始并加速
"ease\_out" - 快速开始并减速
"ease\_in\_out" - 平滑加速和减速
"constant" - 将所有位置保持在起始点 | COMBO | 是 | `"linear"`
`"ease_in"`
`"ease_out"`
`"ease_in_out"`
`"constant"` |
| `轨道遮罩` | 可选遮罩，用于指示可见帧。如果提供，遮罩中任何非零像素的帧都会被标记为对所有轨道可见。 | MASK | 否 | - |
**注意：** `mid_x` 和 `mid_y` 参数仅在 `bezier` 参数设置为 `True` 时使用。当 `bezier` 为 `False` 时，路径是从起点到终点的直线。
## 输出
| 输出名称 | 描述 | 数据类型 |
| -------- | -------------------------------- | ------ |
| `TRACKS` | 一个轨道对象，包含所有轨道在所有帧上生成的路径坐标和可见性信息。 | TRACKS |
| `轨迹长度` | 生成轨道的帧数，与输入的 `num_frames` 一致。 | INT |
> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/GenerateTracks/zh.md)
***
**Source fingerprint (SHA-256):** `4bd4d03a84f4b7ea260555b43f217af0b90dd4ca5196aca94e8f3886875ab912`