Shufflepixels

Video Single output Transform

Shuffle video pixels.

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

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

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

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
direction	ShufflepixelsDir	forward	forward, inverse	set shuffle direction
mode	ShufflepixelsMode	horizontal	horizontal, vertical, block	set shuffle mode
width	int	10	1–8000	set block width
height	int	10	1–8000	set block height
seed	int	-1	≥ -1	set random seed

FFmpeg also names these options (use the parameter shown above): d → direction, m → mode, w → width, h → height, s → seed.

---

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