Vapoursynth SoftLight

From wiki.selur.net
Revision as of 19:35, 14 November 2026 by Selur (talk | contribs) (Remove background without information (via update-page on MediaWiki MCP Server))
Jump to navigation Jump to search

SoftLight is a color correction filter that runs on NVIDIA GPUs (CUDA). It averages each RGB channel of a frame and blends the frame with the negative of that average in a Photoshop-style soft light mode, which removes color casts. Other modes boost saturation or contrast, convert to grayscale or expand TV range to PC range.

Filtering → Vapoursynth → Color → Levels

SoftLight controls in Hybrid
SoftLight controls in Hybrid

What it does

Soft light blending brightens bright areas, darkens dark areas and leaves mid tones mostly alone. Blending a frame with the inverse of its own average color pulls the average towards neutral gray, so a color cast disappears; depending on the mode the original brightness is restored afterwards.

The plugin author recommends denoising first and cropping black borders, because both skew the average.

Requirements

  • Windows x64 with an NVIDIA GPU (CUDA). Hybrid disables the filter on other systems and without an NVIDIA card.

Settings

Control Parameter Values Hybrid default Meaning
Mode mode 0, 1, 2, 3, 4, 5, 6, 8, 10, 11, 12 0 What the filter does, see below.
Formula formula pegtop, illusions.hu, W3C pegtop Soft light formula used for the blend. Only used with modes below 8.

Modes (as described by the plugin):

  • 0: neutralize hue and saturation, keep the brightness.
  • 1: normalize lightness only, keep the colors.
  • 2: like 0, plus a saturation boost.
  • 3: like 0, but without restoring the brightness, so dark frames get brighter.
  • 4: like 3, plus an RGB contrast boost.
  • 5: soft light each RGB plane with itself (color and contrast boost).
  • 6: saturation boost in HSV.
  • 8: TV range to PC range.
  • 10: grayscale.
  • 11, 12: OETF / EOTF curve (experimental).

The plugin's modes 7 (clamp to 16–235) and 9 (PC to TV range) are not offered.

Example

Default settings on a 10-bit YUV 4:2:0 source with BT.601 matrix:

# color adjustment using SoftLight
clip = core.Argaricolm.Softlight(clip, yuvin=601, yuvout=601)

How Hybrid calls it

  • The filter accepts 8- and 10-bit YUV 4:2:0, YUV 4:4:4 and RGB; Hybrid converts other formats first.
  • yuvin and yuvout are set from the clip's color matrix (601, 709 or 2020).
  • For modes below 8, full-range YUV is converted to limited range and limited-range RGB to full range before the filter. Mode 8 expects limited-range input, so full-range YUV is converted to limited range first; after mode 8 the clip is marked as full range.
  • Mode and Formula are only written when they differ from the default.
  • SoftLight also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

AVS_SoftLight

The plugin works in both AviSynth and VapourSynth: Softlight(mode, formula, skipblack, yuvin, yuvout, rangemin, rangemax, changerange). Besides mode and formula it can skip black samples when averaging (on by default) and has range limits for mode 8; Hybrid leaves these at their defaults. It supports 4:2:0 and 4:4:4 YUV and planar RGB at 8 or 10 bit, is x64 only and built against CUDA.

AviSynth

The plugin can also be loaded in AviSynth. AviSynth's own Overlay filter has a "SoftLight" blend mode, but that blends two clips and does not remove color casts.

Sources