mirror of
https://github.com/Tonejs/Tone.js
synced 2024-12-28 12:33:12 +00:00
131 lines
3.5 KiB
TypeScript
131 lines
3.5 KiB
TypeScript
import { InputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
|
|
import { Compressor, CompressorOptions } from "./Compressor";
|
|
import { optionsFromArguments } from "../../core/util/Defaults";
|
|
import { readOnly, RecursivePartial } from "../../core/util/Interface";
|
|
import { Frequency } from "../../core/type/Units";
|
|
import { MultibandSplit } from "../channel/MultibandSplit";
|
|
import { Signal } from "../../signal/Signal";
|
|
import { Gain } from "../../core/context/Gain";
|
|
|
|
export interface MultibandCompressorOptions extends ToneAudioNodeOptions {
|
|
mid: Omit<CompressorOptions, keyof ToneAudioNodeOptions>;
|
|
low: Omit<CompressorOptions, keyof ToneAudioNodeOptions>;
|
|
high: Omit<CompressorOptions, keyof ToneAudioNodeOptions>;
|
|
lowFrequency: Frequency;
|
|
highFrequency: Frequency;
|
|
}
|
|
|
|
/**
|
|
* A compressor with separate controls over low/mid/high dynamics.
|
|
* @see {@link Compressor} and {@link MultibandSplit}
|
|
*
|
|
* @example
|
|
* const multiband = new Tone.MultibandCompressor({
|
|
* lowFrequency: 200,
|
|
* highFrequency: 1300,
|
|
* low: {
|
|
* threshold: -12
|
|
* }
|
|
* });
|
|
* @category Component
|
|
*/
|
|
export class MultibandCompressor extends ToneAudioNode<MultibandCompressorOptions> {
|
|
|
|
readonly name: string = "MultibandCompressor";
|
|
|
|
readonly input: InputNode;
|
|
readonly output: ToneAudioNode;
|
|
|
|
/**
|
|
* Split the incoming signal into high/mid/low
|
|
*/
|
|
private _splitter: MultibandSplit;
|
|
|
|
/**
|
|
* low/mid crossover frequency.
|
|
*/
|
|
readonly lowFrequency: Signal<"frequency">;
|
|
|
|
/**
|
|
* mid/high crossover frequency.
|
|
*/
|
|
readonly highFrequency: Signal<"frequency">;
|
|
|
|
/**
|
|
* The compressor applied to the low frequencies
|
|
*/
|
|
readonly low: Compressor;
|
|
|
|
/**
|
|
* The compressor applied to the mid frequencies
|
|
*/
|
|
readonly mid: Compressor;
|
|
|
|
/**
|
|
* The compressor applied to the high frequencies
|
|
*/
|
|
readonly high: Compressor;
|
|
|
|
constructor(options?: RecursivePartial<MultibandCompressorOptions>);
|
|
constructor() {
|
|
super(Object.assign(optionsFromArguments(MultibandCompressor.getDefaults(), arguments)));
|
|
const options = optionsFromArguments(MultibandCompressor.getDefaults(), arguments);
|
|
|
|
this._splitter = this.input = new MultibandSplit({
|
|
context: this.context,
|
|
lowFrequency: options.lowFrequency,
|
|
highFrequency: options.highFrequency
|
|
});
|
|
this.lowFrequency = this._splitter.lowFrequency;
|
|
this.highFrequency = this._splitter.highFrequency;
|
|
this.output = new Gain({ context: this.context });
|
|
this.low = new Compressor(Object.assign(options.low, { context: this.context }));
|
|
this.mid = new Compressor(Object.assign(options.mid, { context: this.context }));
|
|
this.high = new Compressor(Object.assign(options.high, { context: this.context }));
|
|
|
|
// connect the compressor
|
|
this._splitter.low.chain(this.low, this.output);
|
|
this._splitter.mid.chain(this.mid, this.output);
|
|
this._splitter.high.chain(this.high, this.output);
|
|
|
|
readOnly(this, ["high", "mid", "low", "highFrequency", "lowFrequency"]);
|
|
}
|
|
|
|
static getDefaults(): MultibandCompressorOptions {
|
|
return Object.assign(ToneAudioNode.getDefaults(), {
|
|
lowFrequency: 250,
|
|
highFrequency: 2000,
|
|
low: {
|
|
ratio: 6,
|
|
threshold: -30,
|
|
release: 0.25,
|
|
attack: 0.03,
|
|
knee: 10
|
|
},
|
|
mid: {
|
|
ratio: 3,
|
|
threshold: -24,
|
|
release: 0.03,
|
|
attack: 0.02,
|
|
knee: 16
|
|
},
|
|
high: {
|
|
ratio: 3,
|
|
threshold: -24,
|
|
release: 0.03,
|
|
attack: 0.02,
|
|
knee: 16
|
|
},
|
|
});
|
|
}
|
|
|
|
dispose(): this {
|
|
super.dispose();
|
|
this._splitter.dispose();
|
|
this.low.dispose();
|
|
this.mid.dispose();
|
|
this.high.dispose();
|
|
this.output.dispose();
|
|
return this;
|
|
}
|
|
}
|