Vapoursynth Grayworld: Difference between revisions
Remove background without information (via update-page on MediaWiki MCP Server) |
Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server) |
||
| Line 18: | Line 18: | ||
== Example == | == Example == | ||
Default settings on a 10-bit YUV 4:2:0 source: | Default settings on a 10-bit YUV 4:2:0 source: | ||
< | <pre> | ||
# adjusting color space from YUV420P10 to RGBS for vsGrayworld | # adjusting color space from YUV420P10 to RGBS for vsGrayworld | ||
clip = core.resize.Bicubic(clip=clip, format=vs.RGBS, matrix_in_s="470bg", range_in_s="limited", range_s="full") | clip = core.resize.Bicubic(clip=clip, format=vs.RGBS, matrix_in_s="470bg", range_in_s="limited", range_s="full") | ||
| Line 34: | Line 34: | ||
# adjusting output color from RGBS to YUV420P10 for NVEncModel | # adjusting output color from RGBS to YUV420P10 for NVEncModel | ||
clip = core.resize.Bicubic(clip=clip, format=vs.YUV420P10, matrix_s="470bg", range_in_s="full", range_s="limited", dither_type="error_diffusion") | clip = core.resize.Bicubic(clip=clip, format=vs.YUV420P10, matrix_s="470bg", range_in_s="full", range_s="limited", dither_type="error_diffusion") | ||
</ | </pre> | ||
== How Hybrid calls it == | == How Hybrid calls it == | ||
Latest revision as of 09:50, 16 November 2026
Grayworld is an automatic white balance (color constancy) filter. It assumes that the average color of a scene is neutral gray and removes the color cast it measures in each frame.
Filtering → Vapoursynth → Color → Auto

What it does
For each frame the filter measures the average color and shifts the colors so that this average becomes gray. It works on every frame separately and has no strength setting. It suits footage with an overall tint, for example a wrong white balance or a faded color cast; scenes that really are dominated by one color (a blue sky, a green lawn) get neutralized as well.
Settings
| Control | Parameter | Values | Hybrid default | Meaning |
|---|---|---|---|---|
| CC Mode | cc | mean, median | mean | How the average color is measured; median is not affected by extreme luma or chroma values. |
Example
Default settings on a 10-bit YUV 4:2:0 source:
# adjusting color space from YUV420P10 to RGBS for vsGrayworld
clip = core.resize.Bicubic(clip=clip, format=vs.RGBS, matrix_in_s="470bg", range_in_s="limited", range_s="full")
# adjusting color using Grayworld
# convert to linear color space
grayworldTransfer = clip.get_frame(0).props.get('_Transfer', vs.TRANSFER_BT709)
if grayworldTransfer in (vs.TRANSFER_UNSPECIFIED, vs.TRANSFER_LINEAR):
grayworldTransfer = vs.TRANSFER_BT709
clip = core.resize.Bicubic(clip=clip, format=vs.RGBS, transfer_in=grayworldTransfer, transfer_s="linear")
# making sure 0-1 limits are respected
clip = core.vszip.Limiter(clip=clip, min=[0,0,0], max=[1,1,1])
clip = core.grwrld.grayworld(clip)
# undo conversion to linear color space
clip = core.resize.Bicubic(clip=clip, format=vs.RGBS, transfer_in_s="linear", transfer=grayworldTransfer)
# adjusting output color from RGBS to YUV420P10 for NVEncModel
clip = core.resize.Bicubic(clip=clip, format=vs.YUV420P10, matrix_s="470bg", range_in_s="full", range_s="limited", dither_type="error_diffusion")
How Hybrid calls it
- The filter works on 32-bit float RGB: Hybrid converts the clip to RGBS before it and back afterwards.
- The plugin expects linear light. Hybrid reads the clip's transfer characteristic from its
_Transferframe property (BT.709 if unknown), converts to linear light before the filter, clamps the values to 0–1 and converts back afterwards. - CC Mode is only written when it is not mean.
- Grayworld also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).
Background
grayworld (plugin)
The plugin by Asd-g is a port of FFmpeg's grayworld filter for VapourSynth and AviSynth+. It expects planar 32-bit float RGB in linear light. Parameters: cc (0 = mean, 1 = median) and opt (CPU optimization, automatic by default; not exposed in Hybrid).
AviSynth
The same plugin is available for AviSynth+. ColorYUV's autowhite is a simpler per-frame cast removal.
Sources
- grayworld README
- Hybrid's tooltips