tone 14.8.27

package/build/esm/source/buffer/Player.d.ts

@@ -0,0 +1,190 @@
+import { ToneAudioBuffer } from "../../core/context/ToneAudioBuffer";
+import { Positive, Seconds, Time } from "../../core/type/Units";
+import { Source, SourceOptions } from "../Source";
+export interface PlayerOptions extends SourceOptions {
+    onload: () => void;
+    onerror: (error: Error) => void;
+    playbackRate: Positive;
+    loop: boolean;
+    autostart: boolean;
+    loopStart: Time;
+    loopEnd: Time;
+    reverse: boolean;
+    fadeIn: Time;
+    fadeOut: Time;
+    url?: ToneAudioBuffer | string | AudioBuffer;
+}
+/**
+ * Player is an audio file player with start, loop, and stop functions.
+ * @example
+ * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/gong_1.mp3").toDestination();
+ * // play as soon as the buffer is loaded
+ * player.autostart = true;
+ * @category Source
+ */
+export declare class Player extends Source<PlayerOptions> {
+    readonly name: string;
+    /**
+     * If the file should play as soon
+     * as the buffer is loaded.
+     */
+    autostart: boolean;
+    /**
+     * The buffer
+     */
+    private _buffer;
+    /**
+     * if the buffer should loop once it's over
+     */
+    private _loop;
+    /**
+     * if 'loop' is true, the loop will start at this position
+     */
+    private _loopStart;
+    /**
+     * if 'loop' is true, the loop will end at this position
+     */
+    private _loopEnd;
+    /**
+     * the playback rate
+     */
+    private _playbackRate;
+    /**
+     * All of the active buffer source nodes
+     */
+    private _activeSources;
+    /**
+     * The fadeIn time of the amplitude envelope.
+     */
+    fadeIn: Time;
+    /**
+     * The fadeOut time of the amplitude envelope.
+     */
+    fadeOut: Time;
+    /**
+     * @param url Either the AudioBuffer or the url from which to load the AudioBuffer
+     * @param onload The function to invoke when the buffer is loaded.
+     */
+    constructor(url?: string | AudioBuffer | ToneAudioBuffer, onload?: () => void);
+    constructor(options?: Partial<PlayerOptions>);
+    static getDefaults(): PlayerOptions;
+    /**
+     * Load the audio file as an audio buffer.
+     * Decodes the audio asynchronously and invokes
+     * the callback once the audio buffer loads.
+     * Note: this does not need to be called if a url
+     * was passed in to the constructor. Only use this
+     * if you want to manually load a new url.
+     * @param url The url of the buffer to load. Filetype support depends on the browser.
+     */
+    load(url: string): Promise<this>;
+    /**
+     * Internal callback when the buffer is loaded.
+     */
+    private _onload;
+    /**
+     * Internal callback when the buffer is done playing.
+     */
+    private _onSourceEnd;
+    /**
+     * Play the buffer at the given startTime. Optionally add an offset
+     * and/or duration which will play the buffer from a position
+     * within the buffer for the given duration.
+     *
+     * @param  time When the player should start.
+     * @param  offset The offset from the beginning of the sample to start at.
+     * @param  duration How long the sample should play. If no duration is given, it will default to the full length of the sample (minus any offset)
+     */
+    start(time?: Time, offset?: Time, duration?: Time): this;
+    /**
+     * Internal start method
+     */
+    protected _start(startTime?: Time, offset?: Time, duration?: Time): void;
+    /**
+     * Stop playback.
+     */
+    protected _stop(time?: Time): void;
+    /**
+     * Stop and then restart the player from the beginning (or offset)
+     * @param  time When the player should start.
+     * @param  offset The offset from the beginning of the sample to start at.
+     * @param  duration How long the sample should play. If no duration is given,
+     * 					it will default to the full length of the sample (minus any offset)
+     */
+    restart(time?: Seconds, offset?: Time, duration?: Time): this;
+    protected _restart(time?: Seconds, offset?: Time, duration?: Time): void;
+    /**
+     * Seek to a specific time in the player's buffer. If the
+     * source is no longer playing at that time, it will stop.
+     * @param offset The time to seek to.
+     * @param when The time for the seek event to occur.
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/gurgling_theremin_1.mp3", () => {
+     * 	player.start();
+     * 	// seek to the offset in 1 second from now
+     * 	player.seek(0.4, "+1");
+     * }).toDestination();
+     */
+    seek(offset: Time, when?: Time): this;
+    /**
+     * Set the loop start and end. Will only loop if loop is set to true.
+     * @param loopStart The loop start time
+     * @param loopEnd The loop end time
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/malevoices_aa2_F3.mp3").toDestination();
+     * // loop between the given points
+     * player.setLoopPoints(0.2, 0.3);
+     * player.loop = true;
+     * player.autostart = true;
+     */
+    setLoopPoints(loopStart: Time, loopEnd: Time): this;
+    /**
+     * If loop is true, the loop will start at this position.
+     */
+    get loopStart(): Time;
+    set loopStart(loopStart: Time);
+    /**
+     * If loop is true, the loop will end at this position.
+     */
+    get loopEnd(): Time;
+    set loopEnd(loopEnd: Time);
+    /**
+     * The audio buffer belonging to the player.
+     */
+    get buffer(): ToneAudioBuffer;
+    set buffer(buffer: ToneAudioBuffer);
+    /**
+     * If the buffer should loop once it's over.
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/drum-samples/breakbeat.mp3").toDestination();
+     * player.loop = true;
+     * player.autostart = true;
+     */
+    get loop(): boolean;
+    set loop(loop: boolean);
+    /**
+     * Normal speed is 1. The pitch will change with the playback rate.
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/femalevoices_aa2_A5.mp3").toDestination();
+     * // play at 1/4 speed
+     * player.playbackRate = 0.25;
+     * // play as soon as the buffer is loaded
+     * player.autostart = true;
+     */
+    get playbackRate(): Positive;
+    set playbackRate(rate: Positive);
+    /**
+     * If the buffer should be reversed
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/chime_1.mp3").toDestination();
+     * player.autostart = true;
+     * player.reverse = true;
+     */
+    get reverse(): boolean;
+    set reverse(rev: boolean);
+    /**
+     * If the buffer is loaded
+     */
+    get loaded(): boolean;
+    dispose(): this;
+}

package/build/esm/source/buffer/Player.js

@@ -0,0 +1,352 @@
+import { __awaiter, __decorate } from "tslib";
+import { ToneAudioBuffer } from "../../core/context/ToneAudioBuffer";
+import { defaultArg, optionsFromArguments } from "../../core/util/Defaults";
+import { noOp } from "../../core/util/Interface";
+import { isUndef } from "../../core/util/TypeCheck";
+import { Source } from "../Source";
+import { ToneBufferSource } from "./ToneBufferSource";
+import { assertRange } from "../../core/util/Debug";
+import { timeRange } from "../../core/util/Decorator";
+/**
+ * Player is an audio file player with start, loop, and stop functions.
+ * @example
+ * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/gong_1.mp3").toDestination();
+ * // play as soon as the buffer is loaded
+ * player.autostart = true;
+ * @category Source
+ */
+export class Player extends Source {
+    constructor() {
+        super(optionsFromArguments(Player.getDefaults(), arguments, ["url", "onload"]));
+        this.name = "Player";
+        /**
+         * All of the active buffer source nodes
+         */
+        this._activeSources = new Set();
+        const options = optionsFromArguments(Player.getDefaults(), arguments, ["url", "onload"]);
+        this._buffer = new ToneAudioBuffer({
+            onload: this._onload.bind(this, options.onload),
+            onerror: options.onerror,
+            reverse: options.reverse,
+            url: options.url,
+        });
+        this.autostart = options.autostart;
+        this._loop = options.loop;
+        this._loopStart = options.loopStart;
+        this._loopEnd = options.loopEnd;
+        this._playbackRate = options.playbackRate;
+        this.fadeIn = options.fadeIn;
+        this.fadeOut = options.fadeOut;
+    }
+    static getDefaults() {
+        return Object.assign(Source.getDefaults(), {
+            autostart: false,
+            fadeIn: 0,
+            fadeOut: 0,
+            loop: false,
+            loopEnd: 0,
+            loopStart: 0,
+            onload: noOp,
+            onerror: noOp,
+            playbackRate: 1,
+            reverse: false,
+        });
+    }
+    /**
+     * Load the audio file as an audio buffer.
+     * Decodes the audio asynchronously and invokes
+     * the callback once the audio buffer loads.
+     * Note: this does not need to be called if a url
+     * was passed in to the constructor. Only use this
+     * if you want to manually load a new url.
+     * @param url The url of the buffer to load. Filetype support depends on the browser.
+     */
+    load(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this._buffer.load(url);
+            this._onload();
+            return this;
+        });
+    }
+    /**
+     * Internal callback when the buffer is loaded.
+     */
+    _onload(callback = noOp) {
+        callback();
+        if (this.autostart) {
+            this.start();
+        }
+    }
+    /**
+     * Internal callback when the buffer is done playing.
+     */
+    _onSourceEnd(source) {
+        // invoke the onstop function
+        this.onstop(this);
+        // delete the source from the active sources
+        this._activeSources.delete(source);
+        if (this._activeSources.size === 0 && !this._synced &&
+            this._state.getValueAtTime(this.now()) === "started") {
+            // remove the 'implicitEnd' event and replace with an explicit end
+            this._state.cancel(this.now());
+            this._state.setStateAtTime("stopped", this.now());
+        }
+    }
+    /**
+     * Play the buffer at the given startTime. Optionally add an offset
+     * and/or duration which will play the buffer from a position
+     * within the buffer for the given duration.
+     *
+     * @param  time When the player should start.
+     * @param  offset The offset from the beginning of the sample to start at.
+     * @param  duration How long the sample should play. If no duration is given, it will default to the full length of the sample (minus any offset)
+     */
+    start(time, offset, duration) {
+        super.start(time, offset, duration);
+        return this;
+    }
+    /**
+     * Internal start method
+     */
+    _start(startTime, offset, duration) {
+        // if it's a loop the default offset is the loopStart point
+        if (this._loop) {
+            offset = defaultArg(offset, this._loopStart);
+        }
+        else {
+            // otherwise the default offset is 0
+            offset = defaultArg(offset, 0);
+        }
+        // compute the values in seconds
+        const computedOffset = this.toSeconds(offset);
+        // compute the duration which is either the passed in duration of the buffer.duration - offset
+        const origDuration = duration;
+        duration = defaultArg(duration, Math.max(this._buffer.duration - computedOffset, 0));
+        let computedDuration = this.toSeconds(duration);
+        // scale it by the playback rate
+        computedDuration = computedDuration / this._playbackRate;
+        // get the start time
+        startTime = this.toSeconds(startTime);
+        // make the source
+        const source = new ToneBufferSource({
+            url: this._buffer,
+            context: this.context,
+            fadeIn: this.fadeIn,
+            fadeOut: this.fadeOut,
+            loop: this._loop,
+            loopEnd: this._loopEnd,
+            loopStart: this._loopStart,
+            onended: this._onSourceEnd.bind(this),
+            playbackRate: this._playbackRate,
+        }).connect(this.output);
+        // set the looping properties
+        if (!this._loop && !this._synced) {
+            // cancel the previous stop
+            this._state.cancel(startTime + computedDuration);
+            // if it's not looping, set the state change at the end of the sample
+            this._state.setStateAtTime("stopped", startTime + computedDuration, {
+                implicitEnd: true,
+            });
+        }
+        // add it to the array of active sources
+        this._activeSources.add(source);
+        // start it
+        if (this._loop && isUndef(origDuration)) {
+            source.start(startTime, computedOffset);
+        }
+        else {
+            // subtract the fade out time
+            source.start(startTime, computedOffset, computedDuration - this.toSeconds(this.fadeOut));
+        }
+    }
+    /**
+     * Stop playback.
+     */
+    _stop(time) {
+        const computedTime = this.toSeconds(time);
+        this._activeSources.forEach(source => source.stop(computedTime));
+    }
+    /**
+     * Stop and then restart the player from the beginning (or offset)
+     * @param  time When the player should start.
+     * @param  offset The offset from the beginning of the sample to start at.
+     * @param  duration How long the sample should play. If no duration is given,
+     * 					it will default to the full length of the sample (minus any offset)
+     */
+    restart(time, offset, duration) {
+        super.restart(time, offset, duration);
+        return this;
+    }
+    _restart(time, offset, duration) {
+        this._stop(time);
+        this._start(time, offset, duration);
+    }
+    /**
+     * Seek to a specific time in the player's buffer. If the
+     * source is no longer playing at that time, it will stop.
+     * @param offset The time to seek to.
+     * @param when The time for the seek event to occur.
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/gurgling_theremin_1.mp3", () => {
+     * 	player.start();
+     * 	// seek to the offset in 1 second from now
+     * 	player.seek(0.4, "+1");
+     * }).toDestination();
+     */
+    seek(offset, when) {
+        const computedTime = this.toSeconds(when);
+        if (this._state.getValueAtTime(computedTime) === "started") {
+            const computedOffset = this.toSeconds(offset);
+            // if it's currently playing, stop it
+            this._stop(computedTime);
+            // restart it at the given time
+            this._start(computedTime, computedOffset);
+        }
+        return this;
+    }
+    /**
+     * Set the loop start and end. Will only loop if loop is set to true.
+     * @param loopStart The loop start time
+     * @param loopEnd The loop end time
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/malevoices_aa2_F3.mp3").toDestination();
+     * // loop between the given points
+     * player.setLoopPoints(0.2, 0.3);
+     * player.loop = true;
+     * player.autostart = true;
+     */
+    setLoopPoints(loopStart, loopEnd) {
+        this.loopStart = loopStart;
+        this.loopEnd = loopEnd;
+        return this;
+    }
+    /**
+     * If loop is true, the loop will start at this position.
+     */
+    get loopStart() {
+        return this._loopStart;
+    }
+    set loopStart(loopStart) {
+        this._loopStart = loopStart;
+        if (this.buffer.loaded) {
+            assertRange(this.toSeconds(loopStart), 0, this.buffer.duration);
+        }
+        // get the current source
+        this._activeSources.forEach(source => {
+            source.loopStart = loopStart;
+        });
+    }
+    /**
+     * If loop is true, the loop will end at this position.
+     */
+    get loopEnd() {
+        return this._loopEnd;
+    }
+    set loopEnd(loopEnd) {
+        this._loopEnd = loopEnd;
+        if (this.buffer.loaded) {
+            assertRange(this.toSeconds(loopEnd), 0, this.buffer.duration);
+        }
+        // get the current source
+        this._activeSources.forEach(source => {
+            source.loopEnd = loopEnd;
+        });
+    }
+    /**
+     * The audio buffer belonging to the player.
+     */
+    get buffer() {
+        return this._buffer;
+    }
+    set buffer(buffer) {
+        this._buffer.set(buffer);
+    }
+    /**
+     * If the buffer should loop once it's over.
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/drum-samples/breakbeat.mp3").toDestination();
+     * player.loop = true;
+     * player.autostart = true;
+     */
+    get loop() {
+        return this._loop;
+    }
+    set loop(loop) {
+        // if no change, do nothing
+        if (this._loop === loop) {
+            return;
+        }
+        this._loop = loop;
+        // set the loop of all of the sources
+        this._activeSources.forEach(source => {
+            source.loop = loop;
+        });
+        if (loop) {
+            // remove the next stopEvent
+            const stopEvent = this._state.getNextState("stopped", this.now());
+            if (stopEvent) {
+                this._state.cancel(stopEvent.time);
+            }
+        }
+    }
+    /**
+     * Normal speed is 1. The pitch will change with the playback rate.
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/femalevoices_aa2_A5.mp3").toDestination();
+     * // play at 1/4 speed
+     * player.playbackRate = 0.25;
+     * // play as soon as the buffer is loaded
+     * player.autostart = true;
+     */
+    get playbackRate() {
+        return this._playbackRate;
+    }
+    set playbackRate(rate) {
+        this._playbackRate = rate;
+        const now = this.now();
+        // cancel the stop event since it's at a different time now
+        const stopEvent = this._state.getNextState("stopped", now);
+        if (stopEvent && stopEvent.implicitEnd) {
+            this._state.cancel(stopEvent.time);
+            this._activeSources.forEach(source => source.cancelStop());
+        }
+        // set all the sources
+        this._activeSources.forEach(source => {
+            source.playbackRate.setValueAtTime(rate, now);
+        });
+    }
+    /**
+     * If the buffer should be reversed
+     * @example
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/chime_1.mp3").toDestination();
+     * player.autostart = true;
+     * player.reverse = true;
+     */
+    get reverse() {
+        return this._buffer.reverse;
+    }
+    set reverse(rev) {
+        this._buffer.reverse = rev;
+    }
+    /**
+     * If the buffer is loaded
+     */
+    get loaded() {
+        return this._buffer.loaded;
+    }
+    dispose() {
+        super.dispose();
+        // disconnect all of the players
+        this._activeSources.forEach(source => source.dispose());
+        this._activeSources.clear();
+        this._buffer.dispose();
+        return this;
+    }
+}
+__decorate([
+    timeRange(0)
+], Player.prototype, "fadeIn", void 0);
+__decorate([
+    timeRange(0)
+], Player.prototype, "fadeOut", void 0);
+//# sourceMappingURL=Player.js.map

package/build/esm/source/buffer/Player.js.map

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

package/build/esm/source/buffer/Players.d.ts

@@ -0,0 +1,121 @@
+import { Param } from "../../core/context/Param";
+import { ToneAudioBuffer } from "../../core/context/ToneAudioBuffer";
+import { ToneAudioBuffersUrlMap } from "../../core/context/ToneAudioBuffers";
+import { OutputNode, ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { Decibels, Time } from "../../core/type/Units";
+import { BasicPlaybackState } from "../../core/util/StateTimeline";
+import { SourceOptions } from "../Source";
+import { Player } from "./Player";
+export interface PlayersOptions extends SourceOptions {
+    urls: ToneAudioBuffersUrlMap;
+    volume: Decibels;
+    mute: boolean;
+    onload: () => void;
+    onerror: (error: Error) => void;
+    baseUrl: string;
+    fadeIn: Time;
+    fadeOut: Time;
+}
+/**
+ * Players combines multiple [[Player]] objects.
+ * @category Source
+ */
+export declare class Players extends ToneAudioNode<PlayersOptions> {
+    readonly name: string;
+    /**
+     * The output volume node
+     */
+    private _volume;
+    /**
+     * The volume of the output in decibels.
+     */
+    readonly volume: Param<"decibels">;
+    /**
+     * The combined output of all of the players
+     */
+    readonly output: OutputNode;
+    /**
+     * Players has no input.
+     */
+    readonly input: undefined;
+    /**
+     * The container of all of the players
+     */
+    private _players;
+    /**
+     * The container of all the buffers
+     */
+    private _buffers;
+    /**
+     * private holder of the fadeIn time
+     */
+    private _fadeIn;
+    /**
+     * private holder of the fadeOut time
+     */
+    private _fadeOut;
+    /**
+     * @param urls An object mapping a name to a url.
+     * @param onload The function to invoke when all buffers are loaded.
+     */
+    constructor(urls?: ToneAudioBuffersUrlMap, onload?: () => void);
+    /**
+     * @param urls An object mapping a name to a url.
+     * @param options The remaining options associated with the players
+     */
+    constructor(urls?: ToneAudioBuffersUrlMap, options?: Partial<Omit<PlayersOptions, "urls">>);
+    constructor(options?: Partial<PlayersOptions>);
+    static getDefaults(): PlayersOptions;
+    /**
+     * Mute the output.
+     */
+    get mute(): boolean;
+    set mute(mute: boolean);
+    /**
+     * The fadeIn time of the envelope applied to the source.
+     */
+    get fadeIn(): Time;
+    set fadeIn(fadeIn: Time);
+    /**
+     * The fadeOut time of the each of the sources.
+     */
+    get fadeOut(): Time;
+    set fadeOut(fadeOut: Time);
+    /**
+     * The state of the players object. Returns "started" if any of the players are playing.
+     */
+    get state(): BasicPlaybackState;
+    /**
+     * True if the buffers object has a buffer by that name.
+     * @param name  The key or index of the buffer.
+     */
+    has(name: string): boolean;
+    /**
+     * Get a player by name.
+     * @param  name  The players name as defined in the constructor object or `add` method.
+     */
+    player(name: string): Player;
+    /**
+     * If all the buffers are loaded or not
+     */
+    get loaded(): boolean;
+    /**
+     * Add a player by name and url to the Players
+     * @param  name A unique name to give the player
+     * @param  url  Either the url of the bufer or a buffer which will be added with the given name.
+     * @param callback  The callback to invoke when the url is loaded.
+     * @example
+     * const players = new Tone.Players();
+     * players.add("gong", "https://tonejs.github.io/audio/berklee/gong_1.mp3", () => {
+     * 	console.log("gong loaded");
+     * 	players.get("gong").start();
+     * });
+     */
+    add(name: string, url: string | ToneAudioBuffer | AudioBuffer, callback?: () => void): this;
+    /**
+     * Stop all of the players at the given time
+     * @param time The time to stop all of the players.
+     */
+    stopAll(time?: Time): this;
+    dispose(): this;
+}