Tone.js/test/instrument/Sampler.js

import Sampler from "Tone/instrument/Sampler";
import Basic from "helper/Basic";
import InstrumentTest from "helper/InstrumentTests";
import Buffer from "Tone/core/Buffer";
import Offline from "helper/Offline";
import CompareToFile from "helper/CompareToFile";
import Test from "helper/Test";

describe("Sampler", function(){

	var A4_buffer = new Buffer();

	beforeEach(function(done){
		A4_buffer.load("./audio/sine.wav", function(){
			done();
		});
	});

	Basic(Sampler);

	InstrumentTest(Sampler, "A4", {
		69 : A4_buffer
	}, 1);

	it("matches a file", function(){
		return CompareToFile(function(){
			var sampler = new Sampler({
				69 : A4_buffer 
			}, {
				release : 0.4
			}).toMaster();
			sampler.triggerAttackRelease("C4", 0.1, 0, 0.2);
			sampler.triggerAttackRelease("E4", 0.1, 0.2, 0.4);
			sampler.triggerAttackRelease("G4", 0.1, 0.4, 0.6);
			sampler.triggerAttackRelease("B4", 0.1, 0.6, 0.8);
			sampler.triggerAttackRelease("C4", 0.1, 0.8);
		}, "sampler.wav", 0.01);
	});

	context("Constructor", function(){

		it("can be constructed with an options object", function(){
			var sampler = new Sampler({
				69 : A4_buffer
			}, {
				"attack" : 0.2,
				"release" : 0.3
			});
			expect(sampler.attack).to.equal(0.2);
			expect(sampler.release).to.equal(0.3);
			sampler.dispose();
		});

		it("urls can be described as either midi or notes", function(){
			return Offline(function(){
				var sampler = new Sampler({
					"A4" : A4_buffer
				}).toMaster();
				sampler.triggerAttack("A4");
			}).then(function(buffer){
				expect(buffer.isSilent()).to.be.false;
			});
		});

		it("throws an error if there are no available notes to play", function(){
			expect(function(){
				var sampler = new Sampler();
				sampler.triggerAttack("C4");
			}).throws(Error);
		});

		it("throws an error if the url key is not midi or pitch notation", function(){
			expect(function(){
				var sampler = new Sampler({
					"note" : A4_buffer
				});
			}).throws(Error);
		});

		it("can get and set envelope attributes", function(){
			var sampler = new Sampler();
			sampler.attack = 0.1;
			sampler.release = 0.1;
			expect(sampler.attack).to.equal(0.1);
			expect(sampler.release).to.equal(0.1);
			sampler.dispose();
		});

		it("invokes the callback when loaded", function(done){
			var sampler = new Sampler({
				"A4" : "./audio/sine.wav"
			}, function(){
				expect(sampler.loaded).to.be.true;
				done();
			});
		});

		it("can pass in a callback and baseUrl", function(done){
			var sampler = new Sampler({
				"A4" : A4_buffer
			}, function(){
				// expect(sampler.loaded).to.be.true;
				done();
			}, "./baseUrl");
		});

		it("can dispose while playing sounds", function(){
			return Offline(function(){
				var sampler = new Sampler({
					"A4" : A4_buffer
				}, {
					release : 0
				}).toMaster();
				sampler.triggerAttack("A4", 0);
				sampler.triggerRelease("A4", 0.2);
				sampler.dispose();
			}, 0.3);
		});

	});

	context("Makes sound", function(){

		it("repitches the note", function(){
			return Offline(function(){
				var sampler = new Sampler({
					"A4" : A4_buffer
				}).toMaster();
				sampler.triggerAttack("G4");
			}).then(function(buffer){
				expect(buffer.isSilent()).to.be.false;
			});
		});

		it("is silent after the release", function(){
			return Offline(function(){
				var sampler = new Sampler({
					"A4" : A4_buffer
				}, {
					release : 0
				}).toMaster();
				sampler.triggerAttack("A4", 0);
				sampler.triggerRelease("A4", 0.2);
			}, 0.3).then(function(buffer){
				expect(buffer.getLastSoundTime()).to.be.closeTo(0.2, 0.01);
			});
		});

		it("can triggerRelease after the buffer has already stopped", function(){
			return Offline(function(){
				var sampler = new Sampler({
					"A4" : A4_buffer
				}, {
					release : 0
				}).toMaster();
				sampler.triggerAttack("A4", 0);
				return Test.atTime(A4_buffer.duration + 0.01, function(){
					sampler.triggerRelease("A4");
				});
			}, A4_buffer.duration + 0.1).then(function(buffer){
				// expect(buffer.getLastSoundTime()).to.be.closeTo(0.2, 0.01);
			});
		});

		it("can release multiple notes", function(){
			return Offline(function(){
				var sampler = new Sampler({
					"A4" : A4_buffer
				}, {
					release : 0
				}).toMaster();
				sampler.triggerAttack("A4", 0);
				sampler.triggerAttack("C4", 0);
				sampler.triggerAttack("A4", 0.1);
				sampler.triggerAttack("G4", 0.1);
				sampler.releaseAll(0.2);
			}, 0.3).then(function(buffer){
				expect(buffer.getLastSoundTime()).to.be.closeTo(0.2, 0.01);
			});
		});

		it("can trigger the attack and release", function(){
			return Offline(function(){
				var sampler = new Sampler({
					"A4" : A4_buffer
				}, {
					release : 0
				}).toMaster();
				sampler.triggerAttackRelease("A4", 0.2, 0.1);
			}, 0.4).then(function(buffer){
				expect(buffer.getFirstSoundTime()).to.be.closeTo(0.1, 0.01);
				expect(buffer.getLastSoundTime()).to.be.closeTo(0.3, 0.01);
			});
		});

		it("can trigger polyphonic attack release", function(){
			return Offline(function(){
				var sampler = new Sampler({
					"A4" : A4_buffer
				}, {
					release : 0
				}).toMaster();
				sampler.triggerAttackRelease(["A4", "C4"], [0.2, 0.3], 0.1);
			}, 0.5).then(function(buffer){
				expect(buffer.getFirstSoundTime()).to.be.closeTo(0.1, 0.01);
				expect(buffer.getLastSoundTime()).to.be.closeTo(0.4, 0.01);
			});
		});
	});

	context("add samples", function(){

		it("can add a note with it's midi value", function(){
			return Offline(function(){
				var sampler = new Sampler().toMaster();
				sampler.add("69", A4_buffer);
				sampler.triggerAttack("B4");
			}).then(function(buffer){
				expect(buffer.isSilent()).to.be.false;
			});
		});

		it("can add a note with it's note name", function(){
			return Offline(function(){
				var sampler = new Sampler().toMaster();
				sampler.add("A4", A4_buffer);
				sampler.triggerAttack("G4");
			}).then(function(buffer){
				expect(buffer.isSilent()).to.be.false;
			});
		});

		it("can pass in a url and invokes the callback", function(done){
			var sampler = new Sampler();
			sampler.add("A4", "./audio/sine.wav", function(){
				done();
			});
		});

		it("throws an error if added note key is not midi or note name", function(){
			expect(function(){
				var sampler = new Sampler().toMaster();
				sampler.add("nope", A4_buffer);
			}).throws(Error);
		});
	});

});