tone 14.8.27

package/build/esm/source/oscillator/OmniOscillator.d.ts

@@ -0,0 +1,162 @@
+import { Cents, Degrees, Frequency, Seconds, Time } from "../../core/type/Units";
+import { Signal } from "../../signal/Signal";
+import { Source } from "../Source";
+import { AMOscillator } from "./AMOscillator";
+import { FatOscillator } from "./FatOscillator";
+import { FMOscillator } from "./FMOscillator";
+import { Oscillator } from "./Oscillator";
+import { OmniOscillatorOptions, OmniOscillatorType, ToneOscillatorInterface, ToneOscillatorType } from "./OscillatorInterface";
+import { PulseOscillator } from "./PulseOscillator";
+import { PWMOscillator } from "./PWMOscillator";
+export { OmniOscillatorOptions } from "./OscillatorInterface";
+/**
+ * All of the oscillator types that OmniOscillator can take on
+ */
+declare type AnyOscillator = Oscillator | PWMOscillator | PulseOscillator | FatOscillator | AMOscillator | FMOscillator;
+/**
+ * All of the Oscillator constructor types mapped to their name.
+ */
+interface OmniOscillatorSource {
+    "fm": FMOscillator;
+    "am": AMOscillator;
+    "pwm": PWMOscillator;
+    "pulse": PulseOscillator;
+    "oscillator": Oscillator;
+    "fat": FatOscillator;
+}
+/**
+ * The available oscillator types.
+ */
+export declare type OmniOscSourceType = keyof OmniOscillatorSource;
+declare type IsAmOrFmOscillator<Osc, Ret> = Osc extends AMOscillator ? Ret : Osc extends FMOscillator ? Ret : undefined;
+declare type IsFatOscillator<Osc, Ret> = Osc extends FatOscillator ? Ret : undefined;
+declare type IsPWMOscillator<Osc, Ret> = Osc extends PWMOscillator ? Ret : undefined;
+declare type IsPulseOscillator<Osc, Ret> = Osc extends PulseOscillator ? Ret : undefined;
+declare type IsFMOscillator<Osc, Ret> = Osc extends FMOscillator ? Ret : undefined;
+/**
+ * OmniOscillator aggregates all of the oscillator types into one.
+ * @example
+ * return Tone.Offline(() => {
+ * 	const omniOsc = new Tone.OmniOscillator("C#4", "pwm").toDestination().start();
+ * }, 0.1, 1);
+ * @category Source
+ */
+export declare class OmniOscillator<OscType extends AnyOscillator> extends Source<OmniOscillatorOptions> implements Omit<ToneOscillatorInterface, "type"> {
+    readonly name: string;
+    readonly frequency: Signal<"frequency">;
+    readonly detune: Signal<"cents">;
+    /**
+     * The oscillator that can switch types
+     */
+    private _oscillator;
+    /**
+     * the type of the oscillator source
+     */
+    private _sourceType;
+    /**
+     * @param frequency The initial frequency of the oscillator.
+     * @param type The type of the oscillator.
+     */
+    constructor(frequency?: Frequency, type?: OmniOscillatorType);
+    constructor(options?: Partial<OmniOscillatorOptions>);
+    static getDefaults(): OmniOscillatorOptions;
+    /**
+     * start the oscillator
+     */
+    protected _start(time: Time): void;
+    /**
+     * start the oscillator
+     */
+    protected _stop(time: Time): void;
+    protected _restart(time: Seconds): this;
+    /**
+     * The type of the oscillator. Can be any of the basic types: sine, square, triangle, sawtooth. Or
+     * prefix the basic types with "fm", "am", or "fat" to use the FMOscillator, AMOscillator or FatOscillator
+     * types. The oscillator could also be set to "pwm" or "pulse". All of the parameters of the
+     * oscillator's class are accessible when the oscillator is set to that type, but throws an error
+     * when it's not.
+     * @example
+     * const omniOsc = new Tone.OmniOscillator().toDestination().start();
+     * omniOsc.type = "pwm";
+     * // modulationFrequency is parameter which is available
+     * // only when the type is "pwm".
+     * omniOsc.modulationFrequency.value = 0.5;
+     */
+    get type(): OmniOscillatorType;
+    set type(type: OmniOscillatorType);
+    /**
+     * The value is an empty array when the type is not "custom".
+     * This is not available on "pwm" and "pulse" oscillator types.
+     * See [[Oscillator.partials]]
+     */
+    get partials(): number[];
+    set partials(partials: number[]);
+    get partialCount(): number;
+    set partialCount(partialCount: number);
+    set(props: Partial<OmniOscillatorOptions>): this;
+    /**
+     * connect the oscillator to the frequency and detune signals
+     */
+    private _createNewOscillator;
+    get phase(): Degrees;
+    set phase(phase: Degrees);
+    /**
+     * The source type of the oscillator.
+     * @example
+     * const omniOsc = new Tone.OmniOscillator(440, "fmsquare");
+     * console.log(omniOsc.sourceType); // 'fm'
+     */
+    get sourceType(): OmniOscSourceType;
+    set sourceType(sType: OmniOscSourceType);
+    private _getOscType;
+    /**
+     * The base type of the oscillator. See [[Oscillator.baseType]]
+     * @example
+     * const omniOsc = new Tone.OmniOscillator(440, "fmsquare4");
+     * console.log(omniOsc.sourceType, omniOsc.baseType, omniOsc.partialCount);
+     */
+    get baseType(): OscillatorType | "pwm" | "pulse";
+    set baseType(baseType: OscillatorType | "pwm" | "pulse");
+    /**
+     * The width of the oscillator when sourceType === "pulse".
+     * See [[PWMOscillator.width]]
+     */
+    get width(): IsPulseOscillator<OscType, Signal<"audioRange">>;
+    /**
+     * The number of detuned oscillators when sourceType === "fat".
+     * See [[FatOscillator.count]]
+     */
+    get count(): IsFatOscillator<OscType, number>;
+    set count(count: IsFatOscillator<OscType, number>);
+    /**
+     * The detune spread between the oscillators when sourceType === "fat".
+     * See [[FatOscillator.count]]
+     */
+    get spread(): IsFatOscillator<OscType, Cents>;
+    set spread(spread: IsFatOscillator<OscType, Cents>);
+    /**
+     * The type of the modulator oscillator. Only if the oscillator is set to "am" or "fm" types.
+     * See [[AMOscillator]] or [[FMOscillator]]
+     */
+    get modulationType(): IsAmOrFmOscillator<OscType, ToneOscillatorType>;
+    set modulationType(mType: IsAmOrFmOscillator<OscType, ToneOscillatorType>);
+    /**
+     * The modulation index when the sourceType === "fm"
+     * See [[FMOscillator]].
+     */
+    get modulationIndex(): IsFMOscillator<OscType, Signal<"positive">>;
+    /**
+     * Harmonicity is the frequency ratio between the carrier and the modulator oscillators.
+     * See [[AMOscillator]] or [[FMOscillator]]
+     */
+    get harmonicity(): IsAmOrFmOscillator<OscType, Signal<"positive">>;
+    /**
+     * The modulationFrequency Signal of the oscillator when sourceType === "pwm"
+     * see [[PWMOscillator]]
+     * @min 0.1
+     * @max 5
+     */
+    get modulationFrequency(): IsPWMOscillator<OscType, Signal<"frequency">>;
+    asArray(length?: number): Promise<Float32Array>;
+    dispose(): this;
+}

package/build/esm/source/oscillator/OmniOscillator.js

@@ -0,0 +1,348 @@
+import { __awaiter } from "tslib";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { readOnly } from "../../core/util/Interface";
+import { isNumber, isString } from "../../core/util/TypeCheck";
+import { Signal } from "../../signal/Signal";
+import { Source } from "../Source";
+import { AMOscillator } from "./AMOscillator";
+import { FatOscillator } from "./FatOscillator";
+import { FMOscillator } from "./FMOscillator";
+import { Oscillator } from "./Oscillator";
+import { generateWaveform } from "./OscillatorInterface";
+import { PulseOscillator } from "./PulseOscillator";
+import { PWMOscillator } from "./PWMOscillator";
+const OmniOscillatorSourceMap = {
+    am: AMOscillator,
+    fat: FatOscillator,
+    fm: FMOscillator,
+    oscillator: Oscillator,
+    pulse: PulseOscillator,
+    pwm: PWMOscillator,
+};
+/**
+ * OmniOscillator aggregates all of the oscillator types into one.
+ * @example
+ * return Tone.Offline(() => {
+ * 	const omniOsc = new Tone.OmniOscillator("C#4", "pwm").toDestination().start();
+ * }, 0.1, 1);
+ * @category Source
+ */
+export class OmniOscillator extends Source {
+    constructor() {
+        super(optionsFromArguments(OmniOscillator.getDefaults(), arguments, ["frequency", "type"]));
+        this.name = "OmniOscillator";
+        const options = optionsFromArguments(OmniOscillator.getDefaults(), arguments, ["frequency", "type"]);
+        this.frequency = new Signal({
+            context: this.context,
+            units: "frequency",
+            value: options.frequency,
+        });
+        this.detune = new Signal({
+            context: this.context,
+            units: "cents",
+            value: options.detune,
+        });
+        readOnly(this, ["frequency", "detune"]);
+        // set the options
+        this.set(options);
+    }
+    static getDefaults() {
+        return Object.assign(Oscillator.getDefaults(), FMOscillator.getDefaults(), AMOscillator.getDefaults(), FatOscillator.getDefaults(), PulseOscillator.getDefaults(), PWMOscillator.getDefaults());
+    }
+    /**
+     * start the oscillator
+     */
+    _start(time) {
+        this._oscillator.start(time);
+    }
+    /**
+     * start the oscillator
+     */
+    _stop(time) {
+        this._oscillator.stop(time);
+    }
+    _restart(time) {
+        this._oscillator.restart(time);
+        return this;
+    }
+    /**
+     * The type of the oscillator. Can be any of the basic types: sine, square, triangle, sawtooth. Or
+     * prefix the basic types with "fm", "am", or "fat" to use the FMOscillator, AMOscillator or FatOscillator
+     * types. The oscillator could also be set to "pwm" or "pulse". All of the parameters of the
+     * oscillator's class are accessible when the oscillator is set to that type, but throws an error
+     * when it's not.
+     * @example
+     * const omniOsc = new Tone.OmniOscillator().toDestination().start();
+     * omniOsc.type = "pwm";
+     * // modulationFrequency is parameter which is available
+     * // only when the type is "pwm".
+     * omniOsc.modulationFrequency.value = 0.5;
+     */
+    get type() {
+        let prefix = "";
+        if (["am", "fm", "fat"].some(p => this._sourceType === p)) {
+            prefix = this._sourceType;
+        }
+        return prefix + this._oscillator.type;
+    }
+    set type(type) {
+        if (type.substr(0, 2) === "fm") {
+            this._createNewOscillator("fm");
+            this._oscillator = this._oscillator;
+            this._oscillator.type = type.substr(2);
+        }
+        else if (type.substr(0, 2) === "am") {
+            this._createNewOscillator("am");
+            this._oscillator = this._oscillator;
+            this._oscillator.type = type.substr(2);
+        }
+        else if (type.substr(0, 3) === "fat") {
+            this._createNewOscillator("fat");
+            this._oscillator = this._oscillator;
+            this._oscillator.type = type.substr(3);
+        }
+        else if (type === "pwm") {
+            this._createNewOscillator("pwm");
+            this._oscillator = this._oscillator;
+        }
+        else if (type === "pulse") {
+            this._createNewOscillator("pulse");
+        }
+        else {
+            this._createNewOscillator("oscillator");
+            this._oscillator = this._oscillator;
+            this._oscillator.type = type;
+        }
+    }
+    /**
+     * The value is an empty array when the type is not "custom".
+     * This is not available on "pwm" and "pulse" oscillator types.
+     * See [[Oscillator.partials]]
+     */
+    get partials() {
+        return this._oscillator.partials;
+    }
+    set partials(partials) {
+        if (!this._getOscType(this._oscillator, "pulse") && !this._getOscType(this._oscillator, "pwm")) {
+            this._oscillator.partials = partials;
+        }
+    }
+    get partialCount() {
+        return this._oscillator.partialCount;
+    }
+    set partialCount(partialCount) {
+        if (!this._getOscType(this._oscillator, "pulse") && !this._getOscType(this._oscillator, "pwm")) {
+            this._oscillator.partialCount = partialCount;
+        }
+    }
+    set(props) {
+        // make sure the type is set first
+        if (Reflect.has(props, "type") && props.type) {
+            this.type = props.type;
+        }
+        // then set the rest
+        super.set(props);
+        return this;
+    }
+    /**
+     * connect the oscillator to the frequency and detune signals
+     */
+    _createNewOscillator(oscType) {
+        if (oscType !== this._sourceType) {
+            this._sourceType = oscType;
+            const OscConstructor = OmniOscillatorSourceMap[oscType];
+            // short delay to avoid clicks on the change
+            const now = this.now();
+            if (this._oscillator) {
+                const oldOsc = this._oscillator;
+                oldOsc.stop(now);
+                // dispose the old one
+                this.context.setTimeout(() => oldOsc.dispose(), this.blockTime);
+            }
+            this._oscillator = new OscConstructor({
+                context: this.context,
+            });
+            this.frequency.connect(this._oscillator.frequency);
+            this.detune.connect(this._oscillator.detune);
+            this._oscillator.connect(this.output);
+            this._oscillator.onstop = () => this.onstop(this);
+            if (this.state === "started") {
+                this._oscillator.start(now);
+            }
+        }
+    }
+    get phase() {
+        return this._oscillator.phase;
+    }
+    set phase(phase) {
+        this._oscillator.phase = phase;
+    }
+    /**
+     * The source type of the oscillator.
+     * @example
+     * const omniOsc = new Tone.OmniOscillator(440, "fmsquare");
+     * console.log(omniOsc.sourceType); // 'fm'
+     */
+    get sourceType() {
+        return this._sourceType;
+    }
+    set sourceType(sType) {
+        // the basetype defaults to sine
+        let baseType = "sine";
+        if (this._oscillator.type !== "pwm" && this._oscillator.type !== "pulse") {
+            baseType = this._oscillator.type;
+        }
+        // set the type
+        if (sType === "fm") {
+            this.type = "fm" + baseType;
+        }
+        else if (sType === "am") {
+            this.type = "am" + baseType;
+        }
+        else if (sType === "fat") {
+            this.type = "fat" + baseType;
+        }
+        else if (sType === "oscillator") {
+            this.type = baseType;
+        }
+        else if (sType === "pulse") {
+            this.type = "pulse";
+        }
+        else if (sType === "pwm") {
+            this.type = "pwm";
+        }
+    }
+    _getOscType(osc, sourceType) {
+        return osc instanceof OmniOscillatorSourceMap[sourceType];
+    }
+    /**
+     * The base type of the oscillator. See [[Oscillator.baseType]]
+     * @example
+     * const omniOsc = new Tone.OmniOscillator(440, "fmsquare4");
+     * console.log(omniOsc.sourceType, omniOsc.baseType, omniOsc.partialCount);
+     */
+    get baseType() {
+        return this._oscillator.baseType;
+    }
+    set baseType(baseType) {
+        if (!this._getOscType(this._oscillator, "pulse") &&
+            !this._getOscType(this._oscillator, "pwm") &&
+            baseType !== "pulse" && baseType !== "pwm") {
+            this._oscillator.baseType = baseType;
+        }
+    }
+    /**
+     * The width of the oscillator when sourceType === "pulse".
+     * See [[PWMOscillator.width]]
+     */
+    get width() {
+        if (this._getOscType(this._oscillator, "pulse")) {
+            return this._oscillator.width;
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * The number of detuned oscillators when sourceType === "fat".
+     * See [[FatOscillator.count]]
+     */
+    get count() {
+        if (this._getOscType(this._oscillator, "fat")) {
+            return this._oscillator.count;
+        }
+        else {
+            return undefined;
+        }
+    }
+    set count(count) {
+        if (this._getOscType(this._oscillator, "fat") && isNumber(count)) {
+            this._oscillator.count = count;
+        }
+    }
+    /**
+     * The detune spread between the oscillators when sourceType === "fat".
+     * See [[FatOscillator.count]]
+     */
+    get spread() {
+        if (this._getOscType(this._oscillator, "fat")) {
+            return this._oscillator.spread;
+        }
+        else {
+            return undefined;
+        }
+    }
+    set spread(spread) {
+        if (this._getOscType(this._oscillator, "fat") && isNumber(spread)) {
+            this._oscillator.spread = spread;
+        }
+    }
+    /**
+     * The type of the modulator oscillator. Only if the oscillator is set to "am" or "fm" types.
+     * See [[AMOscillator]] or [[FMOscillator]]
+     */
+    get modulationType() {
+        if (this._getOscType(this._oscillator, "fm") || this._getOscType(this._oscillator, "am")) {
+            return this._oscillator.modulationType;
+        }
+        else {
+            return undefined;
+        }
+    }
+    set modulationType(mType) {
+        if ((this._getOscType(this._oscillator, "fm") || this._getOscType(this._oscillator, "am")) && isString(mType)) {
+            this._oscillator.modulationType = mType;
+        }
+    }
+    /**
+     * The modulation index when the sourceType === "fm"
+     * See [[FMOscillator]].
+     */
+    get modulationIndex() {
+        if (this._getOscType(this._oscillator, "fm")) {
+            return this._oscillator.modulationIndex;
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Harmonicity is the frequency ratio between the carrier and the modulator oscillators.
+     * See [[AMOscillator]] or [[FMOscillator]]
+     */
+    get harmonicity() {
+        if (this._getOscType(this._oscillator, "fm") || this._getOscType(this._oscillator, "am")) {
+            return this._oscillator.harmonicity;
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * The modulationFrequency Signal of the oscillator when sourceType === "pwm"
+     * see [[PWMOscillator]]
+     * @min 0.1
+     * @max 5
+     */
+    get modulationFrequency() {
+        if (this._getOscType(this._oscillator, "pwm")) {
+            return this._oscillator.modulationFrequency;
+        }
+        else {
+            return undefined;
+        }
+    }
+    asArray(length = 1024) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return generateWaveform(this, length);
+        });
+    }
+    dispose() {
+        super.dispose();
+        this.detune.dispose();
+        this.frequency.dispose();
+        this._oscillator.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=OmniOscillator.js.map

package/build/esm/source/oscillator/OmniOscillator.js.map

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

package/build/esm/source/oscillator/Oscillator.d.ts

@@ -0,0 +1,125 @@
+import { AudioRange, Degrees, Frequency, Time } from "../../core/type/Units";
+import { Signal } from "../../signal/Signal";
+import { Source } from "../Source";
+import { ToneOscillatorConstructorOptions, ToneOscillatorInterface, ToneOscillatorOptions, ToneOscillatorType } from "./OscillatorInterface";
+export { ToneOscillatorOptions, ToneOscillatorType } from "./OscillatorInterface";
+/**
+ * Oscillator supports a number of features including
+ * phase rotation, multiple oscillator types (see Oscillator.type),
+ * and Transport syncing (see Oscillator.syncFrequency).
+ *
+ * @example
+ * // make and start a 440hz sine tone
+ * const osc = new Tone.Oscillator(440, "sine").toDestination().start();
+ * @category Source
+ */
+export declare class Oscillator extends Source<ToneOscillatorOptions> implements ToneOscillatorInterface {
+    readonly name: string;
+    /**
+     * the main oscillator
+     */
+    private _oscillator;
+    /**
+     * The frequency control.
+     */
+    frequency: Signal<"frequency">;
+    /**
+     * The detune control signal.
+     */
+    detune: Signal<"cents">;
+    /**
+     * the periodic wave
+     */
+    private _wave?;
+    /**
+     * The partials of the oscillator
+     */
+    private _partials;
+    /**
+     * The number of partials to limit or extend the periodic wave by
+     */
+    private _partialCount;
+    /**
+     * the phase of the oscillator between 0 - 360
+     */
+    private _phase;
+    /**
+     * the type of the oscillator
+     */
+    private _type;
+    /**
+     * @param frequency Starting frequency
+     * @param type The oscillator type. Read more about type below.
+     */
+    constructor(frequency?: Frequency, type?: ToneOscillatorType);
+    constructor(options?: Partial<ToneOscillatorConstructorOptions>);
+    static getDefaults(): ToneOscillatorOptions;
+    /**
+     * start the oscillator
+     */
+    protected _start(time?: Time): void;
+    /**
+     * stop the oscillator
+     */
+    protected _stop(time?: Time): void;
+    /**
+     * Restart the oscillator. Does not stop the oscillator, but instead
+     * just cancels any scheduled 'stop' from being invoked.
+     */
+    protected _restart(time?: Time): this;
+    /**
+     * Sync the signal to the Transport's bpm. Any changes to the transports bpm,
+     * will also affect the oscillators frequency.
+     * @example
+     * const osc = new Tone.Oscillator().toDestination().start();
+     * osc.frequency.value = 440;
+     * // the ratio between the bpm and the frequency will be maintained
+     * osc.syncFrequency();
+     * // double the tempo
+     * Tone.Transport.bpm.value *= 2;
+     * // the frequency of the oscillator is doubled to 880
+     */
+    syncFrequency(): this;
+    /**
+     * Unsync the oscillator's frequency from the Transport.
+     * See Oscillator.syncFrequency
+     */
+    unsyncFrequency(): this;
+    /**
+     * Cache the periodic waves to avoid having to redo computations
+     */
+    private static _periodicWaveCache;
+    /**
+     * Get a cached periodic wave. Avoids having to recompute
+     * the oscillator values when they have already been computed
+     * with the same values.
+     */
+    private _getCachedPeriodicWave;
+    get type(): ToneOscillatorType;
+    set type(type: ToneOscillatorType);
+    get baseType(): OscillatorType;
+    set baseType(baseType: OscillatorType);
+    get partialCount(): number;
+    set partialCount(p: number);
+    /**
+     * Returns the real and imaginary components based
+     * on the oscillator type.
+     * @returns [real: Float32Array, imaginary: Float32Array]
+     */
+    private _getRealImaginary;
+    /**
+     * Compute the inverse FFT for a given phase.
+     */
+    private _inverseFFT;
+    /**
+     * Returns the initial value of the oscillator when stopped.
+     * E.g. a "sine" oscillator with phase = 90 would return an initial value of -1.
+     */
+    getInitialValue(): AudioRange;
+    get partials(): number[];
+    set partials(partials: number[]);
+    get phase(): Degrees;
+    set phase(phase: Degrees);
+    asArray(length?: number): Promise<Float32Array>;
+    dispose(): this;
+}