GenerateTracks - ComfyUI Built-in Node Documentation

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

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

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" "ease_in" "ease_out" "ease_in_out" "constant"	控制沿路径移动的时序/速度。默认值为 “linear”。
track_mask	MASK	否	-	指示可见帧的可选遮罩。

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

​

输出

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