Vapoursynth Composite

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

Composite removes cross-color (rainbows on fine detail) and cross-luma (dot crawl along sharp edges) from PAL and NTSC footage that went through a poor composite decoder.

Filtering → Vapoursynth → DeRainbow

Composite controls in Hybrid
Composite controls in Hybrid

What it does

The picture is encoded back into the composite signal the poor decoder saw and then decoded again with a good comb/transform separator, so the artifacts are not created a second time. Optional refine passes recover some luma detail the original decoder softened.

Requirements

  • The height must be 576 for PAL or 480/486 for NTSC. Otherwise Hybrid skips the filter and writes a note into the script instead.

Settings

Control Parameter Range / values Hybrid default Meaning
Standard standard ntsc, pal ntsc TV standard of the source; it is never guessed.
Refine refine 0 – 4 1 Number of luma detail recovery passes; 0 = off.
Dimensions dimensions notch, current, neighboring neighboring Separator: neighboring uses the neighbor frames (best, slowest); current is spatial only (several times faster; stills, short clips, previews); notch is a crude reference notch filter (worst, not a fast mode).

Example

Default settings on a 720x480 NTSC source (on other heights Hybrid skips the filter and writes a comment instead):

# restoration using Composite
clip = core.composite.Restore(clip, standard="ntsc")

How Hybrid calls it

  • Composite accepts any YUV input and always returns YUV 4:4:4 16 bit; later steps convert as needed. The width is kept.
  • Standard is always written; Refine and Dimensions only when they differ from the defaults.
  • The height check also takes a resize from the Gimmick step into account.
  • Composite also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

Signal processing

The plugin follows ld-decode's chroma encoder and decoder, which build on BBC research by Clarke, with separation ideas from patents by Easterbrook and Weston and Faroudja-style adaptivity. It writes diagnostic frame properties such as separation confidence, motion fraction and refine residual. According to the author, the defaults remove about three quarters of the rainbows and dot crawl on real NTSC footage; on PAL the gain is smaller.

Refine

The plugin itself accepts up to 16 passes. The author suggests 2–4 for clean, detailed sources and 0 for grainy tape that is denoised afterwards, and for graphics, titles and test patterns.

Interlaced sources

Interlaced and telecined sources should be fed interlaced, with IVTC after Composite; field matching before it only when the fields are shifted by one. For 480-line NTSC the field order of the clip decides where it sits on the 486-line raster, so a wrong field order costs accuracy. A motion-compensated chroma degrain after Composite is a suggested follow-up.

Sources