Paletteuse

Video Single output Transform

Use a palette to downsample an input video stream.

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

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

$result = $video->apply(new Paletteuse(…), $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
dither	PaletteuseDitheringMode	sierra2_4a	bayer, heckbert, floyd_steinberg, sierra2, sierra2_4a, sierra3, burkes, atkinson	select dithering mode
bayer_scale	int	2	0–5	set scale for bayer dithering
diff_mode	PaletteuseDiffMode	0	rectangle	set frame difference mode
new	bool	false	—	take new palette for each output frame
alpha_threshold	int	128	0–255	set the alpha threshold for transparency
debug_kdtree	string	—	—	save Graphviz graph of the kdtree in specified file

---

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