Vapoursynth Composite: Difference between revisions
New filter page (via create-page on MediaWiki MCP Server) |
Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server) |
||
| Line 25: | Line 25: | ||
== Example == | == Example == | ||
Default settings on a 720x480 NTSC source (on other heights Hybrid skips the filter and writes a comment instead): | Default settings on a 720x480 NTSC source (on other heights Hybrid skips the filter and writes a comment instead): | ||
< | <pre> | ||
# restoration using Composite | # restoration using Composite | ||
clip = core.composite.Restore(clip, standard="ntsc") | clip = core.composite.Restore(clip, standard="ntsc") | ||
</ | </pre> | ||
== How Hybrid calls it == | == How Hybrid calls it == | ||
Latest revision as of 09:48, 16 November 2026
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

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
- vapoursynth-composite README
- Hybrid's tooltips