Vapoursynth DeblockPP7

From wiki.selur.net
Revision as of 09:48, 16 November 2026 by Selur (talk | contribs) (Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

DeblockPP7 is a fast deblocking and deringing filter, a port of the pp7 postprocessing filter of MPlayer/FFmpeg.

Filtering → Vapoursynth → DeBlock

DeblockPP7 controls in Hybrid
DeblockPP7 controls in Hybrid

What it does

pp7 works like a simplified spp (simple postprocessing): each 7×7 neighborhood is transformed with a DCT, small coefficients are removed by thresholding, and only the center sample of the inverse transform is kept. The thresholds come from a constant quantizer (CQ); higher values remove more blocking and ringing, but also more detail.

Settings

Control Parameter Range / values Hybrid default Meaning
CQ qp 1.0 – 63.0 2.00 Constant quantizer; higher means stronger filtering.
Mode mode hard thresholding, soft thresholding, medium hard thresholding Hard keeps more detail; soft removes ringing better but is blurrier; medium is in between.
Planes planes all, luma only, chroma only all Planes that are processed (for RGB: all, R, or G+B).

Example

Default settings on a 10-bit YUV 4:2:0 source:

# applying deblocking using DeblockPP7
clip = core.pp7.DeblockPP7(clip)

How Hybrid calls it

  • DeblockPP7 works on YUV and RGB with 8–16-bit integer samples and on 32-bit float YUV 4:4:4 and RGB; other formats are converted first.
  • CQ and Mode are only written when they differ from the defaults; the plugin scales its thresholds to the bit depth itself.
  • DeblockPP7 also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

VapourSynth-DeblockPP7

Selur's fork of the plugin uses the VapourSynth API 4 (R55+): pp7.DeblockPP7(clip, qp=2.0, mode=0, opt=0, planes=[0, 1, 2]). It accepts every constant format with 8–16-bit integer or 32-bit float samples and has C, SSE2, SSE4.1 and (on arm64) NEON code paths.

FFmpeg

FFmpeg's pp7 filter has the same three modes (default medium) and can take the quantizers stored in the stream (qp=0); the VapourSynth port has no per-frame quantizers and uses a constant one.

Sources