RemapFrames

baseClip	Frames from sourceClip are mapped into baseClip.
"filename"	The name of the text file that specifies the new frame mappings.
"mappings"	Mappings also may be given directly in a string. Overrides frame mappings given by filename.
"sourceClip"	The source clip used to supply the new, remapped frames. (Default: Same as baseClip.)

Does not affect the audio track.

Each line in the text file or in the mappings string must have one of the following forms:

• a z
  Replaces frame a in baseClip with frame z from sourceClip.
• [a b] z
  Replaces all frames in the inclusive range a..b of baseClip with frame z from sourceClip.
• [a b] [y z]
  Replaces all frames in the range a..b of baseClip with frames in the range y..z from the sourceClip. If the input and output ranges do not have equal sizes, frames will be duplicated or dropped evenly from y ..z to match the size of a..b. If y > z, the order of the output frames is reversed.
• # comment
  A comment. Comments may appear anywhere on a line; all text from the start of the # character to the end of the line is ignored.

Sample data file:

[0 9] [0 4]     # the first ten frames will be 0, 0, 1, 1, 2, 2, 3, 3, 4, 4
10 5            # show frame 5 in frame 10's place
[15 20] 6       # replace frames 15..20 with frame 6
[25 30] [35 40] # replace frames 25..30 with frames 35..40
[50 60] [60 50] # reverse the order of frames 50..60

Within each line, all whitespace is ignored.

By default, all frames are mapped to themselves.

If multiple lines remap the same frame, the last remapping overrides any previous ones.

# the frames in the generated clip will be
# 4, 0, 0, 0, 0, 0, 6, 7, ...
[0 5] 0
0 3
0 4

The output clip always will have the same number of frames as the input clip. To delete frames, remap the appropriate frames and then call Trim afterward.

BlankClip(length=100).ShowFrameNumber()

# Replace frames 50..89 with 60..99.  This effectively deletes frames
# 50..59.
RemapFrames(mappings="[50 89] [60 99]")

# Trim off the excess.
Trim(0, 89)

To add duplicate frames, call LengthenClip first and then remap the appropriate frames.

BlankClip(length=100).ShowFrameNumber()

LengthenClip(110)

# Duplicate frame 50 ten times, and delay all the subsequent frames by
# ten frames.
RemapFrames(mappings="[50 59] 50
                      [60 109] [50 99]")

"filename"	The name of the text file that specifies the new frame mappings.
"mappings"	Mappings alternatively may be given directly in a string. Unlike RemapFrames, mappings and filename cannot be used together.

Does not affect the audio track.

RemapFramesSimple takes a text file or a mappings string consisting of a sequence of frame numbers. The number of frame mappings determines the number of frames in the output clip. For example:

# Generate a clip containing only the first five frames.
RemapFramesSimple(mappings="0 1 2 3 4")

# Duplicate frame 20 five times.
RemapFramesSimple(mappings="20 20 20 20 20")

baseClip sourceClip	Frames from baseClip are replaced by frames from sourceClip.
"filename"	The name of the text file that specifies the frames to replace.
"mappings"	Replacement frames alternatively may be given directly in a string.

Does not affect the audio track.

ReplaceFramesSimple takes a text file or a mappings string consisting of sequences or ranges of frame numbers to replace. For example:

# Replaces frames 10..20, 25, and 30 from baseClip with the
# corresponding frames from sourceClip.
ReplaceFramesSimple(baseClip, sourceClip, mappings="[10 20] 25 30")

# Inverse-telecine a clip and fix individual frames that still show
# combing.
c = src.Telecide(...).Decimate(...)
deinterlaced = c.KernelDeint(...)

# Replace frames 30, 40, 50 with their deinterlaced versions.
ReplaceFramesSimple(c, deinterlaced, mappings="30 40 50")