RemapFrames

Latest revision as of 22:52, 1 February 2021

[edit] Description

An AviSynth plug-in that remaps the frame indices in a clip as specified by an input text file or by an input string.

[edit] Requirements

• [x86] AviSynth+ or AviSynth 2.6.0
• [x64] AviSynth+

• Microsoft Visual C++ 2015 Redistributable Package (x86 / x64)

*** vcredist_x86.exe is required for RemapFrames-x86

*** vcredist_x64.exe is required for RemapFrames-x64

[edit] Overview

RemapFrames, RemapFramesSimple, and ReplaceFramesSimple provide general control over manipulation of frame indices in a clip. They can be used in cases where SelectEvery isn't suitable, such as when the desired frames don't follow a regular pattern.

RemapFrames/RemapFramesSimple/ReplaceFramesSimple also are efficient alternatives to long chains of FreezeFrame, DeleteFrame, or ApplyRange calls.

RemapFramesSimple and ReplaceFramesSimple are less powerful than RemapFrames but use a much simpler, more basic syntax.

remf, remfs and rfs are shortcuts for RemapFrames, RemapFramesSimple and ReplaceFramesSimple with slight differences. The mappings parameter comes before filename for a more compact "inline" call. These parameters are completely optional; when none of them is specified, an empty string is assumed. And when an empty string is detected, the filter is completely bypassed (no extra memory use). Also, these versions don't check aggressively the frame ranges. If a referenced frame doesn't exist, it's simply ignored or its index is replaced with the closest valid frame index. This allows working on partial ranges of a clip with a unique set of mappings.

[edit] Syntax

RemapFrames(clip baseClip, string "filename", string "mappings", clip "sourceClip")
RemapFramesSimple(clip c, string "filename", string "mappings")
ReplaceFramesSimple(clip baseClip, clip sourceClip, string "filename", string "mappings")

remf(clip baseClip, string "mappings", string "filename", clip "sourceClip")
remfs(clip c, string "mappings", string "filename")
rfs(clip baseClip, clip sourceClip, string "mappings", string "filename")

rfs_transform (string mappings, string "op", bool "open", bool "discrete")
rfs_merge (string "s0", string "s1", …, string "s9")

[edit] RemapFrames

[edit] Parameters

[edit] Usage

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]")
 

[edit] RemapFramesSimple

 # 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")
 

[edit] ReplaceFramesSimple

 # 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")
 

[edit] rfs_transform

 # Shifts the mappings 10 frames forward
 rfs_transform ("[100 199] 300 [400 999]", op="x 10  ")
 # result: "[110 209] 310 [410 1009]"
 

 # Dilates the mappings 5 times
 rfs_transform ("[100 199] 300 [400 999]", op="x 5 *")
 # result: "[500 999] [1500 1504] [2000 4999]"
 

[edit] rfs_merge

 # Shifts the mappings 10 frames forward
 rfs_transform ("[100 199]", "300", "[400 999]")
 # result: "[100 199] 300 [400 999]"
 

[edit] Adapting Existing Scripts

BlankClip(length=100).ShowFrameNumber()
FreezeFrame(10, 11, 10)
FreezeFrame(15, 16, 16)
FreezeFrame(20, 24, 21)
FreezeFrame(30, 32, 31)
FreezeFrame(35, 36, 36)

BlankClip(length=100).ShowFrameNumber()
RemapFrames(mappings="[10 11] 10
                      [15 16] 16
                      [20 24] 21
                      [30 32] 31
                      [35 36] 36")

BlankClip(length=100).ShowFrameNumber()
ApplyRange(10, 11, "SomeFilter")
ApplyRange(15, 16, "SomeFilter")
ApplyRange(20, 24, "SomeFilter")
ApplyRange(30, 32, "SomeFilter")
ApplyRange(35, 36, "SomeFilter")

src = BlankClip(length=100).ShowFrameNumber()
filtered = src.SomeFilter()
ReplaceFramesSimple(src, filtered,
\                   mappings="[10 11]
                              [15 16]
                              [20 24]
                              [30 32]
                              [35 36]")

[edit] Revision History

[edit] Archived Downloads

• v0.4.1-avs26 modified by Chikuzen

[edit] External Links

• GitHub - RemapFrames_audiomod; this is a modification that also remaps audio. Only works with the "simple" filter.

Back to External Filters ←