Tone.js/Tone/effect/StereoFeedbackEffect.ts
Yotam Mann aaf880c925
Using web-test-runner for tests, updating import paths (#1242)
* WIP moving tests to web-test-runner

* updating thresholds

* Adding file extensions

* Testing integrations

* linting

* fixing dep

* moving back to root dir

* prettier all of the files

* updating eslint rules to use with prettier

* remove import package

* moving tsignore around

* removing unneeded ignores

* all tests run on puppeteer, no need for testing guards

* linting

* import type syntax

* cleaning up

* Update package.json
2024-05-03 14:31:14 -04:00

91 lines
2.5 KiB
TypeScript

import { StereoEffect, StereoEffectOptions } from "./StereoEffect.js";
import { NormalRange } from "../core/type/Units.js";
import { Signal } from "../signal/Signal.js";
import { Gain } from "../core/context/Gain.js";
import { readOnly } from "../core/util/Interface.js";
import { Split } from "../component/channel/Split.js";
import { Merge } from "../component/channel/Merge.js";
export interface StereoFeedbackEffectOptions extends StereoEffectOptions {
feedback: NormalRange;
}
/**
* Base class for stereo feedback effects where the effectReturn is fed back into the same channel.
*/
export class StereoFeedbackEffect<
Options extends StereoFeedbackEffectOptions,
> extends StereoEffect<Options> {
/**
* The amount of feedback from the output
* back into the input of the effect (routed
* across left and right channels).
*/
readonly feedback: Signal<"normalRange">;
/**
* the left side feedback
*/
protected _feedbackL: Gain;
/**
* the right side feedback
*/
protected _feedbackR: Gain;
/**
* Split the channels for feedback
*/
protected _feedbackSplit: Split;
/**
* Merge the channels for feedback
*/
protected _feedbackMerge: Merge;
constructor(options: StereoFeedbackEffectOptions) {
super(options);
this.feedback = new Signal({
context: this.context,
value: options.feedback,
units: "normalRange",
});
this._feedbackL = new Gain({ context: this.context });
this._feedbackR = new Gain({ context: this.context });
this._feedbackSplit = new Split({ context: this.context, channels: 2 });
this._feedbackMerge = new Merge({ context: this.context, channels: 2 });
this._merge.connect(this._feedbackSplit);
this._feedbackMerge.connect(this._split);
// the left output connected to the left input
this._feedbackSplit.connect(this._feedbackL, 0, 0);
this._feedbackL.connect(this._feedbackMerge, 0, 0);
// the right output connected to the right input
this._feedbackSplit.connect(this._feedbackR, 1, 0);
this._feedbackR.connect(this._feedbackMerge, 0, 1);
// the feedback control
this.feedback.fan(this._feedbackL.gain, this._feedbackR.gain);
readOnly(this, ["feedback"]);
}
static getDefaults(): StereoFeedbackEffectOptions {
return Object.assign(StereoEffect.getDefaults(), {
feedback: 0.5,
});
}
dispose(): this {
super.dispose();
this.feedback.dispose();
this._feedbackL.dispose();
this._feedbackR.dispose();
this._feedbackSplit.dispose();
this._feedbackMerge.dispose();
return this;
}
}