FirequalizerEffect class final
Configuration for the firequalizer audio effect.
Apply FIR Equalization using arbitrary frequency response.
The filter accepts the following option:
Parameters:
- accuracy: Set filter accuracy in Hz. Lower value means more accurate. Default is
5. (range 3..1e10, default 5.0) - delay: Set filter delay in seconds. Higher value means more accurate. Default is
0.01. (range 0.0..1e10, default 0.01) - dumpfile: Set file for dumping, suitable for gnuplot. (range 0..0, default "")
- dumpscale: Set scale for dumpfile. Acceptable values are same with scale option. Default is linlog. (range 0..3, default SCALE_LINLOG)
- fft2: Enable 2-channel convolution using complex FFT. This improves speed significantly. Default is disabled. (range 0..1, default 0)
- fixed: If enabled, use fixed number of audio samples. This improves speed when filtering with large delay. Default is disabled. (range 0..1, default 0)
- gain: Set gain curve equation (in dB). The expression can contain variables: (range 0..0, default "gain_interpolate(f)", runtime-tunable)
- gainEntry: Set gain entry for gain_interpolate function. The expression can contain functions: (range 0..0, default "", runtime-tunable)
- minPhase: Enable minimum phase impulse response. Default is disabled. (range 0..1, default 0)
- multi: Enable multichannels evaluation on gain. Default is disabled. (range 0..1, default 0)
- scale: Set scale used by gain. Acceptable values are: (range 0..3, default SCALE_LINLOG)
- wfunc: Set window function. Acceptable values are: (range 0..9, default WFUNC_HANN)
- zeroPhase: Enable zero phase mode by subtracting timestamp to compensate delay. Default is disabled. (range 0..1, default 0)
- Inheritance
-
- Object
- AudioEffect
- FirequalizerEffect
- Available extensions
Constructors
- FirequalizerEffect({bool enabled = true, double accuracy = 5.0, double delay = 0.01, String dumpfile = '', FirequalizerScale dumpscale = FirequalizerScale.linlog, bool fft2 = false, bool fixed = false, String gain = 'gain_interpolate(f)', String gainEntry = '', bool minPhase = false, bool multi = false, FirequalizerScale scale = FirequalizerScale.linlog, FirequalizerWfunc wfunc = FirequalizerWfunc.hann, bool zeroPhase = false})
-
Creates an FirequalizerEffect with the given parameter values.
const
Properties
- accuracy → double
-
set accuracy
final
- delay → double
-
set delay
final
- dumpfile → String
-
set dump file
final
- dumpscale → FirequalizerScale
-
set dump scale
final
- enabled → bool
-
Whether this effect is applied.
falsekeeps it in the list, with its settings, without inserting it in the chain.final - fft2 → bool
-
set 2-channels fft
final
- filter → AudioFilter
-
The filter this stage runs, as a typed identifier (
nullfor a RawAudioEffect).no setteroverride - filterName → String
-
The lavfi filter this stage runs, e.g.
equalizer.no setteroverride - fixed → bool
-
set fixed frame samples
final
- gain → String
-
set gain curve
final
-
gainEntries
→ List<
FirequalizerEntry> -
Available on FirequalizerEffect, provided by the FirequalizerEntriesX extension
Decoded gain entries, sorted by ascending frequency.no setter - gainEntry → String
-
set gain entry
final
- hashCode → int
-
The hash code for this object.
no setteroverride
- minPhase → bool
-
set minimum phase mode
final
- multi → bool
-
set multi channels mode
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- scale → FirequalizerScale
-
set gain scale
final
- wfunc → FirequalizerWfunc
-
set window function
final
- zeroPhase → bool
-
set zero phase mode
final
Methods
-
copyWith(
{bool? enabled, double? accuracy, double? delay, String? dumpfile, FirequalizerScale? dumpscale, bool? fft2, bool? fixed, String? gain, String? gainEntry, bool? minPhase, bool? multi, FirequalizerScale? scale, FirequalizerWfunc? wfunc, bool? zeroPhase}) → FirequalizerEffect - Returns a copy of this FirequalizerEffect with the given fields replaced.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toFilterString(
) → String -
Returns the audio chain entry for this effect.
Only non-default parameters are emitted.
override
-
toString(
) → String -
A string representation of this object.
override
-
withGainEntries(
List< FirequalizerEntry> entries) → FirequalizerEffect -
Available on FirequalizerEffect, provided by the FirequalizerEntriesX extension
Returns a copy whose gainEntry reflectsentries(ascending frequency order). Empty input clears the filter's response.
Operators
-
operator ==(
Object other) → bool -
The equality operator.
override
Constants
- accuracyDefault → const double
- Default value for accuracy.
- accuracyMax → const double
- Maximum value for accuracy.
- accuracyMin → const double
- Minimum value for accuracy.
- delayDefault → const double
- Default value for delay.
- delayMax → const double
- Maximum value for delay.
- delayMin → const double
- Minimum value for delay.