tone 14.8.27

package/build/esm/instrument/PluckSynth.d.ts

@@ -0,0 +1,57 @@
+import { Frequency, NormalRange, Time } from "../core/type/Units";
+import { RecursivePartial } from "../core/util/Interface";
+import { Instrument, InstrumentOptions } from "./Instrument";
+export interface PluckSynthOptions extends InstrumentOptions {
+    attackNoise: number;
+    dampening: Frequency;
+    resonance: NormalRange;
+    release: Time;
+}
+/**
+ * Karplus-Strong string synthesis.
+ * @example
+ * const plucky = new Tone.PluckSynth().toDestination();
+ * plucky.triggerAttack("C4", "+0.5");
+ * plucky.triggerAttack("C3", "+1");
+ * plucky.triggerAttack("C2", "+1.5");
+ * plucky.triggerAttack("C1", "+2");
+ * @category Instrument
+ */
+export declare class PluckSynth extends Instrument<PluckSynthOptions> {
+    readonly name = "PluckSynth";
+    /**
+     * Noise burst at the beginning
+     */
+    private _noise;
+    private _lfcf;
+    /**
+     * The amount of noise at the attack.
+     * Nominal range of [0.1, 20]
+     * @min 0.1
+     * @max 20
+     */
+    attackNoise: number;
+    /**
+     * The amount of resonance of the pluck. Also correlates to the sustain duration.
+     */
+    resonance: NormalRange;
+    /**
+     * The release time which corresponds to a resonance ramp down to 0
+     */
+    release: Time;
+    constructor(options?: RecursivePartial<PluckSynthOptions>);
+    static getDefaults(): PluckSynthOptions;
+    /**
+     * The dampening control. i.e. the lowpass filter frequency of the comb filter
+     * @min 0
+     * @max 7000
+     */
+    get dampening(): Frequency;
+    set dampening(fq: Frequency);
+    triggerAttack(note: Frequency, time?: Time): this;
+    /**
+     * Ramp down the [[resonance]] to 0 over the duration of the release time.
+     */
+    triggerRelease(time?: Time): this;
+    dispose(): this;
+}

package/build/esm/instrument/PluckSynth.js

@@ -0,0 +1,80 @@
+import { LowpassCombFilter } from "../component/filter/LowpassCombFilter";
+import { deepMerge } from "../core/util/Defaults";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { Noise } from "../source/Noise";
+import { Instrument } from "./Instrument";
+/**
+ * Karplus-Strong string synthesis.
+ * @example
+ * const plucky = new Tone.PluckSynth().toDestination();
+ * plucky.triggerAttack("C4", "+0.5");
+ * plucky.triggerAttack("C3", "+1");
+ * plucky.triggerAttack("C2", "+1.5");
+ * plucky.triggerAttack("C1", "+2");
+ * @category Instrument
+ */
+export class PluckSynth extends Instrument {
+    constructor() {
+        super(optionsFromArguments(PluckSynth.getDefaults(), arguments));
+        this.name = "PluckSynth";
+        const options = optionsFromArguments(PluckSynth.getDefaults(), arguments);
+        this._noise = new Noise({
+            context: this.context,
+            type: "pink"
+        });
+        this.attackNoise = options.attackNoise;
+        this._lfcf = new LowpassCombFilter({
+            context: this.context,
+            dampening: options.dampening,
+            resonance: options.resonance,
+        });
+        this.resonance = options.resonance;
+        this.release = options.release;
+        this._noise.connect(this._lfcf);
+        this._lfcf.connect(this.output);
+    }
+    static getDefaults() {
+        return deepMerge(Instrument.getDefaults(), {
+            attackNoise: 1,
+            dampening: 4000,
+            resonance: 0.7,
+            release: 1,
+        });
+    }
+    /**
+     * The dampening control. i.e. the lowpass filter frequency of the comb filter
+     * @min 0
+     * @max 7000
+     */
+    get dampening() {
+        return this._lfcf.dampening;
+    }
+    set dampening(fq) {
+        this._lfcf.dampening = fq;
+    }
+    triggerAttack(note, time) {
+        const freq = this.toFrequency(note);
+        time = this.toSeconds(time);
+        const delayAmount = 1 / freq;
+        this._lfcf.delayTime.setValueAtTime(delayAmount, time);
+        this._noise.start(time);
+        this._noise.stop(time + delayAmount * this.attackNoise);
+        this._lfcf.resonance.cancelScheduledValues(time);
+        this._lfcf.resonance.setValueAtTime(this.resonance, time);
+        return this;
+    }
+    /**
+     * Ramp down the [[resonance]] to 0 over the duration of the release time.
+     */
+    triggerRelease(time) {
+        this._lfcf.resonance.linearRampTo(0, this.release, time);
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this._noise.dispose();
+        this._lfcf.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=PluckSynth.js.map

package/build/esm/instrument/PluckSynth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluckSynth.js","sourceRoot":"","sources":["../../../Tone/instrument/PluckSynth.ts"],"names":[],"mappings":"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"}

package/build/esm/instrument/PolySynth.d.ts

@@ -0,0 +1,176 @@
+import { Frequency, NormalRange, Time } from "../core/type/Units";
+import { RecursivePartial } from "../core/util/Interface";
+import { Instrument, InstrumentOptions } from "./Instrument";
+import { MembraneSynth, MembraneSynthOptions } from "./MembraneSynth";
+import { FMSynth, FMSynthOptions } from "./FMSynth";
+import { AMSynth, AMSynthOptions } from "./AMSynth";
+import { MonoSynth, MonoSynthOptions } from "./MonoSynth";
+import { MetalSynth, MetalSynthOptions } from "./MetalSynth";
+import { Monophonic } from "./Monophonic";
+import { Synth, SynthOptions } from "./Synth";
+declare type VoiceConstructor<V> = {
+    getDefaults: () => VoiceOptions<V>;
+} & (new (...args: any[]) => V);
+declare type OmitMonophonicOptions<T> = Omit<T, "context" | "onsilence">;
+declare type VoiceOptions<T> = T extends MembraneSynth ? MembraneSynthOptions : T extends MetalSynth ? MetalSynthOptions : T extends FMSynth ? FMSynthOptions : T extends MonoSynth ? MonoSynthOptions : T extends AMSynth ? AMSynthOptions : T extends Synth ? SynthOptions : never;
+/**
+ * The settable synth options. excludes monophonic options.
+ */
+declare type PartialVoiceOptions<T> = RecursivePartial<OmitMonophonicOptions<VoiceOptions<T>>>;
+export interface PolySynthOptions<Voice> extends InstrumentOptions {
+    maxPolyphony: number;
+    voice: VoiceConstructor<Voice>;
+    options: PartialVoiceOptions<Voice>;
+}
+/**
+ * PolySynth handles voice creation and allocation for any
+ * instruments passed in as the second paramter. PolySynth is
+ * not a synthesizer by itself, it merely manages voices of
+ * one of the other types of synths, allowing any of the
+ * monophonic synthesizers to be polyphonic.
+ *
+ * @example
+ * const synth = new Tone.PolySynth().toDestination();
+ * // set the attributes across all the voices using 'set'
+ * synth.set({ detune: -1200 });
+ * // play a chord
+ * synth.triggerAttackRelease(["C4", "E4", "A4"], 1);
+ * @category Instrument
+ */
+export declare class PolySynth<Voice extends Monophonic<any> = Synth> extends Instrument<VoiceOptions<Voice>> {
+    readonly name: string;
+    /**
+     * The voices which are not currently in use
+     */
+    private _availableVoices;
+    /**
+     * The currently active voices
+     */
+    private _activeVoices;
+    /**
+     * All of the allocated voices for this synth.
+     */
+    private _voices;
+    /**
+     * The options that are set on the synth.
+     */
+    private options;
+    /**
+     * The polyphony limit.
+     */
+    maxPolyphony: number;
+    /**
+     * The voice constructor
+     */
+    private readonly voice;
+    /**
+     * A voice used for holding the get/set values
+     */
+    private _dummyVoice;
+    /**
+     * The GC timeout. Held so that it could be cancelled when the node is disposed.
+     */
+    private _gcTimeout;
+    /**
+     * A moving average of the number of active voices
+     */
+    private _averageActiveVoices;
+    /**
+     * @param voice The constructor of the voices
+     * @param options	The options object to set the synth voice
+     */
+    constructor(voice?: VoiceConstructor<Voice>, options?: PartialVoiceOptions<Voice>);
+    constructor(options?: Partial<PolySynthOptions<Voice>>);
+    static getDefaults(): PolySynthOptions<Synth>;
+    /**
+     * The number of active voices.
+     */
+    get activeVoices(): number;
+    /**
+     * Invoked when the source is done making sound, so that it can be
+     * readded to the pool of available voices
+     */
+    private _makeVoiceAvailable;
+    /**
+     * Get an available voice from the pool of available voices.
+     * If one is not available and the maxPolyphony limit is reached,
+     * steal a voice, otherwise return null.
+     */
+    private _getNextAvailableVoice;
+    /**
+     * Occasionally check if there are any allocated voices which can be cleaned up.
+     */
+    private _collectGarbage;
+    /**
+     * Internal method which triggers the attack
+     */
+    private _triggerAttack;
+    /**
+     * Internal method which triggers the release
+     */
+    private _triggerRelease;
+    /**
+     * Schedule the attack/release events. If the time is in the future, then it should set a timeout
+     * to wait for just-in-time scheduling
+     */
+    private _scheduleEvent;
+    /**
+     * Trigger the attack portion of the note
+     * @param  notes The notes to play. Accepts a single Frequency or an array of frequencies.
+     * @param  time  The start time of the note.
+     * @param velocity The velocity of the note.
+     * @example
+     * const synth = new Tone.PolySynth(Tone.FMSynth).toDestination();
+     * // trigger a chord immediately with a velocity of 0.2
+     * synth.triggerAttack(["Ab3", "C4", "F5"], Tone.now(), 0.2);
+     */
+    triggerAttack(notes: Frequency | Frequency[], time?: Time, velocity?: NormalRange): this;
+    /**
+     * Trigger the release of the note. Unlike monophonic instruments,
+     * a note (or array of notes) needs to be passed in as the first argument.
+     * @param  notes The notes to play. Accepts a single Frequency or an array of frequencies.
+     * @param  time  When the release will be triggered.
+     * @example
+     * @example
+     * const poly = new Tone.PolySynth(Tone.AMSynth).toDestination();
+     * poly.triggerAttack(["Ab3", "C4", "F5"]);
+     * // trigger the release of the given notes.
+     * poly.triggerRelease(["Ab3", "C4"], "+1");
+     * poly.triggerRelease("F5", "+3");
+     */
+    triggerRelease(notes: Frequency | Frequency[], time?: Time): this;
+    /**
+     * Trigger the attack and release after the specified duration
+     * @param  notes The notes to play. Accepts a single  Frequency or an array of frequencies.
+     * @param  duration the duration of the note
+     * @param  time  if no time is given, defaults to now
+     * @param  velocity the velocity of the attack (0-1)
+     * @example
+     * const poly = new Tone.PolySynth(Tone.AMSynth).toDestination();
+     * // can pass in an array of durations as well
+     * poly.triggerAttackRelease(["Eb3", "G4", "Bb4", "D5"], [4, 3, 2, 1]);
+     */
+    triggerAttackRelease(notes: Frequency | Frequency[], duration: Time | Time[], time?: Time, velocity?: NormalRange): this;
+    sync(): this;
+    /**
+     * Set a member/attribute of the voices
+     * @example
+     * const poly = new Tone.PolySynth().toDestination();
+     * // set all of the voices using an options object for the synth type
+     * poly.set({
+     * 	envelope: {
+     * 		attack: 0.25
+     * 	}
+     * });
+     * poly.triggerAttackRelease("Bb3", 0.2);
+     */
+    set(options: RecursivePartial<VoiceOptions<Voice>>): this;
+    get(): VoiceOptions<Voice>;
+    /**
+     * Trigger the release portion of all the currently active voices immediately.
+     * Useful for silencing the synth.
+     */
+    releaseAll(time?: Time): this;
+    dispose(): this;
+}
+export {};

package/build/esm/instrument/PolySynth.js

@@ -0,0 +1,302 @@
+import { MidiClass } from "../core/type/Midi";
+import { deepMerge, omitFromObject, optionsFromArguments } from "../core/util/Defaults";
+import { isArray, isNumber } from "../core/util/TypeCheck";
+import { Instrument } from "./Instrument";
+import { Synth } from "./Synth";
+import { assert, warn } from "../core/util/Debug";
+/**
+ * PolySynth handles voice creation and allocation for any
+ * instruments passed in as the second paramter. PolySynth is
+ * not a synthesizer by itself, it merely manages voices of
+ * one of the other types of synths, allowing any of the
+ * monophonic synthesizers to be polyphonic.
+ *
+ * @example
+ * const synth = new Tone.PolySynth().toDestination();
+ * // set the attributes across all the voices using 'set'
+ * synth.set({ detune: -1200 });
+ * // play a chord
+ * synth.triggerAttackRelease(["C4", "E4", "A4"], 1);
+ * @category Instrument
+ */
+export class PolySynth extends Instrument {
+    constructor() {
+        super(optionsFromArguments(PolySynth.getDefaults(), arguments, ["voice", "options"]));
+        this.name = "PolySynth";
+        /**
+         * The voices which are not currently in use
+         */
+        this._availableVoices = [];
+        /**
+         * The currently active voices
+         */
+        this._activeVoices = [];
+        /**
+         * All of the allocated voices for this synth.
+         */
+        this._voices = [];
+        /**
+         * The GC timeout. Held so that it could be cancelled when the node is disposed.
+         */
+        this._gcTimeout = -1;
+        /**
+         * A moving average of the number of active voices
+         */
+        this._averageActiveVoices = 0;
+        const options = optionsFromArguments(PolySynth.getDefaults(), arguments, ["voice", "options"]);
+        // check against the old API (pre 14.3.0)
+        assert(!isNumber(options.voice), "DEPRECATED: The polyphony count is no longer the first argument.");
+        const defaults = options.voice.getDefaults();
+        this.options = Object.assign(defaults, options.options);
+        this.voice = options.voice;
+        this.maxPolyphony = options.maxPolyphony;
+        // create the first voice
+        this._dummyVoice = this._getNextAvailableVoice();
+        // remove it from the voices list
+        const index = this._voices.indexOf(this._dummyVoice);
+        this._voices.splice(index, 1);
+        // kick off the GC interval
+        this._gcTimeout = this.context.setInterval(this._collectGarbage.bind(this), 1);
+    }
+    static getDefaults() {
+        return Object.assign(Instrument.getDefaults(), {
+            maxPolyphony: 32,
+            options: {},
+            voice: Synth,
+        });
+    }
+    /**
+     * The number of active voices.
+     */
+    get activeVoices() {
+        return this._activeVoices.length;
+    }
+    /**
+     * Invoked when the source is done making sound, so that it can be
+     * readded to the pool of available voices
+     */
+    _makeVoiceAvailable(voice) {
+        this._availableVoices.push(voice);
+        // remove the midi note from 'active voices'
+        const activeVoiceIndex = this._activeVoices.findIndex((e) => e.voice === voice);
+        this._activeVoices.splice(activeVoiceIndex, 1);
+    }
+    /**
+     * Get an available voice from the pool of available voices.
+     * If one is not available and the maxPolyphony limit is reached,
+     * steal a voice, otherwise return null.
+     */
+    _getNextAvailableVoice() {
+        // if there are available voices, return the first one
+        if (this._availableVoices.length) {
+            return this._availableVoices.shift();
+        }
+        else if (this._voices.length < this.maxPolyphony) {
+            // otherwise if there is still more maxPolyphony, make a new voice
+            const voice = new this.voice(Object.assign(this.options, {
+                context: this.context,
+                onsilence: this._makeVoiceAvailable.bind(this),
+            }));
+            voice.connect(this.output);
+            this._voices.push(voice);
+            return voice;
+        }
+        else {
+            warn("Max polyphony exceeded. Note dropped.");
+        }
+    }
+    /**
+     * Occasionally check if there are any allocated voices which can be cleaned up.
+     */
+    _collectGarbage() {
+        this._averageActiveVoices = Math.max(this._averageActiveVoices * 0.95, this.activeVoices);
+        if (this._availableVoices.length && this._voices.length > Math.ceil(this._averageActiveVoices + 1)) {
+            // take off an available note
+            const firstAvail = this._availableVoices.shift();
+            const index = this._voices.indexOf(firstAvail);
+            this._voices.splice(index, 1);
+            if (!this.context.isOffline) {
+                firstAvail.dispose();
+            }
+        }
+    }
+    /**
+     * Internal method which triggers the attack
+     */
+    _triggerAttack(notes, time, velocity) {
+        notes.forEach(note => {
+            const midiNote = new MidiClass(this.context, note).toMidi();
+            const voice = this._getNextAvailableVoice();
+            if (voice) {
+                voice.triggerAttack(note, time, velocity);
+                this._activeVoices.push({
+                    midi: midiNote, voice, released: false,
+                });
+                this.log("triggerAttack", note, time);
+            }
+        });
+    }
+    /**
+     * Internal method which triggers the release
+     */
+    _triggerRelease(notes, time) {
+        notes.forEach(note => {
+            const midiNote = new MidiClass(this.context, note).toMidi();
+            const event = this._activeVoices.find(({ midi, released }) => midi === midiNote && !released);
+            if (event) {
+                // trigger release on that note
+                event.voice.triggerRelease(time);
+                // mark it as released
+                event.released = true;
+                this.log("triggerRelease", note, time);
+            }
+        });
+    }
+    /**
+     * Schedule the attack/release events. If the time is in the future, then it should set a timeout
+     * to wait for just-in-time scheduling
+     */
+    _scheduleEvent(type, notes, time, velocity) {
+        assert(!this.disposed, "Synth was already disposed");
+        // if the notes are greater than this amount of time in the future, they should be scheduled with setTimeout
+        if (time <= this.now()) {
+            // do it immediately
+            if (type === "attack") {
+                this._triggerAttack(notes, time, velocity);
+            }
+            else {
+                this._triggerRelease(notes, time);
+            }
+        }
+        else {
+            // schedule it to start in the future
+            this.context.setTimeout(() => {
+                if (!this.disposed) {
+                    this._scheduleEvent(type, notes, time, velocity);
+                }
+            }, time - this.now());
+        }
+    }
+    /**
+     * Trigger the attack portion of the note
+     * @param  notes The notes to play. Accepts a single Frequency or an array of frequencies.
+     * @param  time  The start time of the note.
+     * @param velocity The velocity of the note.
+     * @example
+     * const synth = new Tone.PolySynth(Tone.FMSynth).toDestination();
+     * // trigger a chord immediately with a velocity of 0.2
+     * synth.triggerAttack(["Ab3", "C4", "F5"], Tone.now(), 0.2);
+     */
+    triggerAttack(notes, time, velocity) {
+        if (!Array.isArray(notes)) {
+            notes = [notes];
+        }
+        const computedTime = this.toSeconds(time);
+        this._scheduleEvent("attack", notes, computedTime, velocity);
+        return this;
+    }
+    /**
+     * Trigger the release of the note. Unlike monophonic instruments,
+     * a note (or array of notes) needs to be passed in as the first argument.
+     * @param  notes The notes to play. Accepts a single Frequency or an array of frequencies.
+     * @param  time  When the release will be triggered.
+     * @example
+     * @example
+     * const poly = new Tone.PolySynth(Tone.AMSynth).toDestination();
+     * poly.triggerAttack(["Ab3", "C4", "F5"]);
+     * // trigger the release of the given notes.
+     * poly.triggerRelease(["Ab3", "C4"], "+1");
+     * poly.triggerRelease("F5", "+3");
+     */
+    triggerRelease(notes, time) {
+        if (!Array.isArray(notes)) {
+            notes = [notes];
+        }
+        const computedTime = this.toSeconds(time);
+        this._scheduleEvent("release", notes, computedTime);
+        return this;
+    }
+    /**
+     * Trigger the attack and release after the specified duration
+     * @param  notes The notes to play. Accepts a single  Frequency or an array of frequencies.
+     * @param  duration the duration of the note
+     * @param  time  if no time is given, defaults to now
+     * @param  velocity the velocity of the attack (0-1)
+     * @example
+     * const poly = new Tone.PolySynth(Tone.AMSynth).toDestination();
+     * // can pass in an array of durations as well
+     * poly.triggerAttackRelease(["Eb3", "G4", "Bb4", "D5"], [4, 3, 2, 1]);
+     */
+    triggerAttackRelease(notes, duration, time, velocity) {
+        const computedTime = this.toSeconds(time);
+        this.triggerAttack(notes, computedTime, velocity);
+        if (isArray(duration)) {
+            assert(isArray(notes), "If the duration is an array, the notes must also be an array");
+            notes = notes;
+            for (let i = 0; i < notes.length; i++) {
+                const d = duration[Math.min(i, duration.length - 1)];
+                const durationSeconds = this.toSeconds(d);
+                assert(durationSeconds > 0, "The duration must be greater than 0");
+                this.triggerRelease(notes[i], computedTime + durationSeconds);
+            }
+        }
+        else {
+            const durationSeconds = this.toSeconds(duration);
+            assert(durationSeconds > 0, "The duration must be greater than 0");
+            this.triggerRelease(notes, computedTime + durationSeconds);
+        }
+        return this;
+    }
+    sync() {
+        if (this._syncState()) {
+            this._syncMethod("triggerAttack", 1);
+            this._syncMethod("triggerRelease", 1);
+        }
+        return this;
+    }
+    /**
+     * Set a member/attribute of the voices
+     * @example
+     * const poly = new Tone.PolySynth().toDestination();
+     * // set all of the voices using an options object for the synth type
+     * poly.set({
+     * 	envelope: {
+     * 		attack: 0.25
+     * 	}
+     * });
+     * poly.triggerAttackRelease("Bb3", 0.2);
+     */
+    set(options) {
+        // remove options which are controlled by the PolySynth
+        const sanitizedOptions = omitFromObject(options, ["onsilence", "context"]);
+        // store all of the options
+        this.options = deepMerge(this.options, sanitizedOptions);
+        this._voices.forEach(voice => voice.set(sanitizedOptions));
+        this._dummyVoice.set(sanitizedOptions);
+        return this;
+    }
+    get() {
+        return this._dummyVoice.get();
+    }
+    /**
+     * Trigger the release portion of all the currently active voices immediately.
+     * Useful for silencing the synth.
+     */
+    releaseAll(time) {
+        const computedTime = this.toSeconds(time);
+        this._activeVoices.forEach(({ voice }) => {
+            voice.triggerRelease(computedTime);
+        });
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this._dummyVoice.dispose();
+        this._voices.forEach(v => v.dispose());
+        this._activeVoices = [];
+        this._availableVoices = [];
+        this.context.clearInterval(this._gcTimeout);
+        return this;
+    }
+}
+//# sourceMappingURL=PolySynth.js.map

package/build/esm/instrument/PolySynth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolySynth.js","sourceRoot":"","sources":["../../../Tone/instrument/PolySynth.ts"],"names":[],"mappings":"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"}