Vapoursynth DeDot

From wiki.selur.net
Jump to navigation Jump to search

DeDot reduces dot crawl (cross-luminance) and rainbows (cross-color), the typical artifacts of composite video. It works mainly over time and leaves moving objects alone.

Filtering → Vapoursynth → DeCrawl

DeDot controls in Hybrid
DeDot controls in Hybrid

What it does

A pixel is only changed when it stays similar across the neighbor frames, so motion is not touched. Luma and chroma are handled separately, each with its own pair of thresholds: luma has a spatial and a temporal threshold, chroma two temporal ones.

Settings

Control Parameter Range / values Hybrid default Meaning
Luma spatial/temporal (1st) luma_2d 0 – 510 20 Spatial luma threshold; lower values process more pixels, 510 leaves luma untouched.
Luma spatial/temporal (2nd) luma_t 0 – 255 20 Temporal luma threshold; higher values process more pixels. 0 does not switch luma filtering off.
Chroma temporal (1st) chroma_t1 0 – 255 15 Temporal chroma threshold; higher values process more pixels.
Chroma temporal (2nd) chroma_t2 0 – 255 5 Second temporal chroma threshold; lower values process more pixels, 255 leaves chroma untouched.

With the spatial luma threshold at 510 and the second chroma threshold at 255 nothing would be processed at all; Hybrid then skips the filter and writes a comment into the script instead.

Example

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

clip = core.dedot.Dedot(clip)

How Hybrid calls it

  • DeDot works on 8–16-bit integer YUV and gray clips; other formats are converted first.
  • Thresholds are entered on the 8-bit scale at every bit depth; the plugin scales them.
  • Values are only written when they differ from the defaults, which equal the plugin's own defaults.
  • DeDot also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

The plugin

The VapourSynth plugin by dubhater is a port of the AviSynth DeDot plugin by Fredrik Mellbin, released under GPL v2. It is a CPU filter for clips with constant format and size.

Sources