Vapoursynth FillDuplicateFrames

From wiki.selur.net
Revision as of 09:49, 16 November 2026 by Selur (talk | contribs) (New filter page (via create-page on MediaWiki MCP Server))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

FillDuplicateFrames detects runs of repeated frames and replaces the repeats with frames interpolated between the last unique frame before and the first unique frame after the run, so motion becomes smooth again.

Filtering → Vapoursynth → Frame → Replace

FillDuplicateFrames controls in Hybrid
FillDuplicateFrames controls in Hybrid

What it does

A frame counts as a duplicate when its luma differs from the previous frame by no more than Threshold. For each run of duplicates, the frames are rebuilt by interpolating from the unique frame before to the unique frame after the run, spread evenly over the gap. This helps with stuttering captures or held frames. Runs that touch a scene change or the end of the clip are left alone. For single dropped frames only, see FillDrops.

Requirements

  • SVP, SVPcpu: SVP must be installed (only then are they listed).
  • RIFE: a Vulkan-capable GPU.
  • MV: CPU; the mvgpu implementation needs Vulkan.

Settings

Control Parameter Range / values Hybrid default Meaning
Method method SVP, SVPcpu, RIFE, MV SVP (MV without SVP) Interpolator: SVP on the GPU, SVP on the CPU, RIFE, or MVTools. Without SVP the SVP methods are not offered.
Threshold thresh 0.000001 – 0.999 0.0001 Largest normalized luma difference to the previous frame that still counts as a duplicate.
SC thresh sceneThr 0 – 0.999 0.15 A larger difference counts as a scene change; used by all methods. 0 = off.
RIFE model rifeModel RIFE models rife-v4.5 (ensemble) RIFE model (method RIFE).
Debug debug on/off off Shows the difference value and the source of each frame in the preview.
Tools: MV – mvgpu, mvutensils, mv – MVTools implementation (method MV).

Example

Default settings on a 10-bit YUV 4:2:0 source (640x356):

# adjusting color space from YUV420P10 to YUV420P8 for vsFillDuplicateFrames
clip = core.resize.Bicubic(clip=clip, format=vs.YUV420P8, dither_type="error_diffusion")
from FillDuplicateFrames import FillDuplicateFrames
fdf = FillDuplicateFrames(clip=clip, tools={'mv': 'mvutensils'})
clip = fdf.out

How Hybrid calls it

  • Color formats: SVP and SVPcpu work on 8-bit YUV 4:2:0, MV on 8–16-bit YUV, RIFE on 32-bit float RGB; the clip is converted as needed. FillDuplicateFrames is not offered for interlaced material.
  • Threshold and SC thresh are normalized values and do not depend on the bit depth. Options are only written when they differ from the defaults; the RIFE model is always written for method RIFE.
  • Replaced frames keep the frame properties (such as the frame duration) of the original frame.
  • Frame count and frame rate do not change.

Background

Interpolation

For a run of n duplicates the interpolator creates n new frames between the two unique frames (RIFE with a factor of n+1, MVTools via flow interpolation, SVP via its frame rate conversion). The same detection and interpolation is used by FillDrops and ReplaceSingle.

Sources