Datascope

Video Single output Transform

Video data analysis.

FFmpeg filter: datascope — 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 Datascope(…));
$result = $node->outputs()[0];

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

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

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
size	string	hd720	—	set output size
x	int	0	≥ 0	set x offset
y	int	0	≥ 0	set y offset
mode	DatascopeMode	mono	mono, color, color2	set scope mode
axis	bool	false	—	draw column/row numbers
opacity	float	0.75	0–1	set background opacity
format	DatascopeFormat	hex	hex, dec	set display number format
components	int	15	1–15	set components to display

FFmpeg also names these options (use the parameter shown above): s → size.

---

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