Vapoursynth SoftLight
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

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
- AVS_SoftLight README
- AviSynth+ documentation: Overlay (SoftLight blend mode)
- Hybrid's tooltips