Vapoursynth SoftLight: Difference between revisions
Vapoursynth SoftLight in Hybrid (via create-page on MediaWiki MCP Server) |
Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server) |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 39: | Line 39: | ||
== Example == | == Example == | ||
Default settings on a 10-bit YUV 4:2:0 source with BT.601 matrix: | Default settings on a 10-bit YUV 4:2:0 source with BT.601 matrix: | ||
< | <pre> | ||
# color adjustment using SoftLight | # color adjustment using SoftLight | ||
clip = core.Argaricolm.Softlight(clip, yuvin=601, yuvout=601) | clip = core.Argaricolm.Softlight(clip, yuvin=601, yuvout=601) | ||
</ | </pre> | ||
== How Hybrid calls it == | == 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. | * 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). | * ''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. | * 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. | * ''Mode'' and ''Formula'' are only written when they differ from the default. | ||
* SoftLight also offers the [[Vapoursynth common filter options|common options]] (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick). | * SoftLight also offers the [[Vapoursynth common filter options|common options]] (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick). | ||
| Line 54: | Line 54: | ||
=== AVS_SoftLight === | === AVS_SoftLight === | ||
The plugin works in both AviSynth and VapourSynth: <code>Softlight(mode, formula, skipblack, yuvin, yuvout, rangemin, rangemax, changerange)</code>. 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. | The plugin works in both AviSynth and VapourSynth: <code>Softlight(mode, formula, skipblack, yuvin, yuvout, rangemin, rangemax, changerange)</code>. 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 === | === AviSynth === | ||
Latest revision as of 09:53, 16 November 2026
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