Perlin

Video Single output Source

Generate Perlin noise

FFmpeg filter: perlin — the official reference.

Generate a stream. Perlin is a source — it has no input, so you create a stream from it rather than applying it to one:

$video = \FFmpeg\VideoStream::generate(new Perlin(…));

apply() and addFilter() do not apply to source filters (there is nothing to attach them to).

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	320x240	—	set video size
rate	string	25	—	set video rate
octaves	int	1	≥ 1	set the number of components to use to generate the noise
persistence	float	1	≥ 0	set the octaves persistence
xscale	float	1	≥ 0	set x-scale factor
yscale	float	1	≥ 0	set y-scale factor
tscale	float	1	≥ 0	set t-scale factor
random_mode	PerlinRandomMode	random	random, ken, seed	set random mode used to compute initial pattern
random_seed	string	—	—	set the seed for filling the initial pattern

FFmpeg also names these options (use the parameter shown above): s → size, r → rate, seed → random_seed.

---

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