Skip to main content

Interface: LimiterOptions

Defined in: packages/player/src/filters.ts:586

AudioFilters.limiter options (ffmpeg alimiter).

af_alimiter.c:81-92. latency (delay compensation, default off) is not exposed.

Properties​

attack?​

readonly optional attack?: number;

Defined in: packages/player/src/filters.ts:594

Attack in ms, 0.1–80 (attack).

autoLevel?​

readonly optional autoLevel?: boolean;

Defined in: packages/player/src/filters.ts:615

Make-up gain back to full scale (level). ffmpeg default true.

This is what makes limit a ceiling you cannot hear. The name suggests automatic levelling of the programme; it is not. It is one constant: level = 1 / limit, applied to every output sample (af_alimiter.c:140,289). So at the default limit of 1 it multiplies by exactly 1 and does nothing at all — it can neither raise quiet material nor touch loud material. It only bites when you lower the ceiling: with { limit: 0.891 } (−1 dBFS) the limiter holds peaks at −1 dBFS and then scales the whole signal back up by 1.122, so the output peaks at 0 dBFS again. Pass autoLevel: false alongside any limit below 1 if you wanted the headroom you asked for.

autoRelease?​

readonly optional autoRelease?: boolean;

Defined in: packages/player/src/filters.ts:598

Auto-release (asc).

autoReleaseLevel?​

readonly optional autoReleaseLevel?: number;

Defined in: packages/player/src/filters.ts:600

Auto-release strength, 0–1 (asc_level).

levelIn?​

readonly optional levelIn?: number;

Defined in: packages/player/src/filters.ts:588

Input level, 0.015625–64 (level_in).

levelOut?​

readonly optional levelOut?: number;

Defined in: packages/player/src/filters.ts:590

Output level, 0.015625–64 (level_out).

limit?​

readonly optional limit?: number;

Defined in: packages/player/src/filters.ts:592

Ceiling as a linear amplitude, 0.0625–1 (limit).

release?​

readonly optional release?: number;

Defined in: packages/player/src/filters.ts:596

Release in ms, 1–8000 (release).