tone 14.8.27

package/build/esm/core/context/ToneAudioBuffer.js

@@ -0,0 +1,364 @@
+import { __awaiter } from "tslib";
+import { getContext } from "../Global";
+import { Tone } from "../Tone";
+import { isAudioBuffer } from "../util/AdvancedTypeCheck";
+import { optionsFromArguments } from "../util/Defaults";
+import { noOp } from "../util/Interface";
+import { isArray, isNumber, isString } from "../util/TypeCheck";
+import { assert } from "../util/Debug";
+/**
+ * AudioBuffer loading and storage. ToneAudioBuffer is used internally by all
+ * classes that make requests for audio files such as Tone.Player,
+ * Tone.Sampler and Tone.Convolver.
+ * @example
+ * const buffer = new Tone.ToneAudioBuffer("https://tonejs.github.io/audio/casio/A1.mp3", () => {
+ * 	console.log("loaded");
+ * });
+ * @category Core
+ */
+export class ToneAudioBuffer extends Tone {
+    constructor() {
+        super();
+        this.name = "ToneAudioBuffer";
+        /**
+         * Callback when the buffer is loaded.
+         */
+        this.onload = noOp;
+        const options = optionsFromArguments(ToneAudioBuffer.getDefaults(), arguments, ["url", "onload", "onerror"]);
+        this.reverse = options.reverse;
+        this.onload = options.onload;
+        if (options.url && isAudioBuffer(options.url) || options.url instanceof ToneAudioBuffer) {
+            this.set(options.url);
+        }
+        else if (isString(options.url)) {
+            // initiate the download
+            this.load(options.url).catch(options.onerror);
+        }
+    }
+    static getDefaults() {
+        return {
+            onerror: noOp,
+            onload: noOp,
+            reverse: false,
+        };
+    }
+    /**
+     * The sample rate of the AudioBuffer
+     */
+    get sampleRate() {
+        if (this._buffer) {
+            return this._buffer.sampleRate;
+        }
+        else {
+            return getContext().sampleRate;
+        }
+    }
+    /**
+     * Pass in an AudioBuffer or ToneAudioBuffer to set the value of this buffer.
+     */
+    set(buffer) {
+        if (buffer instanceof ToneAudioBuffer) {
+            // if it's loaded, set it
+            if (buffer.loaded) {
+                this._buffer = buffer.get();
+            }
+            else {
+                // otherwise when it's loaded, invoke it's callback
+                buffer.onload = () => {
+                    this.set(buffer);
+                    this.onload(this);
+                };
+            }
+        }
+        else {
+            this._buffer = buffer;
+        }
+        // reverse it initially
+        if (this._reversed) {
+            this._reverse();
+        }
+        return this;
+    }
+    /**
+     * The audio buffer stored in the object.
+     */
+    get() {
+        return this._buffer;
+    }
+    /**
+     * Makes an fetch request for the selected url then decodes the file as an audio buffer.
+     * Invokes the callback once the audio buffer loads.
+     * @param url The url of the buffer to load. filetype support depends on the browser.
+     * @returns A Promise which resolves with this ToneAudioBuffer
+     */
+    load(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const doneLoading = ToneAudioBuffer.load(url).then(audioBuffer => {
+                this.set(audioBuffer);
+                // invoke the onload method
+                this.onload(this);
+            });
+            ToneAudioBuffer.downloads.push(doneLoading);
+            try {
+                yield doneLoading;
+            }
+            finally {
+                // remove the downloaded file
+                const index = ToneAudioBuffer.downloads.indexOf(doneLoading);
+                ToneAudioBuffer.downloads.splice(index, 1);
+            }
+            return this;
+        });
+    }
+    /**
+     * clean up
+     */
+    dispose() {
+        super.dispose();
+        this._buffer = undefined;
+        return this;
+    }
+    /**
+     * Set the audio buffer from the array.
+     * To create a multichannel AudioBuffer, pass in a multidimensional array.
+     * @param array The array to fill the audio buffer
+     */
+    fromArray(array) {
+        const isMultidimensional = isArray(array) && array[0].length > 0;
+        const channels = isMultidimensional ? array.length : 1;
+        const len = isMultidimensional ? array[0].length : array.length;
+        const context = getContext();
+        const buffer = context.createBuffer(channels, len, context.sampleRate);
+        const multiChannelArray = !isMultidimensional && channels === 1 ?
+            [array] : array;
+        for (let c = 0; c < channels; c++) {
+            buffer.copyToChannel(multiChannelArray[c], c);
+        }
+        this._buffer = buffer;
+        return this;
+    }
+    /**
+     * Sums multiple channels into 1 channel
+     * @param chanNum Optionally only copy a single channel from the array.
+     */
+    toMono(chanNum) {
+        if (isNumber(chanNum)) {
+            this.fromArray(this.toArray(chanNum));
+        }
+        else {
+            let outputArray = new Float32Array(this.length);
+            const numChannels = this.numberOfChannels;
+            for (let channel = 0; channel < numChannels; channel++) {
+                const channelArray = this.toArray(channel);
+                for (let i = 0; i < channelArray.length; i++) {
+                    outputArray[i] += channelArray[i];
+                }
+            }
+            // divide by the number of channels
+            outputArray = outputArray.map(sample => sample / numChannels);
+            this.fromArray(outputArray);
+        }
+        return this;
+    }
+    /**
+     * Get the buffer as an array. Single channel buffers will return a 1-dimensional
+     * Float32Array, and multichannel buffers will return multidimensional arrays.
+     * @param channel Optionally only copy a single channel from the array.
+     */
+    toArray(channel) {
+        if (isNumber(channel)) {
+            return this.getChannelData(channel);
+        }
+        else if (this.numberOfChannels === 1) {
+            return this.toArray(0);
+        }
+        else {
+            const ret = [];
+            for (let c = 0; c < this.numberOfChannels; c++) {
+                ret[c] = this.getChannelData(c);
+            }
+            return ret;
+        }
+    }
+    /**
+     * Returns the Float32Array representing the PCM audio data for the specific channel.
+     * @param  channel  The channel number to return
+     * @return The audio as a TypedArray
+     */
+    getChannelData(channel) {
+        if (this._buffer) {
+            return this._buffer.getChannelData(channel);
+        }
+        else {
+            return new Float32Array(0);
+        }
+    }
+    /**
+     * Cut a subsection of the array and return a buffer of the
+     * subsection. Does not modify the original buffer
+     * @param start The time to start the slice
+     * @param end The end time to slice. If none is given will default to the end of the buffer
+     */
+    slice(start, end = this.duration) {
+        assert(this.loaded, "Buffer is not loaded");
+        const startSamples = Math.floor(start * this.sampleRate);
+        const endSamples = Math.floor(end * this.sampleRate);
+        assert(startSamples < endSamples, "The start time must be less than the end time");
+        const length = endSamples - startSamples;
+        const retBuffer = getContext().createBuffer(this.numberOfChannels, length, this.sampleRate);
+        for (let channel = 0; channel < this.numberOfChannels; channel++) {
+            retBuffer.copyToChannel(this.getChannelData(channel).subarray(startSamples, endSamples), channel);
+        }
+        return new ToneAudioBuffer(retBuffer);
+    }
+    /**
+     * Reverse the buffer.
+     */
+    _reverse() {
+        if (this.loaded) {
+            for (let i = 0; i < this.numberOfChannels; i++) {
+                this.getChannelData(i).reverse();
+            }
+        }
+        return this;
+    }
+    /**
+     * If the buffer is loaded or not
+     */
+    get loaded() {
+        return this.length > 0;
+    }
+    /**
+     * The duration of the buffer in seconds.
+     */
+    get duration() {
+        if (this._buffer) {
+            return this._buffer.duration;
+        }
+        else {
+            return 0;
+        }
+    }
+    /**
+     * The length of the buffer in samples
+     */
+    get length() {
+        if (this._buffer) {
+            return this._buffer.length;
+        }
+        else {
+            return 0;
+        }
+    }
+    /**
+     * The number of discrete audio channels. Returns 0 if no buffer is loaded.
+     */
+    get numberOfChannels() {
+        if (this._buffer) {
+            return this._buffer.numberOfChannels;
+        }
+        else {
+            return 0;
+        }
+    }
+    /**
+     * Reverse the buffer.
+     */
+    get reverse() {
+        return this._reversed;
+    }
+    set reverse(rev) {
+        if (this._reversed !== rev) {
+            this._reversed = rev;
+            this._reverse();
+        }
+    }
+    /**
+     * Create a ToneAudioBuffer from the array. To create a multichannel AudioBuffer,
+     * pass in a multidimensional array.
+     * @param array The array to fill the audio buffer
+     * @return A ToneAudioBuffer created from the array
+     */
+    static fromArray(array) {
+        return (new ToneAudioBuffer()).fromArray(array);
+    }
+    /**
+     * Creates a ToneAudioBuffer from a URL, returns a promise which resolves to a ToneAudioBuffer
+     * @param  url The url to load.
+     * @return A promise which resolves to a ToneAudioBuffer
+     */
+    static fromUrl(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const buffer = new ToneAudioBuffer();
+            return yield buffer.load(url);
+        });
+    }
+    /**
+     * Loads a url using fetch and returns the AudioBuffer.
+     */
+    static load(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // test if the url contains multiple extensions
+            const matches = url.match(/\[([^\]\[]+\|.+)\]$/);
+            if (matches) {
+                const extensions = matches[1].split("|");
+                let extension = extensions[0];
+                for (const ext of extensions) {
+                    if (ToneAudioBuffer.supportsType(ext)) {
+                        extension = ext;
+                        break;
+                    }
+                }
+                url = url.replace(matches[0], extension);
+            }
+            // make sure there is a slash between the baseUrl and the url
+            const baseUrl = ToneAudioBuffer.baseUrl === "" || ToneAudioBuffer.baseUrl.endsWith("/") ? ToneAudioBuffer.baseUrl : ToneAudioBuffer.baseUrl + "/";
+            const response = yield fetch(baseUrl + url);
+            if (!response.ok) {
+                throw new Error(`could not load url: ${url}`);
+            }
+            const arrayBuffer = yield response.arrayBuffer();
+            const audioBuffer = yield getContext().decodeAudioData(arrayBuffer);
+            return audioBuffer;
+        });
+    }
+    /**
+     * Checks a url's extension to see if the current browser can play that file type.
+     * @param url The url/extension to test
+     * @return If the file extension can be played
+     * @static
+     * @example
+     * Tone.ToneAudioBuffer.supportsType("wav"); // returns true
+     * Tone.ToneAudioBuffer.supportsType("path/to/file.wav"); // returns true
+     */
+    static supportsType(url) {
+        const extensions = url.split(".");
+        const extension = extensions[extensions.length - 1];
+        const response = document.createElement("audio").canPlayType("audio/" + extension);
+        return response !== "";
+    }
+    /**
+     * Returns a Promise which resolves when all of the buffers have loaded
+     */
+    static loaded() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // this makes sure that the function is always async
+            yield Promise.resolve();
+            while (ToneAudioBuffer.downloads.length) {
+                yield ToneAudioBuffer.downloads[0];
+            }
+        });
+    }
+}
+//-------------------------------------
+// STATIC METHODS
+//-------------------------------------
+/**
+ * A path which is prefixed before every url.
+ */
+ToneAudioBuffer.baseUrl = "";
+/**
+ * All of the downloads
+ */
+ToneAudioBuffer.downloads = [];
+//# sourceMappingURL=ToneAudioBuffer.js.map

package/build/esm/core/context/ToneAudioBuffer.js.map

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

package/build/esm/core/context/ToneAudioBuffers.d.ts

@@ -0,0 +1,89 @@
+import { Tone } from "../Tone";
+import { ToneAudioBuffer } from "./ToneAudioBuffer";
+export interface ToneAudioBuffersUrlMap {
+    [name: string]: string | AudioBuffer | ToneAudioBuffer;
+    [name: number]: string | AudioBuffer | ToneAudioBuffer;
+}
+interface ToneAudioBuffersOptions {
+    urls: ToneAudioBuffersUrlMap;
+    onload: () => void;
+    onerror?: (error: Error) => void;
+    baseUrl: string;
+}
+/**
+ * A data structure for holding multiple buffers in a Map-like datastructure.
+ *
+ * @example
+ * const pianoSamples = new Tone.ToneAudioBuffers({
+ * 	A1: "https://tonejs.github.io/audio/casio/A1.mp3",
+ * 	A2: "https://tonejs.github.io/audio/casio/A2.mp3",
+ * }, () => {
+ * 	const player = new Tone.Player().toDestination();
+ * 	// play one of the samples when they all load
+ * 	player.buffer = pianoSamples.get("A2");
+ * 	player.start();
+ * });
+ * @example
+ * // To pass in additional parameters in the second parameter
+ * const buffers = new Tone.ToneAudioBuffers({
+ * 	 urls: {
+ * 		 A1: "A1.mp3",
+ * 		 A2: "A2.mp3",
+ * 	 },
+ * 	 onload: () => console.log("loaded"),
+ * 	 baseUrl: "https://tonejs.github.io/audio/casio/"
+ * });
+ * @category Core
+ */
+export declare class ToneAudioBuffers extends Tone {
+    readonly name: string;
+    /**
+     * All of the buffers
+     */
+    private _buffers;
+    /**
+     * A path which is prefixed before every url.
+     */
+    baseUrl: string;
+    /**
+     * Keep track of the number of loaded buffers
+     */
+    private _loadingCount;
+    /**
+     * @param  urls  An object literal or array of urls to load.
+     * @param onload  The callback to invoke when the buffers are loaded.
+     * @param baseUrl A prefix url to add before all the urls
+     */
+    constructor(urls?: ToneAudioBuffersUrlMap, onload?: () => void, baseUrl?: string);
+    constructor(options?: Partial<ToneAudioBuffersOptions>);
+    static getDefaults(): ToneAudioBuffersOptions;
+    /**
+     * True if the buffers object has a buffer by that name.
+     * @param  name  The key or index of the buffer.
+     */
+    has(name: string | number): boolean;
+    /**
+     * Get a buffer by name. If an array was loaded,
+     * then use the array index.
+     * @param  name  The key or index of the buffer.
+     */
+    get(name: string | number): ToneAudioBuffer;
+    /**
+     * A buffer was loaded. decrement the counter.
+     */
+    private _bufferLoaded;
+    /**
+     * If the buffers are loaded or not
+     */
+    get loaded(): boolean;
+    /**
+     * Add a buffer by name and url to the Buffers
+     * @param  name      A unique name to give the buffer
+     * @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.
+     * @param  onerror  Invoked if the buffer can't be loaded
+     */
+    add(name: string | number, url: string | AudioBuffer | ToneAudioBuffer, callback?: () => void, onerror?: (e: Error) => void): this;
+    dispose(): this;
+}
+export {};

package/build/esm/core/context/ToneAudioBuffers.js

@@ -0,0 +1,119 @@
+import { Tone } from "../Tone";
+import { optionsFromArguments } from "../util/Defaults";
+import { noOp } from "../util/Interface";
+import { isString } from "../util/TypeCheck";
+import { ToneAudioBuffer } from "./ToneAudioBuffer";
+import { assert } from "../util/Debug";
+/**
+ * A data structure for holding multiple buffers in a Map-like datastructure.
+ *
+ * @example
+ * const pianoSamples = new Tone.ToneAudioBuffers({
+ * 	A1: "https://tonejs.github.io/audio/casio/A1.mp3",
+ * 	A2: "https://tonejs.github.io/audio/casio/A2.mp3",
+ * }, () => {
+ * 	const player = new Tone.Player().toDestination();
+ * 	// play one of the samples when they all load
+ * 	player.buffer = pianoSamples.get("A2");
+ * 	player.start();
+ * });
+ * @example
+ * // To pass in additional parameters in the second parameter
+ * const buffers = new Tone.ToneAudioBuffers({
+ * 	 urls: {
+ * 		 A1: "A1.mp3",
+ * 		 A2: "A2.mp3",
+ * 	 },
+ * 	 onload: () => console.log("loaded"),
+ * 	 baseUrl: "https://tonejs.github.io/audio/casio/"
+ * });
+ * @category Core
+ */
+export class ToneAudioBuffers extends Tone {
+    constructor() {
+        super();
+        this.name = "ToneAudioBuffers";
+        /**
+         * All of the buffers
+         */
+        this._buffers = new Map();
+        /**
+         * Keep track of the number of loaded buffers
+         */
+        this._loadingCount = 0;
+        const options = optionsFromArguments(ToneAudioBuffers.getDefaults(), arguments, ["urls", "onload", "baseUrl"], "urls");
+        this.baseUrl = options.baseUrl;
+        // add each one
+        Object.keys(options.urls).forEach(name => {
+            this._loadingCount++;
+            const url = options.urls[name];
+            this.add(name, url, this._bufferLoaded.bind(this, options.onload), options.onerror);
+        });
+    }
+    static getDefaults() {
+        return {
+            baseUrl: "",
+            onerror: noOp,
+            onload: noOp,
+            urls: {},
+        };
+    }
+    /**
+     * True if the buffers object has a buffer by that name.
+     * @param  name  The key or index of the buffer.
+     */
+    has(name) {
+        return this._buffers.has(name.toString());
+    }
+    /**
+     * Get a buffer by name. If an array was loaded,
+     * then use the array index.
+     * @param  name  The key or index of the buffer.
+     */
+    get(name) {
+        assert(this.has(name), `ToneAudioBuffers has no buffer named: ${name}`);
+        return this._buffers.get(name.toString());
+    }
+    /**
+     * A buffer was loaded. decrement the counter.
+     */
+    _bufferLoaded(callback) {
+        this._loadingCount--;
+        if (this._loadingCount === 0 && callback) {
+            callback();
+        }
+    }
+    /**
+     * If the buffers are loaded or not
+     */
+    get loaded() {
+        return Array.from(this._buffers).every(([_, buffer]) => buffer.loaded);
+    }
+    /**
+     * Add a buffer by name and url to the Buffers
+     * @param  name      A unique name to give the buffer
+     * @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.
+     * @param  onerror  Invoked if the buffer can't be loaded
+     */
+    add(name, url, callback = noOp, onerror = noOp) {
+        if (isString(url)) {
+            // don't include the baseUrl if the url is a base64 encoded sound
+            if (this.baseUrl && url.trim().substring(0, 11).toLowerCase() === "data:audio/") {
+                this.baseUrl = "";
+            }
+            this._buffers.set(name.toString(), new ToneAudioBuffer(this.baseUrl + url, callback, onerror));
+        }
+        else {
+            this._buffers.set(name.toString(), new ToneAudioBuffer(url, callback, onerror));
+        }
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this._buffers.forEach(buffer => buffer.dispose());
+        this._buffers.clear();
+        return this;
+    }
+}
+//# sourceMappingURL=ToneAudioBuffers.js.map

package/build/esm/core/context/ToneAudioBuffers.js.map

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