Vapoursynth FrFun7

From wiki.selur.net
Revision as of 09:49, 16 November 2026 by Selur (talk | contribs) (Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

FrFun7 is a spatial "fractal" denoiser by Marc Fauconneau (prunedtree). It smooths flat areas and limits how strongly edges are smoothed, with separate limits for luma and chroma. It works on 8-bit material only.

Filtering → Vapoursynth → DeNoise

FrFun7 controls in Hybrid
FrFun7 controls in Hybrid

What it does

Each frame is denoised locally with a strength set by Lambda; at edges the change is capped by Luma and Chroma. The basic mode uses only the current frame; the other modes overlap the processing adaptively, include the neighbor frames, or adapt the radius.

Settings

Control Parameter Range / values Hybrid default Meaning
Lambda l 0 – 10 1.1 Strength of the local denoising.
Luma / Chroma t, tuv 0 – 10 6.0 / 2.0 Limit of the denoising at edges; 0 leaves the plane unchanged.
Type p basic, adaptive overlapping, temporal, adaptive radius basic Mode (written as 0, 1, 2, 4). Basic is the fastest and may leave small artifacts near lines; adaptive overlapping is slower and a little better; temporal also uses the neighbor frames.
Overlap threshold tp1 0 – 10 0 Adaptive overlapping only: above 0 some pixels are skipped.
1st pass radius r1 2, 3 3 Radius of the first internal pass; 2 is faster.

Example

Default settings on a 10-bit YUV 4:2:0 source:

# adjusting color space from YUV420P10 to YUV444P8 for vsFrFun7
clip = core.resize.Bicubic(clip=clip, format=vs.YUV444P8, dither_type="error_diffusion")
# denoising using VsFrFun7
clip = core.frfun7.Frfun7(clip)

How Hybrid calls it

  • FrFun7 takes 8-bit YUV and gray clips only; other formats are converted to 8 bit first.
  • Values are only written when they differ from the defaults; the overlap threshold only with adaptive overlapping.
  • FrFun7 also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

vapoursynth-frfun7

The VapourSynth plugin is a port of the AviSynth filter, reworked by Ferenc Pintér and dubhater; lambda is called l because lambda is a Python keyword. The C++ and SSE2 code give the same output. Internally the mode is a bit mask (1 adaptive overlapping, 2 temporal, 4 adaptive radius); the AviSynth documentation notes that combining the bits is probably pointless.

Sources