GenerateTracks node creates multiple parallel motion paths for video generation. It defines a primary path from a start point to an end point, then generates a set of tracks that run parallel to this path, spaced evenly apart. You can control the shape of the path (straight line or Bezier curve), the speed of movement along it, and which frames the tracks are visible in.
Inputs
| Parameter | Description | Data Type | Required | Range |
|---|---|---|---|---|
width | The width of the video frame in pixels. The default value is 832. | INT | Yes | 16 - 4096 |
height | The height of the video frame in pixels. The default value is 480. | INT | Yes | 16 - 4096 |
start_x | Normalized X coordinate (0-1) for start position. The default value is 0.0. | FLOAT | Yes | 0.0 - 1.0 |
start_y | Normalized Y coordinate (0-1) for start position. The default value is 0.0. | FLOAT | Yes | 0.0 - 1.0 |
end_x | Normalized X coordinate (0-1) for end position. The default value is 1.0. | FLOAT | Yes | 0.0 - 1.0 |
end_y | Normalized Y coordinate (0-1) for end position. The default value is 1.0. | FLOAT | Yes | 0.0 - 1.0 |
num_frames | The total number of frames for which to generate track positions. The default value is 81. | INT | Yes | 1 - 1024 |
num_tracks | The number of parallel tracks to generate. The default value is 5. | INT | Yes | 1 - 100 |
track_spread | Normalized distance between tracks. Tracks are spread perpendicular to the motion direction. The default value is 0.025. | FLOAT | Yes | 0.0 - 1.0 |
bezier | Enable Bezier curve path using the mid point as control point. The default value is False. | BOOLEAN | Yes | True / False |
mid_x | Normalized X control point for Bezier curve. Only used when ‘bezier’ is enabled. The default value is 0.5. | FLOAT | Yes | 0.0 - 1.0 |
mid_y | Normalized Y control point for Bezier curve. Only used when ‘bezier’ is enabled. The default value is 0.5. | FLOAT | Yes | 0.0 - 1.0 |
interpolation | Controls the timing/speed of movement along the path. The default value is “linear”. | COMBO | Yes | "linear""ease_in""ease_out""ease_in_out""constant" |
track_mask | Optional mask to indicate visible frames. | MASK | No | - |
mid_x and mid_y parameters are only used when the bezier parameter is set to True. When bezier is False, the path is a straight line from the start to the end point.
Outputs
| Output Name | Description | Data Type |
|---|---|---|
TRACKS | A tracks object containing the generated path coordinates and visibility information for all tracks across all frames. | TRACKS |
track_length | The number of frames for which tracks were generated, matching the input num_frames. | INT |
This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub
Source fingerprint (SHA-256):
e4070f3f092bccaf8410800e36b97f5dc56584847221cfeca469b2bb4ca44355