tone 15.4.2 → 15.5.0

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/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.2";
+export const version: string = "15.5.0";