GenerateTracks - ComfyUI 組み込みノードのドキュメント

ComfyUI の GenerateTracks ノードに関する完全なドキュメントです。入力、出力、パラメーターおよび使用方法について学びましょう。

このドキュメントは 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 と一致します。