Vapoursynth DeJitter: Difference between revisions

From wiki.selur.net
Jump to navigation Jump to search
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 15: Line 15:
| Max jitter || jmax || 1 – 60 || 40 || Largest jitter expected; the search is limited to this width.
| Max jitter || jmax || 1 – 60 || 40 || Largest jitter expected; the search is limited to this width.
|-
|-
| Sync width || wsyn || 1 – 40 || 20 || Width of the row sync signal that is skipped after a detected start.
| Sync width || wsyn || 0 – 40 || 20 || Width of the row sync signal that is skipped after a detected start.
|-
|-
| Threshold || thresh || 0.01 – 0.5 (step 0.01) || 0.08 || Level, as a fraction of the full range, above which a pixel counts as picture rather than noise.
| Threshold || thresh || 0.01 – 0.5 (step 0.01) || 0.08 || Level, as a fraction of the full range, above which a pixel counts as picture rather than noise.
Line 22: Line 22:
== Example ==
== Example ==
Default settings on a 10-bit YUV 4:2:0 source (640x356):
Default settings on a 10-bit YUV 4:2:0 source (640x356):
<syntaxhighlight lang="python">
<pre>
# adjusting color space from YUV420P10 to YUV444P10 for vsDeJitter
# adjusting color space from YUV420P10 to YUV444P10 for vsDeJitter
clip = core.resize.Bicubic(clip=clip, format=vs.YUV444P10)
clip = core.resize.Bicubic(clip=clip, format=vs.YUV444P10)
# remove jitter using DeJitter
# remove jitter using DeJitter
clip = core.vcm.DeJitter(clip, jmax=min(40, clip.width // 4))
clip = core.vcm.DeJitter(clip, jmax=min(40, clip.width // 4))
</syntaxhighlight>
</pre>


== How Hybrid calls it ==
== How Hybrid calls it ==

Latest revision as of 09:48, 16 November 2026

DeJitter repairs the horizontal line jitter of faulty VHS captures: it finds where each row really starts and shifts it back into place.

Filtering → Vapoursynth → Frame → Stabilize

DeJitter controls in Hybrid
DeJitter controls in Hybrid

What it does

When noise before the sync pulse is taken as the start of a new line, the line is shifted sideways. DeJitter searches each row for the first pixel that is clearly picture rather than noise, skips the sync signal and shifts the row back. The part missing at the end of a corrected row is filled with black. A dark left edge can hide the row start, so crop the left side as far as possible (without losing picture) before using DeJitter.

Settings

Control Parameter Range / values Hybrid default Meaning
Max jitter jmax 1 – 60 40 Largest jitter expected; the search is limited to this width.
Sync width wsyn 0 – 40 20 Width of the row sync signal that is skipped after a detected start.
Threshold thresh 0.01 – 0.5 (step 0.01) 0.08 Level, as a fraction of the full range, above which a pixel counts as picture rather than noise.

Example

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

# adjusting color space from YUV420P10 to YUV444P10 for vsDeJitter
clip = core.resize.Bicubic(clip=clip, format=vs.YUV444P10)
# remove jitter using DeJitter
clip = core.vcm.DeJitter(clip, jmax=min(40, clip.width // 4))

How Hybrid calls it

  • The plugin rejects chroma subsampling, so Hybrid converts the clip to YUV 4:4:4 with the same bit depth first. Interlaced material is filtered as separated fields.
  • Threshold is a fraction of the range and does not depend on the bit depth.
  • Max jitter is always written and limited to a quarter of the frame width, which the plugin requires; Sync width and Threshold are only written when they differ from the defaults (Hybrid's defaults are the plugin's).
  • Frame count and frame rate do not change.
  • DeJitter also offers the common options (ApplyOnlyTo and Gimmick only).

Background

Plugin

DeJitter is part of V.C. Mohan's vcm plugin collection, first written for AviSynth. It accepts 8–16-bit integer and float clips in gray or non-subsampled YUV/RGB and runs on the CPU.

Sources