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 { 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); 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; } }