GenerateTracks - ComfyUI Built-in Node Documentation

本文档由 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` 匹配。