mirror of
https://github.com/Tonejs/Tone.js
synced 2024-12-28 20:43:08 +00:00
112 lines
2.6 KiB
TypeScript
112 lines
2.6 KiB
TypeScript
import { Gain } from "../../core/context/Gain";
|
|
import { Param } from "../../core/context/Param";
|
|
import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
|
|
import { Decibels } from "../../core/type/Units";
|
|
import { optionsFromArguments } from "../../core/util/Defaults";
|
|
import { readOnly } from "../../core/util/Interface";
|
|
|
|
interface VolumeOptions extends ToneAudioNodeOptions {
|
|
volume: Decibels;
|
|
mute: boolean;
|
|
}
|
|
|
|
/**
|
|
* Volume is a simple volume node, useful for creating a volume fader.
|
|
*
|
|
* @example
|
|
* import { Oscillator, Volume } from "tone";
|
|
* const vol = new Volume(-12).toDestination();
|
|
* const osc = new Oscillator().connect(vol).start();
|
|
* @category Component
|
|
*/
|
|
export class Volume extends ToneAudioNode<VolumeOptions> {
|
|
|
|
readonly name: string = "Volume";
|
|
|
|
/**
|
|
* the output node
|
|
*/
|
|
output: Gain<"decibels">;
|
|
|
|
/**
|
|
* Input and output are the same
|
|
*/
|
|
input: Gain<"decibels">;
|
|
|
|
/**
|
|
* The unmuted volume
|
|
*/
|
|
private _unmutedVolume: Decibels;
|
|
|
|
/**
|
|
* The volume control in decibels.
|
|
* @example
|
|
* import { Oscillator, Volume } from "tone";
|
|
* const vol = new Volume().toDestination();
|
|
* const osc = new Oscillator().connect(vol).start();
|
|
* vol.volume.value = -20;
|
|
*/
|
|
volume: Param<"decibels">;
|
|
|
|
/**
|
|
* @param volume the initial volume in decibels
|
|
*/
|
|
constructor(volume?: Decibels);
|
|
constructor(options?: Partial<VolumeOptions>);
|
|
constructor() {
|
|
|
|
super(optionsFromArguments(Volume.getDefaults(), arguments, ["volume"]));
|
|
const options = optionsFromArguments(Volume.getDefaults(), arguments, ["volume"]);
|
|
|
|
this.input = this.output = new Gain({
|
|
context: this.context,
|
|
gain: options.volume,
|
|
units: "decibels",
|
|
});
|
|
this.volume = this.output.gain;
|
|
readOnly(this, "volume");
|
|
this._unmutedVolume = options.volume;
|
|
|
|
// set the mute initially
|
|
this.mute = options.mute;
|
|
}
|
|
|
|
static getDefaults(): VolumeOptions {
|
|
return Object.assign(ToneAudioNode.getDefaults(), {
|
|
mute: false,
|
|
volume: 0,
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Mute the output.
|
|
* @example
|
|
* import { Oscillator, Volume } from "tone";
|
|
* const vol = new Volume(-12).toDestination();
|
|
* const osc = new Oscillator().connect(vol).start();
|
|
* // mute the output
|
|
* vol.mute = true;
|
|
*/
|
|
get mute(): boolean {
|
|
return this.volume.value === -Infinity;
|
|
}
|
|
set mute(mute: boolean) {
|
|
if (!this.mute && mute) {
|
|
this._unmutedVolume = this.volume.value;
|
|
// maybe it should ramp here?
|
|
this.volume.value = -Infinity;
|
|
} else if (this.mute && !mute) {
|
|
this.volume.value = this._unmutedVolume;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* clean up
|
|
*/
|
|
dispose(): this {
|
|
super.dispose();
|
|
this.input.dispose();
|
|
this.volume.dispose();
|
|
return this;
|
|
}
|
|
}
|