Vectorscope

Video Single output Transform

Video vectorscope.

FFmpeg filter: vectorscope — the official reference.

Add it to a graph. The explicit form works for every filter — bind it to its input and read the result from outputs():

$node   = $video->addFilter(new Vectorscope(…));
$result = $node->outputs()[0];

Shorthand. Single-output filters can skip the node — apply() returns the result stream directly:

$result = $video->apply(new Vectorscope(…));

When to use it

TODO — when this filter shines: what it’s the right tool for, what to reach for instead when it isn’t, and how it composes with neighbouring filters.

How to use it

TODO — prose: how the filter actually works and what its key parameters mean (the explanation FFmpeg’s terse option help omits).

Examples

TODO — runnable PHP, with the equivalent ffmpeg CLI alongside.

Gotchas

TODO

See also

TODO

Parameters

Parameter	Type	Default	Range / values	Description
mode	VectorscopeMode	gray	gray, color, color2, color3, color4, color5	set vectorscope mode
x	int	1	0–2	set color component on X axis
y	int	2	0–2	set color component on Y axis
intensity	float	0.004	0–1	set intensity
envelope	VectorscopeEnvelope	none	none, instant, peak, peak+instant	set envelope
graticule	VectorscopeGraticule	none	none, green, color, invert	set graticule
opacity	float	0.75	0–1	set graticule opacity
flags	int|string	4	—	set graticule flags
bgopacity	float	0.3	0–1	set background opacity
lthreshold	float	0	0–1	set low threshold
hthreshold	float	1	0–1	set high threshold
colorspace	VectorscopeColorspace	auto	auto, 601, 709	set colorspace
tint0	float	0	-1–1	set 1st tint
tint1	float	0	-1–1	set 2nd tint

FFmpeg also names these options (use the parameter shown above): m → mode, i → intensity, e → envelope, g → graticule, o → opacity, f → flags, b → bgopacity, l → lthreshold, h → hthreshold, c → colorspace, t0 → tint0, t1 → tint1.

---

Maps to FFmpeg’s vectorscope filter. Verified against ffmpeg n7.1.1.