tone 15.4.3 → 15.5.1

package/Tone/component/analysis/Meter.test.ts

@@ -69,6 +69,20 @@ describe("Meter", () => {
 			}, 400);
 		});
 
+		it("returns 0 below a threshold", (done) => {
+			const meter = new Meter({
+				normalRange: true,
+			});
+			const osc = new Oscillator().connect(meter).start();
+			osc.volume.value = -101;
+			setTimeout(() => {
+				expect(meter.getValue()).to.equal(0);
+				meter.dispose();
+				osc.dispose();
+				done();
+			}, 400);
+		});
+
 		it("can get the values in normal range", (done) => {
 			const meter = new Meter({
 				normalRange: true,

package/Tone/component/analysis/Meter.ts

@@ -1,4 +1,4 @@
-import { gainToDb } from "../../core/type/Conversions.js";
+import { dbToGain, gainToDb } from "../../core/type/Conversions.js";
 import { NormalRange } from "../../core/type/Units.js";
 import { warn } from "../../core/util/Debug.js";
 import { optionsFromArguments } from "../../core/util/Defaults.js";
@@ -93,6 +93,11 @@ export class Meter extends MeterBase<MeterOptions> {
 		return this.getValue();
 	}
 
+	/**
+	 * Below this threshold, stop smoothing.
+	 */
+	private minValue = dbToGain(-100);
+
 	/**
 	 * Get the current value of the incoming signal.
 	 * Output is in decibels when {@link normalRange} is `false`.
@@ -106,18 +111,25 @@ export class Meter extends MeterBase<MeterOptions> {
 			this.channels === 1
 				? [aValues as Float32Array]
 				: (aValues as Float32Array[]);
-		const vals = channelValues.map((values, index) => {
+		const vals = channelValues.map((values, channel) => {
 			const totalSquared = values.reduce(
 				(total, current) => total + current * current,
 				0
 			);
 			const rms = Math.sqrt(totalSquared / values.length);
-			// the rms can only fall at the rate of the smoothing
-			// but can jump up instantly
-			this._rms[index] = Math.max(rms, this._rms[index] * this.smoothing);
+			if (rms < this.minValue) {
+				this._rms[channel] = 0;
+			} else {
+				// the rms can only fall at the rate of the smoothing
+				// but can jump up instantly
+				this._rms[channel] = Math.max(
+					rms,
+					this._rms[channel] * this.smoothing
+				);
+			}
 			return this.normalRange
-				? this._rms[index]
-				: gainToDb(this._rms[index]);
+				? this._rms[channel]
+				: gainToDb(this._rms[channel]);
 		});
 		if (this.channels === 1) {
 			return vals[0];

package/Tone/component/channel/CrossFade.ts

@@ -9,6 +9,7 @@ import { optionsFromArguments } from "../../core/util/Defaults.js";
 import { readOnly } from "../../core/util/Interface.js";
 import { GainToAudio } from "../../signal/GainToAudio.js";
 import { Signal } from "../../signal/Signal.js";
+import { ToneConstantSource } from "../../signal/ToneConstantSource.js";
 
 interface CrossFadeOptions extends ToneAudioNodeOptions {
 	fade: NormalRange;
@@ -59,6 +60,11 @@ export class CrossFade extends ToneAudioNode<CrossFadeOptions> {
 	 */
 	private _g2a: GainToAudio = new GainToAudio({ context: this.context });
 
+	/**
+	 * The constant source which is used to control the panner
+	 */
+	private _constant: ToneConstantSource;
+
 	/**
 	 * The input which is at full level when fade = 0
 	 */
@@ -114,7 +120,11 @@ export class CrossFade extends ToneAudioNode<CrossFadeOptions> {
 		});
 		readOnly(this, "fade");
 
-		this.context.getConstant(1).connect(this._panner);
+		this._constant = new ToneConstantSource({
+			context: this.context,
+			offset: 1,
+		}).start();
+		this._constant.connect(this._panner);
 		this._panner.connect(this._split);
 		// this is necessary for standardized-audio-context
 		// doesn't make any difference for the native AudioContext
@@ -145,6 +155,7 @@ export class CrossFade extends ToneAudioNode<CrossFadeOptions> {
 		this._g2a.dispose();
 		this._panner.disconnect();
 		this._split.disconnect();
+		this._constant.dispose();
 		return this;
 	}
 }

package/Tone/core/context/BaseContext.ts

@@ -129,6 +129,9 @@ export abstract class BaseContext
 
 	abstract clearInterval(_id: number): this;
 
+	/**
+	 * @deprecated use ToneConstantSource instead
+	 */
 	abstract getConstant(_val: number): AudioBufferSourceNode;
 
 	abstract get currentTime(): Seconds;

package/Tone/core/context/Context.ts

@@ -40,7 +40,7 @@ export class Context extends BaseContext {
 	readonly name: string = "Context";
 
 	/**
-		 * A private reference to the BaseAudioContext.
+	 * A private reference to the BaseAudioContext.
 	 */
 	protected readonly _context: AnyAudioContext;
 
@@ -521,6 +521,7 @@ export class Context extends BaseContext {
 
 	/**
 	 * **Internal** Generate a looped buffer at some constant value.
+	 * @deprecated
 	 */
 	getConstant(val: number): AudioBufferSourceNode {
 		if (this._constants.has(val)) {

package/Tone/effect/AutoPanner.test.ts

@@ -87,23 +87,5 @@ describe("AutoPanner", () => {
 			expect(buffer.getValueAtTime(0)).to.be.closeTo(2, 0.1);
 			expect(buffer.getValueAtTime(0.05)).to.be.closeTo(2, 0.1);
 		});
-
-		/**
-		 * Width Tests
-		 */
-		it("can set the width", () => {
-			const autoPanner = new AutoPanner();
-			autoPanner.width = 0.5;
-			expect(autoPanner.width).to.be.closeTo(0.5, 0.01);
-			autoPanner.dispose();
-		});
-		
-		it("can pass width in the constructor", () => {
-			const autoPanner = new AutoPanner({
-				width: 0.3,
-			});
-			expect(autoPanner.width).to.be.closeTo(0.3, 0.01);
-			autoPanner.dispose();
-		});	
 	});
 });

package/Tone/effect/AutoPanner.ts

@@ -1,11 +1,10 @@
 import { Panner } from "../component/channel/Panner.js";
-import { Frequency, NormalRange } from "../core/type/Units.js";
+import { Frequency } from "../core/type/Units.js";
 import { optionsFromArguments } from "../core/util/Defaults.js";
 import { LFOEffect, LFOEffectOptions } from "./LFOEffect.js";
 
 export interface AutoPannerOptions extends LFOEffectOptions {
 	channelCount: number;
-	width: NormalRange;
 }
 
 /**
@@ -25,9 +24,7 @@ export class AutoPanner extends LFOEffect<AutoPannerOptions> {
 	/**
 	 * The filter node
 	 */
-	private readonly _panner: Panner;
-
-	private _width: NormalRange;
+	readonly _panner: Panner;
 
 	/**
 	 * @param frequency Rate of left-right oscillation.
@@ -46,42 +43,19 @@ export class AutoPanner extends LFOEffect<AutoPannerOptions> {
 			context: this.context,
 			channelCount: options.channelCount,
 		});
-
-		this._width = options.width;
-
 		// connections
 		this.connectEffect(this._panner);
 		this._lfo.connect(this._panner.pan);
-		this._updateLFORange();
+		this._lfo.min = -1;
+		this._lfo.max = 1;
 	}
 
 	static getDefaults(): AutoPannerOptions {
 		return Object.assign(LFOEffect.getDefaults(), {
 			channelCount: 1,
-			width: 1,
 		});
 	}
 
-	/**
-	 * Updates the LFO min/max based on width
-	 */
-	private _updateLFORange(): void {
-		this._lfo.min = -this._width;
-		this._lfo.max = this._width;
-	}
-
-	/**
-	 * The width of the panning effect. 0 = no panning, 1 = full left-right panning.
-	 */
-	get width(): NormalRange {
-		return this._width;
-	}
-
-	set width(width: NormalRange) {
-		this._width = width;
-		this._updateLFORange();
-	}
-
 	dispose(): this {
 		super.dispose();
 		this._panner.dispose();

package/Tone/signal/Zero.ts

@@ -1,11 +1,10 @@
-import { Gain } from "../core/context/Gain.js";
 import {
-	connect,
-	disconnect,
+	ToneAudioNode,
 	ToneAudioNodeOptions,
 } from "../core/context/ToneAudioNode.js";
 import { optionsFromArguments } from "../core/util/Defaults.js";
 import { SignalOperator } from "./SignalOperator.js";
+import { ToneConstantSource } from "./ToneConstantSource.js";
 
 /**
  * Tone.Zero outputs 0's at audio-rate. The reason this has to be
@@ -17,14 +16,14 @@ export class Zero extends SignalOperator<ToneAudioNodeOptions> {
 	readonly name: string = "Zero";
 
 	/**
-	 * The gain node which connects the constant source to the output
+	 * A constant source which outputs 0
 	 */
-	private _gain = new Gain({ context: this.context });
+	private _constant: ToneConstantSource;
 
 	/**
 	 * Only outputs 0
 	 */
-	output = this._gain;
+	output: ToneAudioNode;
 
 	/**
 	 * no input node
@@ -34,7 +33,10 @@ export class Zero extends SignalOperator<ToneAudioNodeOptions> {
 	constructor(options?: Partial<ToneAudioNodeOptions>);
 	constructor() {
 		super(optionsFromArguments(Zero.getDefaults(), arguments));
-		connect(this.context.getConstant(0), this._gain);
+		this._constant = this.output = new ToneConstantSource({
+			context: this.context,
+			offset: 0,
+		}).start();
 	}
 
 	/**
@@ -42,7 +44,7 @@ export class Zero extends SignalOperator<ToneAudioNodeOptions> {
 	 */
 	dispose(): this {
 		super.dispose();
-		disconnect(this.context.getConstant(0), this._gain);
+		this._constant.dispose();
 		return this;
 	}
 }

package/Tone/version.ts

@@ -1 +1 @@
-export const version: string = "15.4.3";
+export const version: string = "15.5.1";