mirror of
https://github.com/Tonejs/Tone.js
synced 2024-11-16 08:38:00 +00:00
415 lines
11 KiB
JavaScript
415 lines
11 KiB
JavaScript
define(["helper/Offline", "helper/Basic", "Test", "Tone/signal/Signal",
|
|
"Tone/type/Type", "Tone/core/Transport", "Tone/component/LFO", "helper/ConstantOutput"],
|
|
function (Offline, Basic, Test, Signal, Tone, Transport, LFO, ConstantOutput) {
|
|
|
|
describe("Signal", function(){
|
|
|
|
Basic(Signal);
|
|
|
|
context("Signal Rate Value", function(){
|
|
|
|
it("handles input and output connections", function(){
|
|
var signal = new Signal();
|
|
Test.connect(signal);
|
|
signal.connect(Test);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("can be created with an options object", function(){
|
|
var signal = new Signal({
|
|
"value" : 0.2,
|
|
"units" : Tone.Type.Positive
|
|
});
|
|
expect(signal.value).to.be.closeTo(0.2, 0.001);
|
|
expect(signal.units).to.equal(Tone.Type.Positive);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("can start with a value initially", function(){
|
|
var signal = new Signal(2);
|
|
expect(signal.value).to.equal(2);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("can set a value", function(){
|
|
var signal = new Signal(0);
|
|
signal.value = 10;
|
|
expect(signal.value).to.equal(10);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("takes on another signal's value when connected", function(){
|
|
return ConstantOutput(function(){
|
|
var sigA = new Signal(0).toMaster();
|
|
new Signal(3).connect(sigA);
|
|
}, 3);
|
|
});
|
|
});
|
|
|
|
context("Scheduling", function(){
|
|
|
|
it ("can be scheduled to set a value in the future", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(0).toMaster();
|
|
sig.setValueAtTime(2, 0.2);
|
|
}, 0.3).then(function(buffer){
|
|
buffer.forEach(function(sample, time){
|
|
if (time < 0.19){
|
|
expect(sample).to.be.closeTo(0, 0.001);
|
|
} else if (time > 0.2){
|
|
expect(sample).to.be.closeTo(2, 0.001);
|
|
}
|
|
});
|
|
});
|
|
});
|
|
|
|
it ("can linear ramp from the current value to another value in the future", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(0).toMaster();
|
|
sig.setValueAtTime(0, 0);
|
|
sig.linearRampToValueAtTime(1, 1);
|
|
}, 1).then(function(buffer){
|
|
buffer.forEach(function(sample, time){
|
|
expect(sample).to.be.closeTo(time, 0.001);
|
|
});
|
|
});
|
|
});
|
|
|
|
it ("can schedule an exponential ramp", function(){
|
|
var sig = new Signal(1);
|
|
sig.exponentialRampToValueAtTime(3, 1);
|
|
sig.dispose();
|
|
});
|
|
|
|
it ("can approach a target value", function(){
|
|
var sig = new Signal(1);
|
|
sig.setTargetAtTime(0.2, 1, 2);
|
|
sig.dispose();
|
|
});
|
|
|
|
it ("can set a ramp point at the current value", function(){
|
|
var sig = new Signal(1);
|
|
sig.setRampPoint();
|
|
sig.dispose();
|
|
});
|
|
|
|
it ("can schedule multiple automations", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(0).toMaster();
|
|
sig.setValueAtTime(0, 0);
|
|
sig.linearRampToValueAtTime(0.5, 0.5);
|
|
sig.linearRampToValueAtTime(0, 1);
|
|
}, 1).then(function(buffer){
|
|
buffer.forEach(function(sample, time){
|
|
if (time < 0.5){
|
|
expect(sample).to.be.closeTo(time, 0.01);
|
|
} else {
|
|
expect(sample).to.be.closeTo(1 - time, 0.01);
|
|
}
|
|
});
|
|
});
|
|
});
|
|
|
|
it ("can cancel an automation", function(){
|
|
return ConstantOutput(function(){
|
|
var sig = new Signal(1).toMaster();
|
|
sig.setValueAtTime(4, 0.1);
|
|
sig.exponentialRampToValueAtTime(3, 0.2);
|
|
sig.cancelScheduledValues(0);
|
|
}, 1);
|
|
});
|
|
|
|
it ("can cancel and hold an automation curve", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(0).toMaster();
|
|
sig.linearRampTo(2, 1);
|
|
sig.cancelAndHoldAtTime(0.5)
|
|
}, 1).then(function(buffer){
|
|
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 set a linear ramp from the current time", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(0).toMaster();
|
|
sig.linearRampTo(2, 0.3);
|
|
}, 0.5).then(function(buffer){
|
|
buffer.forEach(function(sample, time){
|
|
if (time > 0.3){
|
|
expect(sample).to.be.closeTo(2, 0.02);
|
|
}
|
|
});
|
|
});
|
|
});
|
|
|
|
it ("can set an linear ramp in the future", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(1).toMaster();
|
|
sig.linearRampTo(50, 0.3, 0.2);
|
|
}, 0.6).then(function(buffer){
|
|
buffer.forEach(function(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 ("can set an exponential ramp from the current time", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(1).toMaster();
|
|
sig.exponentialRampTo(50, 0.4);
|
|
}, 0.6).then(function(buffer){
|
|
buffer.forEach(function(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", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(1).toMaster();
|
|
sig.exponentialRampTo(50, 0.3, 0.2);
|
|
}, 0.8).then(function(buffer){
|
|
buffer.forEach(function(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", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(3).toMaster();
|
|
sig.rampTo(0.2, 0.1);
|
|
}, 0.4).then(function(buffer){
|
|
buffer.forEach(function(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", function(){
|
|
return Offline(function(){
|
|
var sig = new Signal(0).toMaster();
|
|
sig.rampTo(2, 0.1, 0.4);
|
|
}, 0.6).then(function(buffer){
|
|
buffer.forEach(function(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);
|
|
}
|
|
});
|
|
});
|
|
});
|
|
|
|
});
|
|
|
|
context("Units", function(){
|
|
|
|
it("can be created with specific units", function(){
|
|
var signal = new Signal(0, Tone.Type.BPM);
|
|
expect(signal.units).to.equal(Tone.Type.BPM);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("can evaluate the given units", function(){
|
|
var signal = new Signal(2, Tone.Type.Time);
|
|
signal.value = "4n";
|
|
expect(signal.value).to.be.closeTo(0.5, 0.001);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("converts the given units when passed in the constructor", function(){
|
|
return ConstantOutput(function(){
|
|
var signal = new Signal({
|
|
"value" : -10,
|
|
"units" : Tone.Type.Decibels,
|
|
}).toMaster();
|
|
}, 0.315);
|
|
});
|
|
|
|
it("can be set to not convert the given units", function(){
|
|
return ConstantOutput(function(){
|
|
var signal = new Signal({
|
|
"value" : -10,
|
|
"units" : Tone.Type.Decibels,
|
|
"convert" : false
|
|
}).toMaster();
|
|
}, -10);
|
|
});
|
|
|
|
it("converts Frequency units", function(){
|
|
var signal = new Signal("50hz", Tone.Type.Frequency);
|
|
expect(signal.value).to.be.closeTo(50, 0.01);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("converts Time units", function(){
|
|
var signal = new Signal("4n", Tone.Type.Time);
|
|
expect(signal.value).to.be.closeTo(0.5, 0.01);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("converts NormalRange units", function(){
|
|
var signal = new Signal(2, Tone.Type.NormalRange);
|
|
expect(signal.value).to.be.closeTo(1, 0.01);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("converts AudioRange units", function(){
|
|
var signal = new Signal(-2, Tone.Type.AudioRange);
|
|
expect(signal.value).to.be.closeTo(-1, 0.01);
|
|
signal.dispose();
|
|
});
|
|
|
|
it("converts Positive units", function(){
|
|
var signal = new Signal(-2, Tone.Type.Positive);
|
|
expect(signal.value).to.be.closeTo(0, 0.01);
|
|
signal.dispose();
|
|
});
|
|
|
|
});
|
|
|
|
context("Transport Syncing", function(){
|
|
|
|
it("maintains its original value after being synced to the transport", function(){
|
|
return ConstantOutput(function(Transport){
|
|
var sig = new Signal(3).toMaster();
|
|
Transport.syncSignal(sig);
|
|
}, 3);
|
|
});
|
|
|
|
it("keeps the ratio when the bpm changes", function(){
|
|
return ConstantOutput(function(Transport){
|
|
Transport.bpm.value = 120;
|
|
var sig = new Signal(5).toMaster();
|
|
Transport.syncSignal(sig);
|
|
Transport.bpm.value = 240;
|
|
}, 10);
|
|
});
|
|
|
|
it("can ramp along with the bpm", function(){
|
|
return Offline(function(Transport){
|
|
Transport.bpm.value = 120;
|
|
var sig = new Signal(2).toMaster();
|
|
Transport.syncSignal(sig);
|
|
Transport.bpm.rampTo(240, 0.5);
|
|
}).then(function(buffer){
|
|
buffer.forEach(function(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", function(){
|
|
return ConstantOutput(function(Transport){
|
|
Transport.bpm.value = 120;
|
|
var sig = new Signal(5).toMaster();
|
|
Transport.syncSignal(sig);
|
|
Transport.bpm.value = 240;
|
|
Transport.unsyncSignal(sig);
|
|
}, 5);
|
|
});
|
|
});
|
|
|
|
context("LFO", function(){
|
|
|
|
it ("can create an LFO from the constructor", function(){
|
|
var sig = new Signal({
|
|
"lfo" : {
|
|
"min" : -20,
|
|
"max" : 20
|
|
}
|
|
});
|
|
expect(sig.lfo).to.be.instanceOf(LFO);
|
|
expect(sig.lfo.min).to.be.closeTo(-20, 0.1);
|
|
expect(sig.lfo.max).to.be.closeTo(20, 0.1);
|
|
});
|
|
|
|
it ("can set an LFO as the .value", function(){
|
|
var sig = new Signal();
|
|
sig.value = {
|
|
"min" : 20,
|
|
"max" : -20
|
|
};
|
|
expect(sig.lfo).to.be.instanceOf(LFO);
|
|
expect(sig.lfo.min).to.be.closeTo(20, 0.1);
|
|
expect(sig.lfo.max).to.be.closeTo(-20, 0.1);
|
|
});
|
|
|
|
it ("outputs a modulated signal", function(){
|
|
return Offline(function(){
|
|
new Signal({
|
|
"lfo" : {
|
|
"min" : 10,
|
|
"max" : 20
|
|
}
|
|
}).toMaster();
|
|
}, 0.4).then(function(buffer){
|
|
buffer.forEach(function(sample){
|
|
expect(sample).to.be.within(10, 20);
|
|
});
|
|
});
|
|
});
|
|
|
|
it ("can handle multiple levels of lfo", function(){
|
|
return Offline(function(){
|
|
new Signal({
|
|
"lfo" : {
|
|
"min" : 10,
|
|
"max" : 20,
|
|
"type" : "square",
|
|
"frequency" : {
|
|
"lfo" : {
|
|
"min" : 2,
|
|
"max" : 3,
|
|
"frequency" : 10,
|
|
}
|
|
},
|
|
"amplitude" : {
|
|
"lfo" : {
|
|
"min" : 0,
|
|
"max" : 1,
|
|
"frequency" : {
|
|
"lfo" : {
|
|
"min" : 2,
|
|
"max" : 3,
|
|
"frequency" : 10,
|
|
}
|
|
},
|
|
}
|
|
}
|
|
}
|
|
}).toMaster();
|
|
}, 0.4).then(function(buffer){
|
|
buffer.forEach(function(sample){
|
|
expect(sample).to.be.within(10, 20);
|
|
});
|
|
});
|
|
});
|
|
});
|
|
});
|
|
});
|