> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GenerateTracks - ComfyUI Built-in Node Documentation

> Complete documentation for the GenerateTracks node in ComfyUI. Learn its inputs, outputs, parameters and usage.

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

`GenerateTracks` 节点为视频生成创建多条平行的运动轨迹。它定义了一条从起点到终点的主路径，然后生成一组与此路径平行、均匀间隔的轨迹。您可以控制路径的形状（直线或贝塞尔曲线）、沿路径移动的速度以及轨迹在哪些帧中可见。

## 输入参数

| 参数              | 数据类型    | 必填 | 范围                                                                                   | 描述                                          |
| --------------- | ------- | -- | ------------------------------------------------------------------------------------ | ------------------------------------------- |
| `width`         | INT     | 是  | 16 - 4096                                                                            | 视频帧的宽度（像素）。默认值为 832。                        |
| `height`        | INT     | 是  | 16 - 4096                                                                            | 视频帧的高度（像素）。默认值为 480。                        |
| `start_x`       | FLOAT   | 是  | 0.0 - 1.0                                                                            | 起点位置的归一化 X 坐标 (0-1)。默认值为 0.0。               |
| `start_y`       | FLOAT   | 是  | 0.0 - 1.0                                                                            | 起点位置的归一化 Y 坐标 (0-1)。默认值为 0.0。               |
| `end_x`         | FLOAT   | 是  | 0.0 - 1.0                                                                            | 终点位置的归一化 X 坐标 (0-1)。默认值为 1.0。               |
| `end_y`         | FLOAT   | 是  | 0.0 - 1.0                                                                            | 终点位置的归一化 Y 坐标 (0-1)。默认值为 1.0。               |
| `num_frames`    | INT     | 是  | 1 - 1024                                                                             | 要为其生成轨迹位置的总帧数。默认值为 81。                      |
| `num_tracks`    | INT     | 是  | 1 - 100                                                                              | 要生成的平行轨迹数量。默认值为 5。                          |
| `track_spread`  | FLOAT   | 是  | 0.0 - 1.0                                                                            | 轨迹之间的归一化距离。轨迹沿垂直于运动方向的方向展开。默认值为 0.025。      |
| `bezier`        | BOOLEAN | 是  | True / False                                                                         | 启用使用中点作为控制点的贝塞尔曲线路径。默认值为 False。             |
| `mid_x`         | FLOAT   | 是  | 0.0 - 1.0                                                                            | 贝塞尔曲线的归一化 X 控制点。仅在启用 `bezier` 时使用。默认值为 0.5。 |
| `mid_y`         | FLOAT   | 是  | 0.0 - 1.0                                                                            | 贝塞尔曲线的归一化 Y 控制点。仅在启用 `bezier` 时使用。默认值为 0.5。 |
| `interpolation` | COMBO   | 是  | `"linear"`<br />`"ease_in"`<br />`"ease_out"`<br />`"ease_in_out"`<br />`"constant"` | 控制沿路径移动的时序/速度。默认值为 "linear"。                |
| `track_mask`    | MASK    | 否  | -                                                                                    | 指示可见帧的可选遮罩。                                 |

**注意：** `mid_x` 和 `mid_y` 参数仅在 `bezier` 参数设置为 `True` 时使用。当 `bezier` 为 `False` 时，路径是从起点到终点的直线。

## 输出

| 输出名称           | 数据类型   | 描述                              |
| -------------- | ------ | ------------------------------- |
| `TRACKS`       | TRACKS | 一个轨迹对象，包含所有帧中所有轨迹的生成路径坐标和可见性信息。 |
| `track_length` | INT    | 生成轨迹的帧数，与输入的 `num_frames` 匹配。   |