tone 14.8.27

package/build/esm/source/UserMedia.js

@@ -0,0 +1,214 @@
+import { __awaiter } from "tslib";
+import { connect, ToneAudioNode } from "../core/context/ToneAudioNode";
+import { Volume } from "../component/channel/Volume";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { assert } from "../core/util/Debug";
+import { readOnly } from "../core/util/Interface";
+import { isDefined, isNumber } from "../core/util/TypeCheck";
+/**
+ * UserMedia uses MediaDevices.getUserMedia to open up and external microphone or audio input.
+ * Check [MediaDevices API Support](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia)
+ * to see which browsers are supported. Access to an external input
+ * is limited to secure (HTTPS) connections.
+ * @example
+ * const meter = new Tone.Meter();
+ * const mic = new Tone.UserMedia().connect(meter);
+ * mic.open().then(() => {
+ * 	// promise resolves when input is available
+ * 	console.log("mic open");
+ * 	// print the incoming mic levels in decibels
+ * 	setInterval(() => console.log(meter.getValue()), 100);
+ * }).catch(e => {
+ * 	// promise is rejected when the user doesn't have or allow mic access
+ * 	console.log("mic not open");
+ * });
+ * @category Source
+ */
+export class UserMedia extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(UserMedia.getDefaults(), arguments, ["volume"]));
+        this.name = "UserMedia";
+        const options = optionsFromArguments(UserMedia.getDefaults(), arguments, ["volume"]);
+        this._volume = this.output = new Volume({
+            context: this.context,
+            volume: options.volume,
+        });
+        this.volume = this._volume.volume;
+        readOnly(this, "volume");
+        this.mute = options.mute;
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            mute: false,
+            volume: 0
+        });
+    }
+    /**
+     * Open the media stream. If a string is passed in, it is assumed
+     * to be the label or id of the stream, if a number is passed in,
+     * it is the input number of the stream.
+     * @param  labelOrId The label or id of the audio input media device.
+     *                   With no argument, the default stream is opened.
+     * @return The promise is resolved when the stream is open.
+     */
+    open(labelOrId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            assert(UserMedia.supported, "UserMedia is not supported");
+            // close the previous stream
+            if (this.state === "started") {
+                this.close();
+            }
+            const devices = yield UserMedia.enumerateDevices();
+            if (isNumber(labelOrId)) {
+                this._device = devices[labelOrId];
+            }
+            else {
+                this._device = devices.find((device) => {
+                    return device.label === labelOrId || device.deviceId === labelOrId;
+                });
+                // didn't find a matching device
+                if (!this._device && devices.length > 0) {
+                    this._device = devices[0];
+                }
+                assert(isDefined(this._device), `No matching device ${labelOrId}`);
+            }
+            // do getUserMedia
+            const constraints = {
+                audio: {
+                    echoCancellation: false,
+                    sampleRate: this.context.sampleRate,
+                    noiseSuppression: false,
+                    mozNoiseSuppression: false,
+                }
+            };
+            if (this._device) {
+                // @ts-ignore
+                constraints.audio.deviceId = this._device.deviceId;
+            }
+            const stream = yield navigator.mediaDevices.getUserMedia(constraints);
+            // start a new source only if the previous one is closed
+            if (!this._stream) {
+                this._stream = stream;
+                // Wrap a MediaStreamSourceNode around the live input stream.
+                const mediaStreamNode = this.context.createMediaStreamSource(stream);
+                // Connect the MediaStreamSourceNode to a gate gain node
+                connect(mediaStreamNode, this.output);
+                this._mediaStream = mediaStreamNode;
+            }
+            return this;
+        });
+    }
+    /**
+     * Close the media stream
+     */
+    close() {
+        if (this._stream && this._mediaStream) {
+            this._stream.getAudioTracks().forEach((track) => {
+                track.stop();
+            });
+            this._stream = undefined;
+            // remove the old media stream
+            this._mediaStream.disconnect();
+            this._mediaStream = undefined;
+        }
+        this._device = undefined;
+        return this;
+    }
+    /**
+     * Returns a promise which resolves with the list of audio input devices available.
+     * @return The promise that is resolved with the devices
+     * @example
+     * Tone.UserMedia.enumerateDevices().then((devices) => {
+     * 	// print the device labels
+     * 	console.log(devices.map(device => device.label));
+     * });
+     */
+    static enumerateDevices() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const allDevices = yield navigator.mediaDevices.enumerateDevices();
+            return allDevices.filter(device => {
+                return device.kind === "audioinput";
+            });
+        });
+    }
+    /**
+     * Returns the playback state of the source, "started" when the microphone is open
+     * and "stopped" when the mic is closed.
+     */
+    get state() {
+        return this._stream && this._stream.active ? "started" : "stopped";
+    }
+    /**
+     * Returns an identifier for the represented device that is
+     * persisted across sessions. It is un-guessable by other applications and
+     * unique to the origin of the calling application. It is reset when the
+     * user clears cookies (for Private Browsing, a different identifier is
+     * used that is not persisted across sessions). Returns undefined when the
+     * device is not open.
+     */
+    get deviceId() {
+        if (this._device) {
+            return this._device.deviceId;
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Returns a group identifier. Two devices have the
+     * same group identifier if they belong to the same physical device.
+     * Returns null  when the device is not open.
+     */
+    get groupId() {
+        if (this._device) {
+            return this._device.groupId;
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Returns a label describing this device (for example "Built-in Microphone").
+     * Returns undefined when the device is not open or label is not available
+     * because of permissions.
+     */
+    get label() {
+        if (this._device) {
+            return this._device.label;
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Mute the output.
+     * @example
+     * const mic = new Tone.UserMedia();
+     * mic.open().then(() => {
+     * 	// promise resolves when input is available
+     * });
+     * // mute the output
+     * mic.mute = true;
+     */
+    get mute() {
+        return this._volume.mute;
+    }
+    set mute(mute) {
+        this._volume.mute = mute;
+    }
+    dispose() {
+        super.dispose();
+        this.close();
+        this._volume.dispose();
+        this.volume.dispose();
+        return this;
+    }
+    /**
+     * If getUserMedia is supported by the browser.
+     */
+    static get supported() {
+        return isDefined(navigator.mediaDevices) &&
+            isDefined(navigator.mediaDevices.getUserMedia);
+    }
+}
+//# sourceMappingURL=UserMedia.js.map

package/build/esm/source/UserMedia.js.map

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

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

@@ -0,0 +1,135 @@
+import { Source, SourceOptions } from "../Source";
+import { ToneAudioBuffer } from "../../core/context/ToneAudioBuffer";
+import { Cents, Positive, Seconds, Time } from "../../core/type/Units";
+interface GrainPlayerOptions extends SourceOptions {
+    onload: () => void;
+    onerror: (error: Error) => void;
+    reverse: boolean;
+    url?: ToneAudioBuffer | string | AudioBuffer;
+    overlap: Seconds;
+    grainSize: Seconds;
+    playbackRate: Positive;
+    detune: Cents;
+    loop: boolean;
+    loopStart: Time;
+    loopEnd: Time;
+}
+/**
+ * GrainPlayer implements [granular synthesis](https://en.wikipedia.org/wiki/Granular_synthesis).
+ * Granular Synthesis enables you to adjust pitch and playback rate independently. The grainSize is the
+ * amount of time each small chunk of audio is played for and the overlap is the
+ * amount of crossfading transition time between successive grains.
+ * @category Source
+ */
+export declare class GrainPlayer extends Source<GrainPlayerOptions> {
+    readonly name: string;
+    /**
+     * The audio buffer belonging to the player.
+     */
+    buffer: ToneAudioBuffer;
+    /**
+     * Create a repeating tick to schedule the grains.
+     */
+    private _clock;
+    /**
+     * Internal loopStart value
+     */
+    private _loopStart;
+    /**
+     * Internal loopStart value
+     */
+    private _loopEnd;
+    /**
+     * All of the currently playing BufferSources
+     */
+    private _activeSources;
+    /**
+     * Internal reference to the playback rate
+     */
+    private _playbackRate;
+    /**
+     * Internal grain size reference;
+     */
+    private _grainSize;
+    /**
+     * Internal overlap reference;
+     */
+    private _overlap;
+    /**
+     * Adjust the pitch independently of the playbackRate.
+     */
+    detune: Cents;
+    /**
+     * If the buffer should loop back to the loopStart when completed
+     */
+    loop: boolean;
+    /**
+     * @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<GrainPlayerOptions>);
+    static getDefaults(): GrainPlayerOptions;
+    /**
+     * Internal start method
+     */
+    protected _start(time?: Time, offset?: Time, duration?: 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;
+    /**
+     * Internal stop method
+     */
+    protected _stop(time?: Time): void;
+    /**
+     * Invoked when the clock is stopped
+     */
+    private _onstop;
+    /**
+     * Invoked on each clock tick. scheduled a new grain at this time.
+     */
+    private _tick;
+    /**
+     * The playback rate of the sample
+     */
+    get playbackRate(): Positive;
+    set playbackRate(rate: Positive);
+    /**
+     * The loop start time.
+     */
+    get loopStart(): Time;
+    set loopStart(time: Time);
+    /**
+     * The loop end time.
+     */
+    get loopEnd(): Time;
+    set loopEnd(time: Time);
+    /**
+     * The direction the buffer should play in
+     */
+    get reverse(): boolean;
+    set reverse(rev: boolean);
+    /**
+     * The size of each chunk of audio that the
+     * buffer is chopped into and played back at.
+     */
+    get grainSize(): Time;
+    set grainSize(size: Time);
+    /**
+     * The duration of the cross-fade between successive grains.
+     */
+    get overlap(): Time;
+    set overlap(time: Time);
+    /**
+     * If all the buffer is loaded
+     */
+    get loaded(): boolean;
+    dispose(): this;
+}
+export {};

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

@@ -0,0 +1,235 @@
+import { Source } from "../Source";
+import { noOp } from "../../core/util/Interface";
+import { ToneAudioBuffer } from "../../core/context/ToneAudioBuffer";
+import { defaultArg, optionsFromArguments } from "../../core/util/Defaults";
+import { Clock } from "../../core/clock/Clock";
+import { ToneBufferSource } from "./ToneBufferSource";
+import { intervalToFrequencyRatio } from "../../core/type/Conversions";
+import { assertRange } from "../../core/util/Debug";
+/**
+ * GrainPlayer implements [granular synthesis](https://en.wikipedia.org/wiki/Granular_synthesis).
+ * Granular Synthesis enables you to adjust pitch and playback rate independently. The grainSize is the
+ * amount of time each small chunk of audio is played for and the overlap is the
+ * amount of crossfading transition time between successive grains.
+ * @category Source
+ */
+export class GrainPlayer extends Source {
+    constructor() {
+        super(optionsFromArguments(GrainPlayer.getDefaults(), arguments, ["url", "onload"]));
+        this.name = "GrainPlayer";
+        /**
+         * Internal loopStart value
+         */
+        this._loopStart = 0;
+        /**
+         * Internal loopStart value
+         */
+        this._loopEnd = 0;
+        /**
+         * All of the currently playing BufferSources
+         */
+        this._activeSources = [];
+        const options = optionsFromArguments(GrainPlayer.getDefaults(), arguments, ["url", "onload"]);
+        this.buffer = new ToneAudioBuffer({
+            onload: options.onload,
+            onerror: options.onerror,
+            reverse: options.reverse,
+            url: options.url,
+        });
+        this._clock = new Clock({
+            context: this.context,
+            callback: this._tick.bind(this),
+            frequency: 1 / options.grainSize
+        });
+        this._playbackRate = options.playbackRate;
+        this._grainSize = options.grainSize;
+        this._overlap = options.overlap;
+        this.detune = options.detune;
+        // setup
+        this.overlap = options.overlap;
+        this.loop = options.loop;
+        this.playbackRate = options.playbackRate;
+        this.grainSize = options.grainSize;
+        this.loopStart = options.loopStart;
+        this.loopEnd = options.loopEnd;
+        this.reverse = options.reverse;
+        this._clock.on("stop", this._onstop.bind(this));
+    }
+    static getDefaults() {
+        return Object.assign(Source.getDefaults(), {
+            onload: noOp,
+            onerror: noOp,
+            overlap: 0.1,
+            grainSize: 0.2,
+            playbackRate: 1,
+            detune: 0,
+            loop: false,
+            loopStart: 0,
+            loopEnd: 0,
+            reverse: false
+        });
+    }
+    /**
+     * Internal start method
+     */
+    _start(time, offset, duration) {
+        offset = defaultArg(offset, 0);
+        offset = this.toSeconds(offset);
+        time = this.toSeconds(time);
+        const grainSize = 1 / this._clock.frequency.getValueAtTime(time);
+        this._clock.start(time, offset / grainSize);
+        if (duration) {
+            this.stop(time + this.toSeconds(duration));
+        }
+    }
+    /**
+     * 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);
+    }
+    /**
+     * Internal stop method
+     */
+    _stop(time) {
+        this._clock.stop(time);
+    }
+    /**
+     * Invoked when the clock is stopped
+     */
+    _onstop(time) {
+        // stop the players
+        this._activeSources.forEach((source) => {
+            source.fadeOut = 0;
+            source.stop(time);
+        });
+        this.onstop(this);
+    }
+    /**
+     * Invoked on each clock tick. scheduled a new grain at this time.
+     */
+    _tick(time) {
+        // check if it should stop looping
+        const ticks = this._clock.getTicksAtTime(time);
+        const offset = ticks * this._grainSize;
+        this.log("offset", offset);
+        if (!this.loop && offset > this.buffer.duration) {
+            this.stop(time);
+            return;
+        }
+        // at the beginning of the file, the fade in should be 0
+        const fadeIn = offset < this._overlap ? 0 : this._overlap;
+        // create a buffer source
+        const source = new ToneBufferSource({
+            context: this.context,
+            url: this.buffer,
+            fadeIn: fadeIn,
+            fadeOut: this._overlap,
+            loop: this.loop,
+            loopStart: this._loopStart,
+            loopEnd: this._loopEnd,
+            // compute the playbackRate based on the detune
+            playbackRate: intervalToFrequencyRatio(this.detune / 100)
+        }).connect(this.output);
+        source.start(time, this._grainSize * ticks);
+        source.stop(time + this._grainSize / this.playbackRate);
+        // add it to the active sources
+        this._activeSources.push(source);
+        // remove it when it's done
+        source.onended = () => {
+            const index = this._activeSources.indexOf(source);
+            if (index !== -1) {
+                this._activeSources.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * The playback rate of the sample
+     */
+    get playbackRate() {
+        return this._playbackRate;
+    }
+    set playbackRate(rate) {
+        assertRange(rate, 0.001);
+        this._playbackRate = rate;
+        this.grainSize = this._grainSize;
+    }
+    /**
+     * The loop start time.
+     */
+    get loopStart() {
+        return this._loopStart;
+    }
+    set loopStart(time) {
+        if (this.buffer.loaded) {
+            assertRange(this.toSeconds(time), 0, this.buffer.duration);
+        }
+        this._loopStart = this.toSeconds(time);
+    }
+    /**
+     * The loop end time.
+     */
+    get loopEnd() {
+        return this._loopEnd;
+    }
+    set loopEnd(time) {
+        if (this.buffer.loaded) {
+            assertRange(this.toSeconds(time), 0, this.buffer.duration);
+        }
+        this._loopEnd = this.toSeconds(time);
+    }
+    /**
+     * The direction the buffer should play in
+     */
+    get reverse() {
+        return this.buffer.reverse;
+    }
+    set reverse(rev) {
+        this.buffer.reverse = rev;
+    }
+    /**
+     * The size of each chunk of audio that the
+     * buffer is chopped into and played back at.
+     */
+    get grainSize() {
+        return this._grainSize;
+    }
+    set grainSize(size) {
+        this._grainSize = this.toSeconds(size);
+        this._clock.frequency.setValueAtTime(this._playbackRate / this._grainSize, this.now());
+    }
+    /**
+     * The duration of the cross-fade between successive grains.
+     */
+    get overlap() {
+        return this._overlap;
+    }
+    set overlap(time) {
+        const computedTime = this.toSeconds(time);
+        assertRange(computedTime, 0);
+        this._overlap = computedTime;
+    }
+    /**
+     * If all the buffer is loaded
+     */
+    get loaded() {
+        return this.buffer.loaded;
+    }
+    dispose() {
+        super.dispose();
+        this.buffer.dispose();
+        this._clock.dispose();
+        this._activeSources.forEach((source) => source.dispose());
+        return this;
+    }
+}
+//# sourceMappingURL=GrainPlayer.js.map

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

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