Mergeplanes

Video Single output Transform

Merge planes.

FFmpeg filter: mergeplanes — the official reference.

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

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

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

$result = $video->apply(new Mergeplanes(…), $other);

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
mapping	int	-1	-1–858993459	set input to output plane mapping
format	string	79	—	set output pixel format
map0s	int	0	0–3	set 1st input to output stream mapping
map0p	int	0	0–3	set 1st input to output plane mapping
map1s	int	0	0–3	set 2nd input to output stream mapping
map1p	int	0	0–3	set 2nd input to output plane mapping
map2s	int	0	0–3	set 3rd input to output stream mapping
map2p	int	0	0–3	set 3rd input to output plane mapping
map3s	int	0	0–3	set 4th input to output stream mapping
map3p	int	0	0–3	set 4th input to output plane mapping

---

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