tone 14.8.27

package/build/esm/core/clock/Clock.js

@@ -0,0 +1,251 @@
+import { ToneWithContext } from "../context/ToneWithContext";
+import { optionsFromArguments } from "../util/Defaults";
+import { Emitter } from "../util/Emitter";
+import { noOp, readOnly } from "../util/Interface";
+import { StateTimeline } from "../util/StateTimeline";
+import { TickSource } from "./TickSource";
+import { assertContextRunning } from "../util/Debug";
+/**
+ * A sample accurate clock which provides a callback at the given rate.
+ * While the callback is not sample-accurate (it is still susceptible to
+ * loose JS timing), the time passed in as the argument to the callback
+ * is precise. For most applications, it is better to use Tone.Transport
+ * instead of the Clock by itself since you can synchronize multiple callbacks.
+ * @example
+ * // the callback will be invoked approximately once a second
+ * // and will print the time exactly once a second apart.
+ * const clock = new Tone.Clock(time => {
+ * 	console.log(time);
+ * }, 1);
+ * clock.start();
+ * @category Core
+ */
+export class Clock extends ToneWithContext {
+    constructor() {
+        super(optionsFromArguments(Clock.getDefaults(), arguments, ["callback", "frequency"]));
+        this.name = "Clock";
+        /**
+         * The callback function to invoke at the scheduled tick.
+         */
+        this.callback = noOp;
+        /**
+         * The last time the loop callback was invoked
+         */
+        this._lastUpdate = 0;
+        /**
+         * Keep track of the playback state
+         */
+        this._state = new StateTimeline("stopped");
+        /**
+         * Context bound reference to the _loop method
+         * This is necessary to remove the event in the end.
+         */
+        this._boundLoop = this._loop.bind(this);
+        const options = optionsFromArguments(Clock.getDefaults(), arguments, ["callback", "frequency"]);
+        this.callback = options.callback;
+        this._tickSource = new TickSource({
+            context: this.context,
+            frequency: options.frequency,
+            units: options.units,
+        });
+        this._lastUpdate = 0;
+        this.frequency = this._tickSource.frequency;
+        readOnly(this, "frequency");
+        // add an initial state
+        this._state.setStateAtTime("stopped", 0);
+        // bind a callback to the worker thread
+        this.context.on("tick", this._boundLoop);
+    }
+    static getDefaults() {
+        return Object.assign(ToneWithContext.getDefaults(), {
+            callback: noOp,
+            frequency: 1,
+            units: "hertz",
+        });
+    }
+    /**
+     * Returns the playback state of the source, either "started", "stopped" or "paused".
+     */
+    get state() {
+        return this._state.getValueAtTime(this.now());
+    }
+    /**
+     * Start the clock at the given time. Optionally pass in an offset
+     * of where to start the tick counter from.
+     * @param  time    The time the clock should start
+     * @param offset  Where the tick counter starts counting from.
+     */
+    start(time, offset) {
+        // make sure the context is running
+        assertContextRunning(this.context);
+        // start the loop
+        const computedTime = this.toSeconds(time);
+        this.log("start", computedTime);
+        if (this._state.getValueAtTime(computedTime) !== "started") {
+            this._state.setStateAtTime("started", computedTime);
+            this._tickSource.start(computedTime, offset);
+            if (computedTime < this._lastUpdate) {
+                this.emit("start", computedTime, offset);
+            }
+        }
+        return this;
+    }
+    /**
+     * Stop the clock. Stopping the clock resets the tick counter to 0.
+     * @param time The time when the clock should stop.
+     * @example
+     * const clock = new Tone.Clock(time => {
+     * 	console.log(time);
+     * }, 1);
+     * clock.start();
+     * // stop the clock after 10 seconds
+     * clock.stop("+10");
+     */
+    stop(time) {
+        const computedTime = this.toSeconds(time);
+        this.log("stop", computedTime);
+        this._state.cancel(computedTime);
+        this._state.setStateAtTime("stopped", computedTime);
+        this._tickSource.stop(computedTime);
+        if (computedTime < this._lastUpdate) {
+            this.emit("stop", computedTime);
+        }
+        return this;
+    }
+    /**
+     * Pause the clock. Pausing does not reset the tick counter.
+     * @param time The time when the clock should stop.
+     */
+    pause(time) {
+        const computedTime = this.toSeconds(time);
+        if (this._state.getValueAtTime(computedTime) === "started") {
+            this._state.setStateAtTime("paused", computedTime);
+            this._tickSource.pause(computedTime);
+            if (computedTime < this._lastUpdate) {
+                this.emit("pause", computedTime);
+            }
+        }
+        return this;
+    }
+    /**
+     * The number of times the callback was invoked. Starts counting at 0
+     * and increments after the callback was invoked.
+     */
+    get ticks() {
+        return Math.ceil(this.getTicksAtTime(this.now()));
+    }
+    set ticks(t) {
+        this._tickSource.ticks = t;
+    }
+    /**
+     * The time since ticks=0 that the Clock has been running. Accounts for tempo curves
+     */
+    get seconds() {
+        return this._tickSource.seconds;
+    }
+    set seconds(s) {
+        this._tickSource.seconds = s;
+    }
+    /**
+     * Return the elapsed seconds at the given time.
+     * @param  time  When to get the elapsed seconds
+     * @return  The number of elapsed seconds
+     */
+    getSecondsAtTime(time) {
+        return this._tickSource.getSecondsAtTime(time);
+    }
+    /**
+     * Set the clock's ticks at the given time.
+     * @param  ticks The tick value to set
+     * @param  time  When to set the tick value
+     */
+    setTicksAtTime(ticks, time) {
+        this._tickSource.setTicksAtTime(ticks, time);
+        return this;
+    }
+    /**
+     * Get the time of the given tick. The second argument
+     * is when to test before. Since ticks can be set (with setTicksAtTime)
+     * there may be multiple times for a given tick value.
+     * @param  tick The tick number.
+     * @param  before When to measure the tick value from.
+     * @return The time of the tick
+     */
+    getTimeOfTick(tick, before = this.now()) {
+        return this._tickSource.getTimeOfTick(tick, before);
+    }
+    /**
+     * Get the clock's ticks at the given time.
+     * @param  time  When to get the tick value
+     * @return The tick value at the given time.
+     */
+    getTicksAtTime(time) {
+        return this._tickSource.getTicksAtTime(time);
+    }
+    /**
+     * Get the time of the next tick
+     * @param  offset The tick number.
+     */
+    nextTickTime(offset, when) {
+        const computedTime = this.toSeconds(when);
+        const currentTick = this.getTicksAtTime(computedTime);
+        return this._tickSource.getTimeOfTick(currentTick + offset, computedTime);
+    }
+    /**
+     * The scheduling loop.
+     */
+    _loop() {
+        const startTime = this._lastUpdate;
+        const endTime = this.now();
+        this._lastUpdate = endTime;
+        this.log("loop", startTime, endTime);
+        if (startTime !== endTime) {
+            // the state change events
+            this._state.forEachBetween(startTime, endTime, e => {
+                switch (e.state) {
+                    case "started":
+                        const offset = this._tickSource.getTicksAtTime(e.time);
+                        this.emit("start", e.time, offset);
+                        break;
+                    case "stopped":
+                        if (e.time !== 0) {
+                            this.emit("stop", e.time);
+                        }
+                        break;
+                    case "paused":
+                        this.emit("pause", e.time);
+                        break;
+                }
+            });
+            // the tick callbacks
+            this._tickSource.forEachTickBetween(startTime, endTime, (time, ticks) => {
+                this.callback(time, ticks);
+            });
+        }
+    }
+    /**
+     * Returns the scheduled state at the given time.
+     * @param  time  The time to query.
+     * @return  The name of the state input in setStateAtTime.
+     * @example
+     * const clock = new Tone.Clock();
+     * clock.start("+0.1");
+     * clock.getStateAtTime("+0.1"); // returns "started"
+     */
+    getStateAtTime(time) {
+        const computedTime = this.toSeconds(time);
+        return this._state.getValueAtTime(computedTime);
+    }
+    /**
+     * Clean up
+     */
+    dispose() {
+        super.dispose();
+        this.context.off("tick", this._boundLoop);
+        this._tickSource.dispose();
+        this._state.dispose();
+        return this;
+    }
+}
+Emitter.mixin(Clock);
+//# sourceMappingURL=Clock.js.map

package/build/esm/core/clock/Clock.js.map

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

package/build/esm/core/clock/TickParam.d.ts

@@ -0,0 +1,97 @@
+import { AutomationEvent, Param, ParamOptions } from "../context/Param";
+import { Seconds, Ticks, Time, UnitMap, UnitName } from "../type/Units";
+import { Timeline } from "../util/Timeline";
+declare type TickAutomationEvent = AutomationEvent & {
+    ticks: number;
+};
+interface TickParamOptions<TypeName extends UnitName> extends ParamOptions<TypeName> {
+    multiplier: number;
+}
+/**
+ * A Param class just for computing ticks. Similar to the [[Param]] class,
+ * but offers conversion to BPM values as well as ability to compute tick
+ * duration and elapsed ticks
+ */
+export declare class TickParam<TypeName extends "hertz" | "bpm"> extends Param<TypeName> {
+    readonly name: string;
+    /**
+     * The timeline which tracks all of the automations.
+     */
+    protected _events: Timeline<TickAutomationEvent>;
+    /**
+     * The internal holder for the multiplier value
+     */
+    private _multiplier;
+    /**
+     * @param param The AudioParam to wrap
+     * @param units The unit name
+     * @param convert Whether or not to convert the value to the target units
+     */
+    /**
+     * @param value The initial value of the signal
+     */
+    constructor(value?: number);
+    constructor(options: Partial<TickParamOptions<TypeName>>);
+    static getDefaults(): TickParamOptions<any>;
+    setTargetAtTime(value: UnitMap[TypeName], time: Time, constant: number): this;
+    setValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    linearRampToValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    exponentialRampToValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    /**
+     * Returns the tick value at the time. Takes into account
+     * any automation curves scheduled on the signal.
+     * @param  event The time to get the tick count at
+     * @return The number of ticks which have elapsed at the time given any automations.
+     */
+    private _getTicksUntilEvent;
+    /**
+     * Returns the tick value at the time. Takes into account
+     * any automation curves scheduled on the signal.
+     * @param  time The time to get the tick count at
+     * @return The number of ticks which have elapsed at the time given any automations.
+     */
+    getTicksAtTime(time: Time): Ticks;
+    /**
+     * Return the elapsed time of the number of ticks from the given time
+     * @param ticks The number of ticks to calculate
+     * @param  time The time to get the next tick from
+     * @return The duration of the number of ticks from the given time in seconds
+     */
+    getDurationOfTicks(ticks: Ticks, time: Time): Seconds;
+    /**
+     * Given a tick, returns the time that tick occurs at.
+     * @return The time that the tick occurs.
+     */
+    getTimeOfTick(tick: Ticks): Seconds;
+    /**
+     * Convert some number of ticks their the duration in seconds accounting
+     * for any automation curves starting at the given time.
+     * @param  ticks The number of ticks to convert to seconds.
+     * @param  when  When along the automation timeline to convert the ticks.
+     * @return The duration in seconds of the ticks.
+     */
+    ticksToTime(ticks: Ticks, when: Time): Seconds;
+    /**
+     * The inverse of [[ticksToTime]]. Convert a duration in
+     * seconds to the corresponding number of ticks accounting for any
+     * automation curves starting at the given time.
+     * @param  duration The time interval to convert to ticks.
+     * @param  when When along the automation timeline to convert the ticks.
+     * @return The duration in ticks.
+     */
+    timeToTicks(duration: Time, when: Time): Ticks;
+    /**
+     * Convert from the type when the unit value is BPM
+     */
+    protected _fromType(val: UnitMap[TypeName]): number;
+    /**
+     * Special case of type conversion where the units === "bpm"
+     */
+    protected _toType(val: number): UnitMap[TypeName];
+    /**
+     * A multiplier on the bpm value. Useful for setting a PPQ relative to the base frequency value.
+     */
+    get multiplier(): number;
+    set multiplier(m: number);
+}
+export {};

package/build/esm/core/clock/TickParam.js

@@ -0,0 +1,237 @@
+import { Param } from "../context/Param";
+import { optionsFromArguments } from "../util/Defaults";
+import { Timeline } from "../util/Timeline";
+import { isUndef } from "../util/TypeCheck";
+/**
+ * A Param class just for computing ticks. Similar to the [[Param]] class,
+ * but offers conversion to BPM values as well as ability to compute tick
+ * duration and elapsed ticks
+ */
+export class TickParam extends Param {
+    constructor() {
+        super(optionsFromArguments(TickParam.getDefaults(), arguments, ["value"]));
+        this.name = "TickParam";
+        /**
+         * The timeline which tracks all of the automations.
+         */
+        this._events = new Timeline(Infinity);
+        /**
+         * The internal holder for the multiplier value
+         */
+        this._multiplier = 1;
+        const options = optionsFromArguments(TickParam.getDefaults(), arguments, ["value"]);
+        // set the multiplier
+        this._multiplier = options.multiplier;
+        // clear the ticks from the beginning
+        this._events.cancel(0);
+        // set an initial event
+        this._events.add({
+            ticks: 0,
+            time: 0,
+            type: "setValueAtTime",
+            value: this._fromType(options.value),
+        });
+        this.setValueAtTime(options.value, 0);
+    }
+    static getDefaults() {
+        return Object.assign(Param.getDefaults(), {
+            multiplier: 1,
+            units: "hertz",
+            value: 1,
+        });
+    }
+    setTargetAtTime(value, time, constant) {
+        // approximate it with multiple linear ramps
+        time = this.toSeconds(time);
+        this.setRampPoint(time);
+        const computedValue = this._fromType(value);
+        // start from previously scheduled value
+        const prevEvent = this._events.get(time);
+        const segments = Math.round(Math.max(1 / constant, 1));
+        for (let i = 0; i <= segments; i++) {
+            const segTime = constant * i + time;
+            const rampVal = this._exponentialApproach(prevEvent.time, prevEvent.value, computedValue, constant, segTime);
+            this.linearRampToValueAtTime(this._toType(rampVal), segTime);
+        }
+        return this;
+    }
+    setValueAtTime(value, time) {
+        const computedTime = this.toSeconds(time);
+        super.setValueAtTime(value, time);
+        const event = this._events.get(computedTime);
+        const previousEvent = this._events.previousEvent(event);
+        const ticksUntilTime = this._getTicksUntilEvent(previousEvent, computedTime);
+        event.ticks = Math.max(ticksUntilTime, 0);
+        return this;
+    }
+    linearRampToValueAtTime(value, time) {
+        const computedTime = this.toSeconds(time);
+        super.linearRampToValueAtTime(value, time);
+        const event = this._events.get(computedTime);
+        const previousEvent = this._events.previousEvent(event);
+        const ticksUntilTime = this._getTicksUntilEvent(previousEvent, computedTime);
+        event.ticks = Math.max(ticksUntilTime, 0);
+        return this;
+    }
+    exponentialRampToValueAtTime(value, time) {
+        // aproximate it with multiple linear ramps
+        time = this.toSeconds(time);
+        const computedVal = this._fromType(value);
+        // start from previously scheduled value
+        const prevEvent = this._events.get(time);
+        // approx 10 segments per second
+        const segments = Math.round(Math.max((time - prevEvent.time) * 10, 1));
+        const segmentDur = ((time - prevEvent.time) / segments);
+        for (let i = 0; i <= segments; i++) {
+            const segTime = segmentDur * i + prevEvent.time;
+            const rampVal = this._exponentialInterpolate(prevEvent.time, prevEvent.value, time, computedVal, segTime);
+            this.linearRampToValueAtTime(this._toType(rampVal), segTime);
+        }
+        return this;
+    }
+    /**
+     * Returns the tick value at the time. Takes into account
+     * any automation curves scheduled on the signal.
+     * @param  event The time to get the tick count at
+     * @return The number of ticks which have elapsed at the time given any automations.
+     */
+    _getTicksUntilEvent(event, time) {
+        if (event === null) {
+            event = {
+                ticks: 0,
+                time: 0,
+                type: "setValueAtTime",
+                value: 0,
+            };
+        }
+        else if (isUndef(event.ticks)) {
+            const previousEvent = this._events.previousEvent(event);
+            event.ticks = this._getTicksUntilEvent(previousEvent, event.time);
+        }
+        const val0 = this._fromType(this.getValueAtTime(event.time));
+        let val1 = this._fromType(this.getValueAtTime(time));
+        // if it's right on the line, take the previous value
+        const onTheLineEvent = this._events.get(time);
+        if (onTheLineEvent && onTheLineEvent.time === time && onTheLineEvent.type === "setValueAtTime") {
+            val1 = this._fromType(this.getValueAtTime(time - this.sampleTime));
+        }
+        return 0.5 * (time - event.time) * (val0 + val1) + event.ticks;
+    }
+    /**
+     * Returns the tick value at the time. Takes into account
+     * any automation curves scheduled on the signal.
+     * @param  time The time to get the tick count at
+     * @return The number of ticks which have elapsed at the time given any automations.
+     */
+    getTicksAtTime(time) {
+        const computedTime = this.toSeconds(time);
+        const event = this._events.get(computedTime);
+        return Math.max(this._getTicksUntilEvent(event, computedTime), 0);
+    }
+    /**
+     * Return the elapsed time of the number of ticks from the given time
+     * @param ticks The number of ticks to calculate
+     * @param  time The time to get the next tick from
+     * @return The duration of the number of ticks from the given time in seconds
+     */
+    getDurationOfTicks(ticks, time) {
+        const computedTime = this.toSeconds(time);
+        const currentTick = this.getTicksAtTime(time);
+        return this.getTimeOfTick(currentTick + ticks) - computedTime;
+    }
+    /**
+     * Given a tick, returns the time that tick occurs at.
+     * @return The time that the tick occurs.
+     */
+    getTimeOfTick(tick) {
+        const before = this._events.get(tick, "ticks");
+        const after = this._events.getAfter(tick, "ticks");
+        if (before && before.ticks === tick) {
+            return before.time;
+        }
+        else if (before && after &&
+            after.type === "linearRampToValueAtTime" &&
+            before.value !== after.value) {
+            const val0 = this._fromType(this.getValueAtTime(before.time));
+            const val1 = this._fromType(this.getValueAtTime(after.time));
+            const delta = (val1 - val0) / (after.time - before.time);
+            const k = Math.sqrt(Math.pow(val0, 2) - 2 * delta * (before.ticks - tick));
+            const sol1 = (-val0 + k) / delta;
+            const sol2 = (-val0 - k) / delta;
+            return (sol1 > 0 ? sol1 : sol2) + before.time;
+        }
+        else if (before) {
+            if (before.value === 0) {
+                return Infinity;
+            }
+            else {
+                return before.time + (tick - before.ticks) / before.value;
+            }
+        }
+        else {
+            return tick / this._initialValue;
+        }
+    }
+    /**
+     * Convert some number of ticks their the duration in seconds accounting
+     * for any automation curves starting at the given time.
+     * @param  ticks The number of ticks to convert to seconds.
+     * @param  when  When along the automation timeline to convert the ticks.
+     * @return The duration in seconds of the ticks.
+     */
+    ticksToTime(ticks, when) {
+        return this.getDurationOfTicks(ticks, when);
+    }
+    /**
+     * The inverse of [[ticksToTime]]. Convert a duration in
+     * seconds to the corresponding number of ticks accounting for any
+     * automation curves starting at the given time.
+     * @param  duration The time interval to convert to ticks.
+     * @param  when When along the automation timeline to convert the ticks.
+     * @return The duration in ticks.
+     */
+    timeToTicks(duration, when) {
+        const computedTime = this.toSeconds(when);
+        const computedDuration = this.toSeconds(duration);
+        const startTicks = this.getTicksAtTime(computedTime);
+        const endTicks = this.getTicksAtTime(computedTime + computedDuration);
+        return endTicks - startTicks;
+    }
+    /**
+     * Convert from the type when the unit value is BPM
+     */
+    _fromType(val) {
+        if (this.units === "bpm" && this.multiplier) {
+            return 1 / (60 / val / this.multiplier);
+        }
+        else {
+            return super._fromType(val);
+        }
+    }
+    /**
+     * Special case of type conversion where the units === "bpm"
+     */
+    _toType(val) {
+        if (this.units === "bpm" && this.multiplier) {
+            return (val / this.multiplier) * 60;
+        }
+        else {
+            return super._toType(val);
+        }
+    }
+    /**
+     * A multiplier on the bpm value. Useful for setting a PPQ relative to the base frequency value.
+     */
+    get multiplier() {
+        return this._multiplier;
+    }
+    set multiplier(m) {
+        // get and reset the current value with the new multiplier
+        // might be necessary to clear all the previous values
+        const currentVal = this.value;
+        this._multiplier = m;
+        this.cancelScheduledValues(0);
+        this.setValueAtTime(currentVal, 0);
+    }
+}
+//# sourceMappingURL=TickParam.js.map

package/build/esm/core/clock/TickParam.js.map

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

package/build/esm/core/clock/TickSignal.d.ts

@@ -0,0 +1,43 @@
+import { Signal, SignalOptions } from "../../signal/Signal";
+import { InputNode } from "../context/ToneAudioNode";
+import { Seconds, Ticks, Time, UnitMap, UnitName } from "../type/Units";
+import { TickParam } from "./TickParam";
+interface TickSignalOptions<TypeName extends UnitName> extends SignalOptions<TypeName> {
+    value: UnitMap[TypeName];
+    multiplier: number;
+}
+/**
+ * TickSignal extends Tone.Signal, but adds the capability
+ * to calculate the number of elapsed ticks. exponential and target curves
+ * are approximated with multiple linear ramps.
+ *
+ * Thank you Bruno Dias, H. Sofia Pinto, and David M. Matos,
+ * for your [WAC paper](https://smartech.gatech.edu/bitstream/handle/1853/54588/WAC2016-49.pdf)
+ * describing integrating timing functions for tempo calculations.
+ */
+export declare class TickSignal<TypeName extends "hertz" | "bpm"> extends Signal<TypeName> {
+    readonly name: string;
+    /**
+     * The param which controls the output signal value
+     */
+    protected _param: TickParam<TypeName>;
+    readonly input: InputNode;
+    /**
+     * @param value The initial value of the signal
+     */
+    constructor(value?: UnitMap[TypeName]);
+    constructor(options: Partial<TickSignalOptions<TypeName>>);
+    static getDefaults(): TickSignalOptions<any>;
+    ticksToTime(ticks: Ticks, when: Time): Seconds;
+    timeToTicks(duration: Time, when: Time): Ticks;
+    getTimeOfTick(tick: Ticks): Seconds;
+    getDurationOfTicks(ticks: Ticks, time: Time): Seconds;
+    getTicksAtTime(time: Time): Ticks;
+    /**
+     * A multiplier on the bpm value. Useful for setting a PPQ relative to the base frequency value.
+     */
+    get multiplier(): number;
+    set multiplier(m: number);
+    dispose(): this;
+}
+export {};