Vapoursynth ResampleHQ

From wiki.selur.net
Revision as of 08:59, 15 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

ResampleHQ resizes in linear light: the clip is converted to linear RGB, scaled and converted back. This avoids the darkening of fine bright detail and edges that resizing gamma-encoded video causes, which shows mostly on strong downscales.

Filtering → Vapoursynth → Frame → Resize

ResampleHQ controls in Hybrid
ResampleHQ controls in Hybrid

What it does

The source is converted to 32-bit float RGB with a linear transfer, scaled with the chosen kernel of VapourSynth's core resizer, and converted back to the original format with the gamma curve and matrix of the output.

Settings

Tick Resizer in the Resizer page and pick ResampleHQ as method.

Control Parameter Range / values Hybrid default Meaning
Kernel kernel point, linear, bilinear, cubic, bicubic, lanczos, spline16, spline36 spline36 Kernel used in linear light; linear is the same as bilinear and cubic the same as bicubic.
HDR hdr on/off off Uses the PQ (ST 2084) transfer and BT.2020 instead of the SDR curves; for HDR sources.

Example

Default settings on a 10-bit YUV 4:2:0 source (640x356), resized to 1280x712:

clip = resamplehq.resample_hq(clip, width=1280, height=712, matrix="470bg", matrix_dst="470bg", range_in="limited") # 640x356

How Hybrid calls it

  • The target size comes from the Crop/Resize tab; separately filtered fields get half the target height.
  • Hybrid passes the source matrix (BT.601 as 470bg, BT.2020 as 2020ncl) and the source range, and passes the same matrix for the output, so the output keeps the source matrix and color tags stay consistent.
  • Kernel is written when it is not spline36, HDR only when ticked. The output keeps the input format.
  • With an odd target height, limited-range YUV is converted to full range first.

Background

The script

resamplehq is a VapourSynth module for gamma-correct resizing in linear light, modeled on Cory Nelson's AviSynth ResampleHQ, which uses a high-precision linear pipeline. Without an explicit output matrix the script would choose BT.601 for outputs up to 576 lines and BT.709 above; Hybrid avoids this by passing the matrix.

Sources