delete_frames

delete_frames(
  input: Clip,
  #{
    frames: Array<Int>,
  }
)

Removes specific source frames from an input clip. Remaining frames keep their original order and are re-indexed after all deletions are applied.

The input must be one fixed-format planar Gray, YUV, or planar RGB clip with a finite frame count. frames contains zero-indexed source frame numbers from the input clip. The array may be empty, which returns a no-op clip. Entries must be non-negative, unique, and less than the input frame count. frames may be in any order, but it must not name every frame in the input clip.

Examples

output = source("input.mkv").std.delete_frames(#{ frames: [0, 10, 20] })

# No-op; useful when a script parameter expands to an empty deletion list.
output = source("input.mkv").std.delete_frames(#{ frames: [] })

Input

One fixed-format planar Gray, YUV, or planar RGB clip with a finite frame count.

Output

A clip with the same format, resolution, frame rate, and per-frame metadata, containing all source frames except those listed in frames.

Options

• frames (Array<Int>) – Zero-indexed source frames to delete.