GenerateTracks - ComfyUI Built-in Node Documentation

The 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	-

Note: The 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

​Inputs

​Outputs

Inputs

Outputs