import { expect } from "chai"; import { BasicTests } from "test/helper/Basic"; import { connectFrom, connectTo } from "test/helper/Connect"; import { ConstantOutput } from "test/helper/ConstantOutput"; import { Offline } from "test/helper/Offline"; import { Gain } from "../core/context/Gain"; import { Signal } from "./Signal"; describe("Signal", () => { BasicTests(Signal); context("Signal Rate Value", () => { it("handles input and output connections", () => { const signal = new Signal(); connectFrom().connect(signal); signal.connect(connectTo()); signal.dispose(); }); it("can be created with an options object", () => { const signal = new Signal({ units: "positive", value: 0.2, }); expect(signal.value).to.be.closeTo(0.2, 0.001); expect(signal.units).to.equal("positive"); signal.dispose(); }); it("can start with a value initially", () => { const signal = new Signal(2); expect(signal.value).to.equal(2); signal.dispose(); }); it("can set a value", () => { const signal = new Signal(0); signal.value = 10; expect(signal.value).to.equal(10); signal.dispose(); }); it("outputs a constant signal", () => { return ConstantOutput((context) => { const sig = new Signal(2.5).toMaster(); }, 2.5); }); it("takes on another signal's value when connected", () => { return ConstantOutput((context) => { const sigA = new Signal(1).toMaster(); const sigB = new Signal(3); sigB.connect(sigA); }, 3); }); it("takes the first signals value when many values are chained", () => { return ConstantOutput((context) => { const sigA = new Signal(3).toMaster(); const sigB = new Signal(1).connect(sigA); const sigC = new Signal(2).connect(sigB); }, 2); }); }); context("Scheduling", () => { afterEach(done => { setTimeout(() => done(), 100); }); it("can be scheduled to set a value in the future", async () => { const buffer = await Offline((context) => { const sig = new Signal(0).toMaster(); sig.setValueAtTime(2, 0.2); }, 0.25); expect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.001); expect(buffer.getValueAtTime(0.19)).to.be.closeTo(0, 0.001); expect(buffer.getValueAtTime(0.2)).to.be.closeTo(2, 0.001); expect(buffer.getValueAtTime(0.24)).to.be.closeTo(2, 0.001); }); it("can linear ramp from the current value to another value in the future", async () => { const buffer = await Offline(context => { const sig = new Signal(0).toMaster(); sig.setValueAtTime(0, 0); sig.linearRampToValueAtTime(1, 0.1); }, 0.1); expect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.001); expect(buffer.getValueAtTime(0.05)).to.be.closeTo(0.5, 0.001); expect(buffer.getValueAtTime(0.1)).to.be.closeTo(1, 0.001); }); it("can schedule multiple automations", async () => { const buffer = await Offline(context => { const sig = new Signal(0).toMaster(); sig.setValueAtTime(0, 0); sig.linearRampToValueAtTime(0.5, 0.5); sig.linearRampToValueAtTime(0, 1); }, 1); expect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.001); expect(buffer.getValueAtTime(0.25)).to.be.closeTo(0.25, 0.001); expect(buffer.getValueAtTime(0.5)).to.be.closeTo(0.5, 0.001); expect(buffer.getValueAtTime(0.75)).to.be.closeTo(0.25, 0.001); expect(buffer.getValueAtTime(1)).to.be.closeTo(0, 0.001); }); it("can schedule multiple automations from a connected signal", async () => { const buffer = await Offline((context) => { const output = new Signal(1).toMaster(); const sig = new Signal(0).connect(output); sig.setValueAtTime(0, 0); sig.linearRampToValueAtTime(0.5, 0.5); sig.linearRampToValueAtTime(0, 1); }, 1); expect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.001); expect(buffer.getValueAtTime(0.25)).to.be.closeTo(0.25, 0.001); expect(buffer.getValueAtTime(0.5)).to.be.closeTo(0.5, 0.001); expect(buffer.getValueAtTime(0.75)).to.be.closeTo(0.25, 0.001); expect(buffer.getValueAtTime(1)).to.be.closeTo(0, 0.001); }); it("can disconnect from all the connected notes", () => { return ConstantOutput((context) => { const output0 = new Signal(1).toMaster(); const output1 = new Signal(1).toMaster(); const sig = new Signal(0).connect(output0); sig.connect(output1); sig.disconnect(); sig.setValueAtTime(0, 0); sig.linearRampToValueAtTime(0.5, 0.5); sig.linearRampToValueAtTime(0, 1); }, 0); }); it("can disconnect from a specific node", () => { return ConstantOutput((context) => { const output = new Signal(1).toMaster(); const sig = new Signal(0).connect(output); sig.disconnect(output); sig.setValueAtTime(0, 0); sig.linearRampToValueAtTime(0.5, 0.5); sig.linearRampToValueAtTime(0, 1); }, 0); }); it("can schedule multiple automations from a connected signal through a multiple nodes", async () => { const buffer = await Offline(() => { const output = new Signal(0).toMaster(); const proxy = new Signal(0).connect(output); const gain = new Gain(1).connect(proxy); const sig = new Signal(0).connect(gain); sig.setValueAtTime(0, 0); sig.linearRampToValueAtTime(0.5, 0.5); sig.linearRampToValueAtTime(0, 1); }, 1); expect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.01); expect(buffer.getValueAtTime(0.1)).to.be.closeTo(0.1, 0.01); expect(buffer.getValueAtTime(0.25)).to.be.closeTo(0.25, 0.01); expect(buffer.getValueAtTime(0.5)).to.be.closeTo(0.5, 0.01); expect(buffer.getValueAtTime(0.75)).to.be.closeTo(0.25, 0.01); expect(buffer.getValueAtTime(1)).to.be.closeTo(0, 0.01); }); it("can cancel an automation", () => { return ConstantOutput(() => { const sig = new Signal(1).toMaster(); sig.setValueAtTime(4, 0.1); sig.exponentialRampToValueAtTime(3, 0.2); sig.cancelScheduledValues(0); }, 1); }); it("can cancel and hold a linear automation curve", async () => { const buffer = await Offline(() => { const sig = new Signal(0).toMaster(); sig.linearRampTo(2, 1); sig.cancelAndHoldAtTime(0.5); }, 1); expect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.1); expect(buffer.getValueAtTime(0.25)).to.be.closeTo(0.5, 0.1); expect(buffer.getValueAtTime(0.5)).to.be.closeTo(1, 0.1); expect(buffer.getValueAtTime(0.75)).to.be.closeTo(1, 0.1); }); it("can cancel and hold an exponential automation curve", () => { return Offline(() => { const sig = new Signal(1).toMaster(); sig.exponentialRampTo(2, 1); sig.cancelAndHoldAtTime(0.5); }, 1).then(buffer => { expect(buffer.getValueAtTime(0)).to.be.closeTo(1, 0.1); expect(buffer.getValueAtTime(0.25)).to.be.closeTo(1.2, 0.1); expect(buffer.getValueAtTime(0.5)).to.be.closeTo(1.4, 0.1); expect(buffer.getValueAtTime(0.75)).to.be.closeTo(1.4, 0.1); }); }); it("can set a linear ramp from the current time", () => { return Offline(() => { const sig = new Signal(0).toMaster(); sig.linearRampTo(2, 0.3); }, 0.5).then((buffer) => { buffer.forEach((sample, time) => { if (time > 0.3) { expect(sample).to.be.closeTo(2, 0.02); } }); }); }); it("can set an linear ramp in the future", () => { return Offline(() => { const sig = new Signal(1).toMaster(); sig.linearRampTo(50, 0.3, 0.2); }, 0.7).then((buffer) => { buffer.forEach((sample, time) => { if (time >= 0.6) { expect(sample).to.be.closeTo(50, 0.5); } else if (time < 0.2) { expect(sample).to.closeTo(1, 0.01); } }); }); }); it("can set a exponential approach ramp from the current time", () => { return Offline(() => { const sig = new Signal(0).toMaster(); sig.targetRampTo(1, 0.3); }, 0.5).then((buffer) => { expect(buffer.getValueAtTime(0)).to.be.below(0.0001); expect(buffer.getValueAtTime(0.3)).to.be.closeTo(1, 0.02); }); }); it("can set an exponential approach ramp in the future", () => { return Offline(() => { const sig = new Signal(1).toMaster(); sig.targetRampTo(50, 0.3, 0.2); }, 0.7).then((buffer) => { expect(buffer.getValueAtTime(0)).to.be.closeTo(1, 0.0001); expect(buffer.getValueAtTime(0.2)).to.be.closeTo(1, 0.0001); expect(buffer.getValueAtTime(0.6)).to.be.closeTo(50, 0.5); }); }); it("can set an exponential ramp from the current time", () => { return Offline(() => { const sig = new Signal(1).toMaster(); sig.exponentialRampTo(50, 0.4); }, 0.6).then((buffer) => { buffer.forEach((sample, time) => { if (time >= 0.4) { expect(sample).to.be.closeTo(50, 0.5); } else if (time < 0.39) { expect(sample).to.be.lessThan(50); } }); }); }); it("can set an exponential ramp in the future", () => { return Offline(() => { const sig = new Signal(1).toMaster(); sig.exponentialRampTo(50, 0.3, 0.2); }, 0.8).then((buffer) => { buffer.forEach((sample, time) => { if (time >= 0.6) { expect(sample).to.be.closeTo(50, 0.5); } else if (time < 0.2) { expect(sample).to.equal(1); } }); }); }); it("rampTo ramps from the current value", () => { return Offline(() => { const sig = new Signal(3).toMaster(); sig.rampTo(0.2, 0.1); }, 0.4).then((buffer) => { buffer.forEach((sample, time) => { if (time >= 0.1) { expect(sample).to.be.closeTo(0.2, 0.1); } else { expect(sample).to.be.greaterThan(0.2); } }); }); }); it("rampTo ramps from the current value at a specific time", () => { return Offline(() => { const sig = new Signal(0).toMaster(); sig.rampTo(2, 0.1, 0.4); }, 0.6).then((buffer) => { buffer.forEach((sample, time) => { if (time < 0.4) { expect(sample).to.be.closeTo(0, 0.1); } else if (time > 0.5) { expect(sample).to.be.closeTo(2, 0.1); } }); }); }); it("can set a value curve", () => { return Offline(() => { const sig = new Signal(0).toMaster(); sig.setValueCurveAtTime([0, 1, 0.5, 0.2], 0, 1); }, 1).then((buffer) => { expect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.01); expect(buffer.getValueAtTime(0.33 / 2)).to.be.closeTo(0.5, 0.01); expect(buffer.getValueAtTime(0.33)).to.be.closeTo(1, 0.02); expect(buffer.getValueAtTime(0.66)).to.be.closeTo(0.5, 0.02); expect(buffer.getValueAtTime(0.99)).to.be.closeTo(0.2, 0.02); }); }); it("can set a value curve in the future", () => { return Offline(() => { const sig = new Signal(0).toMaster(); sig.setValueCurveAtTime([0, 1, 0.5, 0.2], 0.5, 1); }, 1.5).then((buffer) => { expect(buffer.getValueAtTime(0 + 0.5)).to.be.closeTo(0, 0.01); expect(buffer.getValueAtTime(0.33 / 2 + 0.5)).to.be.closeTo(0.5, 0.01); expect(buffer.getValueAtTime(0.33 + 0.5)).to.be.closeTo(1, 0.02); expect(buffer.getValueAtTime(0.66 + 0.5)).to.be.closeTo(0.5, 0.02); expect(buffer.getValueAtTime(0.99 + 0.5)).to.be.closeTo(0.2, 0.02); }); }); it("can set an exponential approach", () => { return Offline(() => { const sig = new Signal(0).toMaster(); sig.exponentialApproachValueAtTime(2, 0.1, 0.5); }, 1).then((buffer) => { expect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.01); expect(buffer.getValueAtTime(0.1)).to.be.closeTo(0, 0.01); expect(buffer.getValueAtTime(0.4)).to.be.closeTo(1.9, 0.1); expect(buffer.getValueAtTime(0.6)).to.be.closeTo(2, 0.01); }); }); }); context("Units", () => { it("can be created with specific units", () => { const signal = new Signal(0, "bpm"); expect(signal.units).to.equal("bpm"); signal.dispose(); }); it("can evaluate the given units", () => { const signal = new Signal(2, "time"); signal.value = 0.5; expect(signal.value).to.be.closeTo(0.5, 0.001); signal.dispose(); }); it("converts the given units when passed in the constructor", () => { return ConstantOutput(() => { const signal = new Signal({ units: "decibels", value: -10, }).toMaster(); }, 0.315); }); it("can be set to not convert the given units", () => { return ConstantOutput(() => { const signal = new Signal({ convert: false, units: "decibels", value: -10, }).toMaster(); }, -10); }); it("converts Frequency units", () => { const signal = new Signal<"frequency">("50hz", "frequency"); expect(signal.value).to.be.closeTo(50, 0.01); signal.dispose(); }); it("converts Time units", () => { const signal = new Signal<"time">("4n", "time"); expect(signal.value).to.be.closeTo(0.5, 0.01); signal.dispose(); }); it("converts NormalRange units", () => { const signal = new Signal(2, "normalRange"); expect(signal.value).to.be.closeTo(1, 0.01); signal.dispose(); }); it("converts AudioRange units", () => { const signal = new Signal(-2, "audioRange"); expect(signal.value).to.be.closeTo(-1, 0.01); signal.dispose(); }); it("converts Positive units", () => { const signal = new Signal(-2, "positive"); expect(signal.value).to.be.closeTo(0, 0.01); signal.dispose(); }); }); // context("Transport Syncing", () => { // it("maintains its original value after being synced to the transport", () => { // return ConstantOutput(function(Transport) { // const sig = new Signal(3).toMaster(); // Transport.syncSignal(sig); // }, 3); // }); // it("keeps the ratio when the bpm changes", () => { // return ConstantOutput(function(Transport) { // Transport.bpm.value = 120; // const sig = new Signal(5).toMaster(); // Transport.syncSignal(sig); // Transport.bpm.value = 240; // }, 10); // }); // it("can ramp along with the bpm", () => { // return Offline(function(Transport) { // Transport.bpm.value = 120; // const sig = new Signal(2).toMaster(); // Transport.syncSignal(sig); // Transport.bpm.rampTo(240, 0.5); // }).then((buffer) => { // buffer.forEach((sample, time) => { // if (time >= 0.5) { // expect(sample).to.be.closeTo(4, 0.04); // } else if (time < 0.4) { // expect(sample).to.be.within(1.95, 3); // } // }); // }); // }); // it("returns to the original value when unsynced", () => { // return ConstantOutput(function(Transport) { // Transport.bpm.value = 120; // const sig = new Signal(5).toMaster(); // Transport.syncSignal(sig); // Transport.bpm.value = 240; // Transport.unsyncSignal(sig); // }, 5); // }); // }); });