join

join(
  input: [Clip, Clip, ...]
)

Concatenates frames from two or more clips in input order.

Use array input form: std.join([a, b]). Every input clip must use fixed format, fixed resolution, finite frame count, and constant frame rate. All inputs must match on format, resolution, and frame rate. Input frame counts may differ.

The output frame count is the sum of all input frame counts. The output frame rate matches the inputs.

Examples

a = source("part-1.mkv")
b = source("part-2.mkv")
output = std.join([a, b])

intro = source("intro.mkv")
main = source("main.mkv")
credits = source("credits.mkv")
output = std.join([intro, main, credits])

Input

Two or more fixed-format planar Gray, YUV, or planar RGB clips with matching resolution, finite frame counts, and matching constant frame rate, passed in array form.

Output

A clip with the same format, resolution, and frame rate, containing each input clip’s frames in order. The output frame count is the sum of the input frame counts, and per-frame metadata comes from the selected source frame.