Setparams

Video Single output Transform

Force field, or color property for the output video frame.

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

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

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

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
field_mode	SetparamsMode	auto	auto, bff, tff, prog	select interlace mode
range	SetparamsRange	auto	auto, unspecified, limited, full	select color range
color_primaries	SetparamsColorPrimaries	auto	auto, bt709, unknown, bt470m, bt470bg, smpte170m, smpte240m, film, …	select color primaries
color_trc	SetparamsColorTrc	auto	auto, bt709, unknown, bt470m, bt470bg, smpte170m, smpte240m, linear, …	select color transfer
colorspace	SetparamsColorspace	auto	auto, gbr, bt709, unknown, fcc, bt470bg, smpte170m, smpte240m, …	select colorspace
chroma_location	SetparamsChromaLocation	auto	auto, unspecified, left, center, topleft, top, bottomleft, bottom	select chroma sample location

---

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