Vapoursynth FixChromaBleeding
Jump to navigation
Jump to search
FixChromaBleeding reduces color bleeding, oversaturation and color shifts, mainly in strongly red and blue areas, as they often appear on analog sources such as VHS.
Filtering → Vapoursynth → Color → Chroma

What it does
- A mask of the affected areas is built from the V (red-difference) plane after boosting the saturation by Threshold; optionally the mask source is blurred first.
- A copy of the clip is shifted by Shift (h/v) and its saturation is changed by Strength.
- Inside the mask, the U and V planes of the original are replaced by those of the shifted copy. Luma stays unchanged.
Settings
| Control | Parameter | Range | Hybrid default | Meaning |
|---|---|---|---|---|
| Shift (h) | cx | -16 – 16 | 4 | Horizontal shift of the chroma copy in luma pixels; positive moves the chroma to the left. |
| Shift (v) | cy | -16 – 16 | 4 | Vertical shift of the chroma copy in luma pixels; positive moves the chroma up. |
| Threshold | thr | 0 – 255 | 4.00 | Saturation boost before the mask is taken; higher values mark more of the picture as bleeding. |
| Strength | strength | 0 – 10 | 0.80 | Saturation of the shifted chroma copy: below 1 desaturates, 1 keeps, above 1 boosts the color. |
| Blur | blur | on/off | off | Blurs the mask source with a 3×3 kernel. |
| Tools: Expr | tools | akarin, cranexpr, std | akarin (std without AVX2) | Expression evaluator used inside the script. |
Example
Default settings on a 10-bit YUV 4:2:0 source:
# Fixing chroma bleeding using FixChromaBleedingMod
clip = chromaBleeding.FixChromaBleedingMod(clip, tools={'expr': 'akarin'})
How Hybrid calls it
- FixChromaBleeding works on 8–16-bit integer YUV; the mask is computed at the clip's bit depth.
- Interlaced sources are deinterlaced or split into fields before the filter.
- Shifts, Threshold, Strength and Blur are only written when they differ from the defaults; the Tools choice is always written.
- FixChromaBleeding also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).
Background
The script
The function is a port of FixChromaBleedingMod from havsfunc, simplified: the mask is the distance of the boosted V plane from neutral gray, inflated once; the shifted copy is made with resize.Spline16 and the saturation changes with the Tweak function of the same script collection. The planes are combined with std.MaskedMerge.
AviSynth
FixChromaBleeding exists as a user script for AviSynth.
Sources
- VapoursynthScriptsInHybrid (the script collection Hybrid uses)
- havsfunc (origin of FixChromaBleedingMod)
- Hybrid's tooltips