Vapoursynth YAHR: 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 28: | Line 28: | ||
== Example == | == Example == | ||
Default settings on a 10-bit YUV 4:2:0 source: | Default settings on a 10-bit YUV 4:2:0 source: | ||
< | <pre> | ||
# applying dehalo using YAHR | # applying dehalo using YAHR | ||
clip = dehalo.YAHR(clip, tools={'warp': 'warp', 'rg': 'zsmooth', 'median': 'zsmooth'}) | clip = dehalo.YAHR(clip, tools={'warp': 'warp', 'rg': 'zsmooth', 'median': 'zsmooth'}) | ||
</ | </pre> | ||
== How Hybrid calls it == | == How Hybrid calls it == | ||
Latest revision as of 09:53, 16 November 2026
YAHR ("Yet Another Halo Reducing") removes bright halos next to oversharpened edges by warping a copy of the luma towards the edges. It suits mild to moderate edge-enhancement halos; the effect is subtle.
Filtering → Vapoursynth → DeHalo

What it does
The luma is blurred (MinBlur plus a 3×3 Gaussian) to get its fine detail. A warp-sharpened copy gets the same treatment, and Repair (mode 13) limits the source detail by the detail of the warped copy. The part of the detail that exceeds it – the halo – is subtracted from the source. Only luma is processed; chroma passes through unchanged.
Settings
| Control | Parameter | Range / values | Hybrid default | Meaning |
|---|---|---|---|---|
| Blur | blur | 0 – 100 | 2 | Blur passes over the AWarpSharp2 edge mask; more passes give a smoother mask and weaker, more even warping. |
| Depth | depth | −128 – 127 | 32 | AWarpSharp2 warp strength; higher pushes the halo back into the line, too high visibly bends lines. Negative values warp the other way. |
| Count | – | 1 – 10 | 1 | How many times YAHR is applied in a row. |
| Tools: Warp | tools | warp, awarp | warp | AWarpSharp2 plugin, or AWarp with an emulated edge mask (not bit-identical). |
| Tools: RG | tools | zsmooth, neo_smo | zsmooth | Repair implementation. |
| Tools: Median | tools | zsmooth | zsmooth | Median implementation for MinBlur. |
Example
Default settings on a 10-bit YUV 4:2:0 source:
# applying dehalo using YAHR
clip = dehalo.YAHR(clip, tools={'warp': 'warp', 'rg': 'zsmooth', 'median': 'zsmooth'})
How Hybrid calls it
- YAHR works on 8–16-bit integer YUV clips; other formats are converted first.
- Blur and depth are only written when they differ from the defaults; they are not pixel values and need no bit-depth scaling.
- With a Count above 1 the call is repeated that many times.
- The luma is padded by 6 pixels before warping and cropped afterwards.
- YAHR also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).
Background
The script
YAHR is a port of Didée's AviSynth script; havsfunc carried the classic VapourSynth port.
AWarpSharp2
In AWarpSharp2, blur sets how often the edge mask is blurred (higher values weaken the effect) and depth the warp strength from −128 to 127, where negative values blur instead of sharpen. The plugin's own luma depth default is 16; YAHR uses twice that.
Sources
- VapoursynthScriptsInHybrid (the script collection Hybrid uses)
- AWarpSharp2 README
- havsfunc
- Hybrid's tooltips