Vapoursynth Bore

From wiki.selur.net
Revision as of 09:47, 16 November 2026 by Selur (talk | contribs) (New filter page (via create-page on MediaWiki MCP Server))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Bore fixes dirty borders – lines near the frame edge that are brighter or darker than they should be – by scaling each line to match its inner neighbor.

Filtering → Vapoursynth → Frame → Edge

Bore controls in Hybrid
Bore controls in Hybrid

What it does

For each border line a correction factor is found by linear least squares against the neighboring line further inside. The lines are processed from the innermost to the outermost, so each one is compared with a line that has already been fixed. The modes differ in what the factor is computed from: one factor per line, one per line using all three planes, or one per pixel from a limited window around it.

Settings

Control Parameter Range / values Hybrid default Meaning
Mode – SinglePlane, MultiPlane, SinglePlaneLimited, SinglePlaneWeighted SinglePlane SinglePlane: one factor per line; MultiPlane: the regression uses all three planes; SinglePlaneLimited: a factor per pixel from the 2×Ref. line size+1 nearest pixels; SinglePlaneWeighted: like Limited, with bilateral-style weights.
Adjust (l/t/r/b) left / top / right / bottom 0 – 32768 each 0 Lines to fix on each edge (at most half the plane size).
Plane plane first, second, third first Plane that is fixed.
Ref. line size ref_line_size 1 – 4096 100 Half the window size; only for SinglePlaneLimited and SinglePlaneWeighted.
Sigma (S/R/D) sigmaS / sigmaR / sigmaD 0 – 255 / 0 – 10 / 0 – 10 50 / 0.5 / 1.5 Weights of SinglePlaneWeighted: S = spatial sigma (distance along the line), R = range sigma (pixel difference along the line), D = sigma for differences between neighboring adjustments.

Example

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

# adjusting color space from YUV420P10 to YUV444PS for vsBore
clip = core.resize.Bicubic(clip=clip, format=vs.YUV444PS)
# Fix borders of an image using Bore
clip = core.bore.SinglePlane(clip)

How Hybrid calls it

  • Bore works on 32-bit float YUV or float RGB; Hybrid converts to float. MultiPlane needs float YUV 4:4:4 or RGB, so for that mode subsampled input is converted to 4:4:4.
  • Options are only written when they differ from the defaults (Hybrid's defaults are the plugin's); Ref. line size and the sigmas only for the modes that use them.
  • Frame count and frame rate do not change.

Background

Modes

The plugin marks the Limited and Weighted modes as experimental. It also has a debug mode that writes the computed adjustments to the frame properties, and an optional weight mask; Hybrid does not offer them. For other ways to fix border lines see EdgeFixer and Balance Borders.

Sources

  • bore
  • Hybrid's tooltips