nicholas@1: /**
nicholas@1:  * core.js
nicholas@1:  * 
nicholas@1:  * Main script to run, calls all other core functions and manages loading/store to backend.
nicholas@1:  * Also contains all global variables.
nicholas@1:  */
nicholas@1: 
nicholas@1: /* create the web audio API context and store in audioContext*/
n@33: var audioContext; // Hold the browser web audio API
n@33: var projectXML; // Hold the parsed setup XML
nicholas@116: var popup; // Hold the interfacePopup object
nicholas@129: var testState;
nicholas@116: var currentState; // Keep track of the current state (pre/post test, which test, final test? first test?)
nicholas@129: //var testXMLSetups = []; // Hold the parsed test instances
nicholas@129: //var testResultsHolders =[]; // Hold the results from each test for publishing to XML
n@45: var currentTrackOrder = []; // Hold the current XML tracks in their (randomised) order
nicholas@129: //var currentTestHolder; // Hold any intermediate results during test - metrics
n@33: var audioEngineContext; // The custome AudioEngine object
n@33: var projectReturn; // Hold the URL for the return
nicholas@129: //var preTestQuestions = document.createElement('PreTest'); // Store any pre-test question response
nicholas@129: //var postTestQuestions = document.createElement('PostTest'); // Store any post-test question response
nicholas@1: 
n@57: // Add a prototype to the bufferSourceNode to reference to the audioObject holding it
n@57: AudioBufferSourceNode.prototype.owner = undefined;
n@57: 
nicholas@1: window.onload = function() {
nicholas@1: 	// Function called once the browser has loaded all files.
nicholas@1: 	// This should perform any initial commands such as structure / loading documents
nicholas@1: 	
nicholas@1: 	// Create a web audio API context
nicholas@21: 	// Fixed for cross-browser support
nicholas@21: 	var AudioContext = window.AudioContext || window.webkitAudioContext;
nicholas@7: 	audioContext = new AudioContext;
nicholas@1: 	
nicholas@129: 	// Create test state
nicholas@129: 	testState = new stateMachine();
nicholas@129: 	
nicholas@1: 	// Create the audio engine object
nicholas@1: 	audioEngineContext = new AudioEngine();
nicholas@116: 	
nicholas@116: 	// Create the popup interface object
nicholas@116: 	popup = new interfacePopup();
n@16: };
nicholas@1: 
nicholas@116: function interfacePopup() {
nicholas@116: 	// Creates an object to manage the popup
nicholas@116: 	this.popup = null;
nicholas@116: 	this.popupContent = null;
nicholas@116: 	this.popupButton = null;
nicholas@116: 	this.popupOptions = null;
nicholas@116: 	this.currentIndex = null;
nicholas@116: 	this.responses = null;
nicholas@116: 	this.createPopup = function(){
nicholas@116: 		// Create popup window interface
nicholas@116: 		var insertPoint = document.getElementById("topLevelBody");
nicholas@116: 		var blank = document.createElement('div');
nicholas@116: 		blank.className = 'testHalt';
nicholas@116: 		
nicholas@116: 		this.popup = document.createElement('div');
nicholas@116: 		this.popup.id = 'popupHolder';
nicholas@116: 		this.popup.className = 'popupHolder';
nicholas@116: 		this.popup.style.position = 'absolute';
nicholas@116: 		this.popup.style.left = (window.innerWidth/2)-250 + 'px';
nicholas@116: 		this.popup.style.top = (window.innerHeight/2)-125 + 'px';
nicholas@116: 		
nicholas@116: 		this.popupContent = document.createElement('div');
nicholas@116: 		this.popupContent.id = 'popupContent';
nicholas@116: 		this.popupContent.style.marginTop = '25px';
nicholas@116: 		this.popupContent.align = 'center';
nicholas@116: 		this.popup.appendChild(this.popupContent);
nicholas@116: 		
nicholas@116: 		this.popupButton = document.createElement('button');
nicholas@116: 		this.popupButton.className = 'popupButton';
nicholas@116: 		this.popupButton.innerHTML = 'Next';
nicholas@116: 		this.popupButton.onclick = function(){popup.buttonClicked();};
nicholas@116: 		insertPoint.appendChild(this.popup);
nicholas@116: 		insertPoint.appendChild(blank);
nicholas@116: 	};
nicholas@114: 	
nicholas@116: 	this.showPopup = function(){
nicholas@116: 		if (this.popup == null || this.popup == undefined) {
nicholas@116: 			this.createPopup();
nicholas@116: 		}
nicholas@116: 		this.popup.style.zIndex = 3;
nicholas@116: 		this.popup.style.visibility = 'visible';
nicholas@116: 		var blank = document.getElementsByClassName('testHalt')[0];
nicholas@116: 		blank.style.zIndex = 2;
nicholas@116: 		blank.style.visibility = 'visible';
nicholas@116: 	};
nicholas@116: 	
nicholas@116: 	this.hidePopup = function(){
nicholas@116: 		this.popup.style.zIndex = -1;
nicholas@116: 		this.popup.style.visibility = 'hidden';
nicholas@116: 		var blank = document.getElementsByClassName('testHalt')[0];
nicholas@116: 		blank.style.zIndex = -2;
nicholas@116: 		blank.style.visibility = 'hidden';
nicholas@116: 	};
nicholas@116: 	
nicholas@116: 	this.postNode = function() {
nicholas@116: 		// This will take the node from the popupOptions and display it
nicholas@116: 		var node = this.popupOptions[this.currentIndex];
nicholas@116: 		this.popupContent.innerHTML = null;
nicholas@116: 		if (node.nodeName == 'statement') {
nicholas@116: 			var span = document.createElement('span');
nicholas@116: 			span.textContent = node.textContent;
nicholas@116: 			this.popupContent.appendChild(span);
nicholas@116: 		} else if (node.nodeName == 'question') {
nicholas@116: 			var span = document.createElement('span');
nicholas@116: 			span.textContent = node.textContent;
nicholas@116: 			var textArea = document.createElement('textarea');
nicholas@116: 			var br = document.createElement('br');
nicholas@116: 			this.popupContent.appendChild(span);
nicholas@116: 			this.popupContent.appendChild(br);
nicholas@116: 			this.popupContent.appendChild(textArea);
nicholas@116: 		}
nicholas@116: 		this.popupContent.appendChild(this.popupButton);
nicholas@116: 	}
nicholas@116: 	
nicholas@116: 	this.initState = function(node) {
nicholas@116: 		//Call this with your preTest and postTest nodes when needed to
nicholas@116: 		// initialise the popup procedure.
nicholas@116: 		this.popupOptions = $(node).children();
nicholas@116: 		if (this.popupOptions.length > 0) {
nicholas@116: 			if (node.nodeName == 'preTest' || node.nodeName == 'PreTest') {
nicholas@116: 				this.responses = document.createElement('PreTest');
nicholas@116: 			} else if (node.nodeName == 'postTest' || node.nodeName == 'PostTest') {
nicholas@116: 				this.responses = document.createElement('PostTest');
nicholas@116: 			} else {
nicholas@116: 				console.log ('WARNING - popup node neither pre or post!');
nicholas@116: 				this.responses = document.createElement('responses');
nicholas@116: 			}
nicholas@116: 			this.currentIndex = 0;
nicholas@116: 			this.showPopup();
nicholas@116: 			this.postNode();
nicholas@116: 		}
nicholas@116: 	}
nicholas@116: 	
nicholas@116: 	this.buttonClicked = function() {
nicholas@116: 		// Each time the popup button is clicked!
nicholas@116: 		var node = this.popupOptions[this.currentIndex];
nicholas@116: 		if (node.nodeName == 'question') {
nicholas@116: 			// Must extract the question data
nicholas@116: 			var mandatory = node.attributes['mandatory'];
nicholas@116: 			if (mandatory == undefined) {
nicholas@116: 				mandatory = false;
nicholas@116: 			} else {
nicholas@116: 				if (mandatory.value == 'true'){mandatory = true;}
nicholas@116: 				else {mandatory = false;}
nicholas@116: 			}
nicholas@116: 			var textArea = $(popup.popupContent).find('textarea')[0];
nicholas@116: 			if (mandatory == true && textArea.value.length == 0) {
nicholas@116: 				alert('This question is mandatory');
nicholas@116: 				return;
nicholas@116: 			} else {
nicholas@116: 				// Save the text content
nicholas@116: 				var hold = document.createElement('comment');
nicholas@116: 				hold.id = node.attributes['id'].value;
nicholas@116: 				hold.innerHTML = textArea.value;
nicholas@117: 				console.log("Question: "+ node.textContent);
nicholas@117: 				console.log("Question Response: "+ textArea.value);
nicholas@116: 				this.responses.appendChild(hold);
nicholas@116: 			}
nicholas@116: 		}
nicholas@116: 		this.currentIndex++;
nicholas@116: 		if (this.currentIndex < this.popupOptions.length) {
nicholas@116: 			this.postNode();
nicholas@116: 		} else {
nicholas@116: 			// Reached the end of the popupOptions
nicholas@116: 			this.hidePopup();
nicholas@129: 			if (this.responses.nodeName == testState.stateResults[testState.stateIndex].nodeName) {
nicholas@129: 				testState.stateResults[testState.stateIndex] = this.responses;
nicholas@129: 			} else {
nicholas@129: 				testState.stateResults[testState.stateIndex].appendChild(this.responses);
nicholas@129: 			}
nicholas@116: 			advanceState();
nicholas@116: 		}
nicholas@116: 	}
nicholas@114: }
nicholas@114: 
nicholas@116: function advanceState()
nicholas@114: {
nicholas@129: 	// Just for complete clarity
nicholas@129: 	testState.advanceState();
nicholas@129: }
nicholas@129: 
nicholas@129: function stateMachine()
nicholas@129: {
nicholas@129: 	// Object prototype for tracking and managing the test state
nicholas@129: 	this.stateMap = [];
nicholas@129: 	this.stateIndex = null;
nicholas@129: 	this.currentStateMap = [];
nicholas@129: 	this.currentIndex = null;
nicholas@129: 	this.currentTestId = 0;
nicholas@129: 	this.stateResults = [];
nicholas@135: 	this.timerCallBackHolders = null;
nicholas@129: 	this.initialise = function(){
nicholas@129: 		if (this.stateMap.length > 0) {
nicholas@129: 			if(this.stateIndex != null) {
nicholas@129: 				console.log('NOTE - State already initialise');
nicholas@129: 			}
nicholas@129: 			this.stateIndex = -1;
nicholas@129: 			var that = this;
nicholas@129: 			for (var id=0; id<this.stateMap.length; id++){
nicholas@129: 				var name = this.stateMap[id].nodeName;
nicholas@129: 				var obj = document.createElement(name);
n@149: 				if (name == "audioHolder") {
n@149: 					obj.id = this.stateMap[id].id;
n@149: 				}
nicholas@129: 				this.stateResults.push(obj);
nicholas@129: 			}
nicholas@129: 		} else {
nicholas@129: 			conolse.log('FATAL - StateMap not correctly constructed. EMPTY_STATE_MAP');
nicholas@116: 		}
nicholas@129: 	};
nicholas@129: 	this.advanceState = function(){
nicholas@129: 		if (this.stateIndex == null) {
nicholas@129: 			this.initialise();
nicholas@129: 		}
nicholas@129: 		if (this.stateIndex == -1) {
nicholas@129: 			console.log('Starting test...');
nicholas@129: 		}
nicholas@129: 		if (this.currentIndex == null){
nicholas@129: 			if (this.currentStateMap.nodeName == "audioHolder") {
nicholas@129: 				// Save current page
nicholas@129: 				this.testPageCompleted(this.stateResults[this.stateIndex],this.currentStateMap,this.currentTestId);
nicholas@129: 				this.currentTestId++;
nicholas@129: 			}
nicholas@129: 			this.stateIndex++;
nicholas@129: 			if (this.stateIndex >= this.stateMap.length) {
nicholas@129: 				console.log('Test Completed');
nicholas@129: 				createProjectSave(projectReturn);
nicholas@129: 			} else {
nicholas@129: 				this.currentStateMap = this.stateMap[this.stateIndex];
nicholas@129: 				if (this.currentStateMap.nodeName == "audioHolder") {
nicholas@129: 					console.log('Loading test page');
nicholas@129: 					loadTest(this.currentStateMap);
nicholas@129: 					this.initialiseInnerState(this.currentStateMap);
nicholas@129: 				} else if (this.currentStateMap.nodeName == "PreTest" || this.currentStateMap.nodeName == "PostTest") {
nicholas@129: 					if (this.currentStateMap.childElementCount >= 1) {
nicholas@129: 						popup.initState(this.currentStateMap);
nicholas@129: 					} else {
nicholas@129: 						this.advanceState();
nicholas@129: 					}
nicholas@129: 				} else {
nicholas@129: 					this.advanceState();
nicholas@129: 				}
nicholas@129: 			}
nicholas@129: 		} else {
nicholas@129: 			this.advanceInnerState();
nicholas@129: 		}
nicholas@129: 	};
nicholas@129: 	
nicholas@129: 	this.testPageCompleted = function(store, testXML, testId) {
nicholas@129: 		// Function called each time a test page has been completed
nicholas@129: 		// Can be used to over-rule default behaviour
nicholas@129: 		
nicholas@129: 		pageXMLSave(store, testXML, testId);
nicholas@129: 	}
nicholas@129: 	
nicholas@129: 	this.initialiseInnerState = function(testXML) {
nicholas@129: 		// Parses the received testXML for pre and post test options
nicholas@129: 		this.currentStateMap = [];
nicholas@129: 		var preTest = $(testXML).find('PreTest')[0];
nicholas@129: 		var postTest = $(testXML).find('PostTest')[0];
nicholas@129: 		if (preTest == undefined) {preTest = document.createElement("preTest");}
nicholas@129: 		if (postTest == undefined){postTest= document.createElement("postTest");}
nicholas@129: 		this.currentStateMap.push(preTest);
nicholas@129: 		this.currentStateMap.push(testXML);
nicholas@129: 		this.currentStateMap.push(postTest);
nicholas@129: 		this.currentIndex = -1;
nicholas@129: 		this.advanceInnerState();
nicholas@129: 	}
nicholas@129: 	
nicholas@129: 	this.advanceInnerState = function() {
nicholas@129: 		this.currentIndex++;
nicholas@129: 		if (this.currentIndex >= this.currentStateMap.length) {
nicholas@129: 			this.currentIndex = null;
nicholas@129: 			this.currentStateMap = this.stateMap[this.stateIndex];
nicholas@129: 			this.advanceState();
nicholas@129: 		} else {
nicholas@129: 			if (this.currentStateMap[this.currentIndex].nodeName == "audioHolder") {
nicholas@129: 				console.log("Loading test page"+this.currentTestId);
nicholas@129: 			} else if (this.currentStateMap[this.currentIndex].nodeName == "PreTest") {
nicholas@129: 				popup.initState(this.currentStateMap[this.currentIndex]);
nicholas@129: 			} else if (this.currentStateMap[this.currentIndex].nodeName == "PostTest") {
nicholas@129: 				popup.initState(this.currentStateMap[this.currentIndex]);
nicholas@129: 			} else {
nicholas@129: 				this.advanceInnerState();
nicholas@129: 			}
nicholas@116: 		}
nicholas@114: 	}
nicholas@129: 	
nicholas@129: 	this.previousState = function(){};
nicholas@114: }
nicholas@114: 
nicholas@116: function testEnded(testId)
nicholas@114: {
nicholas@116: 	pageXMLSave(testId);
nicholas@116: 	if (testXMLSetups.length-1 > testId)
nicholas@116: 	{
nicholas@116: 		// Yes we have another test to perform
nicholas@116: 		testId = (Number(testId)+1);
nicholas@116: 		currentState = 'testRun-'+testId;
nicholas@116: 		loadTest(testId);
nicholas@116: 	} else {
nicholas@116: 		console.log('Testing Completed!');
nicholas@116: 		currentState = 'postTest';
nicholas@116: 		// Check for any post tests
nicholas@116: 		var xmlSetup = projectXML.find('setup');
nicholas@116: 		var postTest = xmlSetup.find('PostTest')[0];
nicholas@116: 		popup.initState(postTest);
nicholas@116: 	}
nicholas@114: }
nicholas@114: 
nicholas@1: function loadProjectSpec(url) {
nicholas@1: 	// Load the project document from the given URL, decode the XML and instruct audioEngine to get audio data
nicholas@1: 	// If url is null, request client to upload project XML document
nicholas@2: 	var r = new XMLHttpRequest();
nicholas@2: 	r.open('GET',url,true);
nicholas@2: 	r.onload = function() {
nicholas@2: 		loadProjectSpecCallback(r.response);
n@16: 	};
nicholas@2: 	r.send();
n@16: };
nicholas@2: 
nicholas@2: function loadProjectSpecCallback(response) {
nicholas@2: 	// Function called after asynchronous download of XML project specification
nicholas@2: 	var decode = $.parseXML(response);
nicholas@2: 	projectXML = $(decode);
nicholas@2: 	
nicholas@2: 	// Now extract the setup tag
nicholas@2: 	var xmlSetup = projectXML.find('setup');
n@16: 	// Detect the interface to use and load the relevant javascripts.
nicholas@2: 	var interfaceType = xmlSetup[0].attributes['interface'];
nicholas@2: 	var interfaceJS = document.createElement('script');
nicholas@2: 	interfaceJS.setAttribute("type","text/javascript");
nicholas@2: 	if (interfaceType.value == 'APE') {
nicholas@2: 		interfaceJS.setAttribute("src","ape.js");
n@33: 		
n@33: 		// APE comes with a css file
n@33: 		var css = document.createElement('link');
n@33: 		css.rel = 'stylesheet';
n@33: 		css.type = 'text/css';
n@33: 		css.href = 'ape.css';
n@33: 		
n@33: 		document.getElementsByTagName("head")[0].appendChild(css);
nicholas@2: 	}
nicholas@2: 	document.getElementsByTagName("head")[0].appendChild(interfaceJS);
n@127: 	
n@127: 	// Define window callbacks for interface
n@127: 	window.onresize = function(event){resizeWindow(event);};
nicholas@1: }
nicholas@1: 
nicholas@1: function createProjectSave(destURL) {
nicholas@1: 	// Save the data from interface into XML and send to destURL
nicholas@1: 	// If destURL is null then download XML in client
nicholas@7: 	// Now time to render file locally
nicholas@7: 	var xmlDoc = interfaceXMLSave();
nicholas@122: 	var parent = document.createElement("div");
nicholas@122: 	parent.appendChild(xmlDoc);
nicholas@122: 	var file = [parent.innerHTML];
nicholas@7: 	if (destURL == "null" || destURL == undefined) {
nicholas@7: 		var bb = new Blob(file,{type : 'application/xml'});
nicholas@7: 		var dnlk = window.URL.createObjectURL(bb);
nicholas@7: 		var a = document.createElement("a");
nicholas@7: 		a.hidden = '';
nicholas@7: 		a.href = dnlk;
nicholas@7: 		a.download = "save.xml";
nicholas@7: 		a.textContent = "Save File";
nicholas@7: 		
nicholas@7: 		var submitDiv = document.getElementById('download-point');
nicholas@7: 		submitDiv.appendChild(a);
nicholas@118: 		popup.showPopup();
nicholas@118: 		popup.popupContent.innerHTML = null;
nicholas@118: 		popup.popupContent.appendChild(submitDiv)
nicholas@122: 	} else {
nicholas@122: 		var xmlhttp = new XMLHttpRequest;
nicholas@122: 		xmlhttp.open("POST",destURL,true);
nicholas@122: 		xmlhttp.setRequestHeader('Content-Type', 'text/xml');
n@123: 		xmlhttp.onerror = function(){
n@123: 			console.log('Error saving file to server! Presenting download locally');
n@123: 			createProjectSave(null);
n@123: 		};
nicholas@122: 		xmlhttp.send(file);
nicholas@7: 	}
n@43: 	return submitDiv;
nicholas@1: }
nicholas@1: 
nicholas@129: // Only other global function which must be defined in the interface class. Determines how to create the XML document.
nicholas@129: function interfaceXMLSave(){
nicholas@129: 	// Create the XML string to be exported with results
nicholas@129: 	var xmlDoc = document.createElement("BrowserEvaluationResult");
nicholas@129: 	xmlDoc.appendChild(returnDateNode());
nicholas@129: 	for (var i=0; i<testState.stateResults.length; i++)
nicholas@129: 	{
nicholas@129: 		xmlDoc.appendChild(testState.stateResults[i]);
nicholas@129: 	}
nicholas@129: 	
nicholas@129: 	return xmlDoc;
nicholas@129: }
nicholas@129: 
nicholas@1: function AudioEngine() {
nicholas@1: 	
nicholas@1: 	// Create two output paths, the main outputGain and fooGain.
nicholas@1: 	// Output gain is default to 1 and any items for playback route here
nicholas@1: 	// Foo gain is used for analysis to ensure paths get processed, but are not heard
nicholas@1: 	// because web audio will optimise and any route which does not go to the destination gets ignored.
nicholas@1: 	this.outputGain = audioContext.createGain();
nicholas@1: 	this.fooGain = audioContext.createGain();
nicholas@1: 	this.fooGain.gain = 0;
nicholas@1: 	
nicholas@7: 	// Use this to detect playback state: 0 - stopped, 1 - playing
nicholas@7: 	this.status = 0;
n@113: 	this.audioObjectsReady = false;
nicholas@7: 	
nicholas@1: 	// Connect both gains to output
nicholas@1: 	this.outputGain.connect(audioContext.destination);
nicholas@1: 	this.fooGain.connect(audioContext.destination);
nicholas@1: 	
n@49: 	// Create the timer Object
n@49: 	this.timer = new timer();
n@49: 	// Create session metrics
n@49: 	this.metric = new sessionMetrics(this);
n@49: 	
n@57: 	this.loopPlayback = false;
n@57: 	
nicholas@1: 	// Create store for new audioObjects
nicholas@1: 	this.audioObjects = [];
nicholas@1: 	
n@113: 	this.play = function() {
n@113: 		// Start the timer and set the audioEngine state to playing (1)
n@113: 		if (this.status == 0) {
n@113: 			// Check if all audioObjects are ready
n@113: 			if (this.audioObjectsReady == false) {
n@113: 				this.audioObjectsReady = this.checkAllReady();
n@113: 			}
n@113: 			if (this.audioObjectsReady == true) {
n@113: 				this.timer.startTest();
nicholas@131: 				if (this.loopPlayback) {
nicholas@131: 					for(var i=0; i<this.audioObjects.length; i++) {
nicholas@131: 						this.audioObjects[i].play(this.timer.getTestTime()+1);
nicholas@131: 					}
nicholas@131: 				}
n@113: 				this.status = 1;
n@113: 			}
n@113: 		}
n@113: 	};
nicholas@1: 	
n@113: 	this.stop = function() {
n@113: 		// Send stop and reset command to all playback buffers and set audioEngine state to stopped (1)
n@113: 		if (this.status == 1) {
n@113: 			for (var i=0; i<this.audioObjects.length; i++)
n@113: 			{
n@113: 				this.audioObjects[i].stop();
n@113: 			}
n@113: 			this.status = 0;
n@113: 		}
n@113: 	};
nicholas@8: 	
nicholas@8: 	
nicholas@1: 	this.newTrack = function(url) {
nicholas@1: 		// Pull data from given URL into new audio buffer
nicholas@1: 		// URLs must either be from the same source OR be setup to 'Access-Control-Allow-Origin'
nicholas@7: 		
nicholas@1: 		// Create the audioObject with ID of the new track length;
n@49: 		audioObjectId = this.audioObjects.length;
nicholas@1: 		this.audioObjects[audioObjectId] = new audioObject(audioObjectId);
nicholas@7: 
nicholas@7: 		// AudioObject will get track itself.
nicholas@7: 		this.audioObjects[audioObjectId].constructTrack(url);
n@16: 	};
nicholas@1: 	
n@113: 	this.newTestPage = function() {
n@113: 		this.state = 0;
n@113: 		this.audioObjectsReady = false;
n@113: 		this.metric.reset();
n@113: 		this.audioObjects = [];
n@113: 	};
n@113: 	
nicholas@107: 	this.checkAllPlayed = function() {
nicholas@107: 		arr = [];
nicholas@107: 		for (var id=0; id<this.audioObjects.length; id++) {
nicholas@142: 			if (this.audioObjects[id].metric.wasListenedTo == false) {
nicholas@107: 				arr.push(this.audioObjects[id].id);
nicholas@107: 			}
nicholas@107: 		}
nicholas@107: 		return arr;
nicholas@107: 	};
nicholas@107: 	
n@113: 	this.checkAllReady = function() {
n@113: 		var ready = true;
n@113: 		for (var i=0; i<this.audioObjects.length; i++) {
n@113: 			if (this.audioObjects[i].state == 0) {
n@113: 				// Track not ready
n@113: 				console.log('WAIT -- audioObject '+i+' not ready yet!');
n@113: 				ready = false;
n@113: 			};
n@113: 		}
nicholas@135: 		if (ready == false) {
nicholas@135: 			var holder = document.getElementById('testWaitIndicator');
nicholas@135: 			holder.style.visibility = "visible";
nicholas@135: 			setInterval(function() {
nicholas@135: 				document.getElementById('testWaitIndicator').style.visibility = "hidden";
nicholas@135: 			}, 10000);
nicholas@135: 		}
n@113: 		return ready;
n@113: 	};
n@113: 	
nicholas@1: }
nicholas@1: 
nicholas@1: function audioObject(id) {
nicholas@1: 	// The main buffer object with common control nodes to the AudioEngine
nicholas@1: 	
nicholas@1: 	this.id = id;
nicholas@1: 	this.state = 0; // 0 - no data, 1 - ready
n@24: 	this.url = null; // Hold the URL given for the output back to the results.
n@139: 	this.metric = new metricTracker(this);
nicholas@1: 	
nicholas@1: 	// Create a buffer and external gain control to allow internal patching of effects and volume leveling.
n@57: 	this.bufferNode = undefined;
nicholas@1: 	this.outputGain = audioContext.createGain();
nicholas@1: 	
nicholas@8: 	// Default output gain to be zero
nicholas@8: 	this.outputGain.gain.value = 0.0;
nicholas@8: 	
nicholas@1: 	// Connect buffer to the audio graph
nicholas@1: 	this.outputGain.connect(audioEngineContext.outputGain);
nicholas@1: 	
nicholas@1: 	// the audiobuffer is not designed for multi-start playback
nicholas@1: 	// When stopeed, the buffer node is deleted and recreated with the stored buffer.
nicholas@1: 	this.buffer;
b@134:     
nicholas@132: 	this.loopStart = function() {
nicholas@132: 		this.outputGain.gain.value = 1.0;
nicholas@132: 		this.metric.startListening(audioEngineContext.timer.getTestTime());
nicholas@132: 	}
nicholas@132: 	
nicholas@132: 	this.loopStop = function() {
nicholas@132: 		if (this.outputGain.gain.value != 0.0) {
nicholas@132: 			this.outputGain.gain.value = 0.0;
nicholas@132: 			this.metric.stopListening(audioEngineContext.timer.getTestTime());
nicholas@132: 		}
nicholas@132: 	}
nicholas@132: 	
nicholas@1: 	this.play = function(startTime) {
n@57: 		this.bufferNode = audioContext.createBufferSource();
nicholas@110: 		this.bufferNode.owner = this;
n@57: 		this.bufferNode.connect(this.outputGain);
n@57: 		this.bufferNode.buffer = this.buffer;
n@57: 		this.bufferNode.loop = audioEngineContext.loopPlayback;
nicholas@132: 		this.bufferNode.onended = function() {
nicholas@142: 			// Safari does not like using 'this' to reference the calling object!
nicholas@143: 			event.srcElement.owner.metric.stopListening(audioEngineContext.timer.getTestTime());
nicholas@142: 		};
nicholas@110: 		if (this.bufferNode.loop == false) {
nicholas@132: 			this.metric.startListening(audioEngineContext.timer.getTestTime());
nicholas@110: 		}
nicholas@1: 		this.bufferNode.start(startTime);
n@16: 	};
nicholas@1: 	
nicholas@1: 	this.stop = function() {
n@97: 		if (this.bufferNode != undefined)
n@97: 		{
n@97: 			this.bufferNode.stop(0);
n@97: 			this.bufferNode = undefined;
nicholas@132: 			this.metric.stopListening(audioEngineContext.timer.getTestTime());
n@97: 		}
n@16: 	};
nicholas@8: 
nicholas@7: 	this.constructTrack = function(url) {
nicholas@7: 		var request = new XMLHttpRequest();
n@24: 		this.url = url;
nicholas@7: 		request.open('GET',url,true);
nicholas@7: 		request.responseType = 'arraybuffer';
nicholas@7: 		
nicholas@7: 		var audioObj = this;
nicholas@7: 		
nicholas@7: 		// Create callback to decode the data asynchronously
nicholas@7: 		request.onloadend = function() {
nicholas@7: 			audioContext.decodeAudioData(request.response, function(decodedData) {
nicholas@7: 				audioObj.buffer = decodedData;
nicholas@7: 				audioObj.state = 1;
nicholas@7: 			}, function(){
nicholas@7: 				// Should only be called if there was an error, but sometimes gets called continuously
nicholas@7: 				// Check here if the error is genuine
nicholas@7: 				if (audioObj.state == 0 || audioObj.buffer == undefined) {
nicholas@7: 					// Genuine error
nicholas@7: 					console.log('FATAL - Error loading buffer on '+audioObj.id);
nicholas@7: 				}
nicholas@7: 			});
n@16: 		};
nicholas@7: 		request.send();
n@16: 	};
nicholas@7: 	
n@49: }
n@49: 
n@49: function timer()
n@49: {
n@49: 	/* Timer object used in audioEngine to keep track of session timings
n@49: 	 * Uses the timer of the web audio API, so sample resolution
n@49: 	 */
n@49: 	this.testStarted = false;
n@49: 	this.testStartTime = 0;
n@49: 	this.testDuration = 0;
n@49: 	this.minimumTestTime = 0; // No minimum test time
n@49: 	this.startTest = function()
n@49: 	{
n@49: 		if (this.testStarted == false)
n@49: 		{
n@49: 			this.testStartTime = audioContext.currentTime;
n@49: 			this.testStarted = true;
n@49: 			this.updateTestTime();
n@52: 			audioEngineContext.metric.initialiseTest();
n@49: 		}
n@49: 	};
n@49: 	this.stopTest = function()
n@49: 	{
n@49: 		if (this.testStarted)
n@49: 		{
n@49: 			this.testDuration = this.getTestTime();
n@49: 			this.testStarted = false;
n@49: 		} else {
n@49: 			console.log('ERR: Test tried to end before beginning');
n@49: 		}
n@49: 	};
n@49: 	this.updateTestTime = function()
n@49: 	{
n@49: 		if (this.testStarted)
n@49: 		{
n@49: 			this.testDuration = audioContext.currentTime - this.testStartTime;
n@49: 		}
n@49: 	};
n@49: 	this.getTestTime = function()
n@49: 	{
n@49: 		this.updateTestTime();
n@49: 		return this.testDuration;
n@49: 	};
n@49: }
n@49: 
n@49: function sessionMetrics(engine)
n@49: {
n@49: 	/* Used by audioEngine to link to audioObjects to minimise the timer call timers;
n@49: 	 */
n@49: 	this.engine = engine;
n@49: 	this.lastClicked = -1;
n@49: 	this.data = -1;
n@113: 	this.reset = function() {
n@113: 		this.lastClicked = -1;
n@113: 		this.data = -1;
n@113: 	};
n@52: 	this.initialiseTest = function(){};
n@49: }
n@49: 
n@139: function metricTracker(caller)
n@49: {
n@49: 	/* Custom object to track and collect metric data
n@49: 	 * Used only inside the audioObjects object.
n@49: 	 */
n@49: 	
n@49: 	this.listenedTimer = 0;
n@49: 	this.listenStart = 0;
nicholas@110: 	this.listenHold = false;
n@51: 	this.initialPosition = -1;
n@49: 	this.movementTracker = [];
n@49: 	this.wasListenedTo = false;
n@49: 	this.wasMoved = false;
n@49: 	this.hasComments = false;
n@139: 	this.parent = caller;
n@49: 	
n@49: 	this.initialised = function(position)
n@49: 	{
n@51: 		if (this.initialPosition == -1) {
n@51: 			this.initialPosition = position;
n@51: 		}
n@49: 	};
n@49: 	
n@49: 	this.moved = function(time,position)
n@49: 	{
n@49: 		this.wasMoved = true;
n@49: 		this.movementTracker[this.movementTracker.length] = [time, position];
n@49: 	};
n@49: 	
nicholas@132: 	this.startListening = function(time)
n@49: 	{
nicholas@110: 		if (this.listenHold == false)
n@49: 		{
n@49: 			this.wasListenedTo = true;
n@49: 			this.listenStart = time;
nicholas@110: 			this.listenHold = true;
n@139: 			console.log('slider ' + this.parent.id + ' played (' + time + ')'); // DEBUG/SAFETY: show played slider id
n@139: 		}
n@139: 	};
nicholas@132: 	
nicholas@132: 	this.stopListening = function(time)
nicholas@132: 	{
nicholas@132: 		if (this.listenHold == true)
nicholas@132: 		{
n@49: 			this.listenedTimer += (time - this.listenStart);
n@49: 			this.listenStart = 0;
nicholas@110: 			this.listenHold = false;
n@49: 		}
n@49: 	};
n@54: }
n@54: 
n@54: function randomiseOrder(input)
n@54: {
n@54: 	// This takes an array of information and randomises the order
n@54: 	var N = input.length;
n@54: 	var K = N;
n@54: 	var holdArr = [];
n@54: 	for (var n=0; n<N; n++)
n@54: 	{
n@54: 		// First pick a random number
n@54: 		var r = Math.random();
n@54: 		// Multiply and floor by the number of elements left
n@54: 		r = Math.floor(r*input.length);
n@54: 		// Pick out that element and delete from the array
n@54: 		holdArr.push(input.splice(r,1)[0]);
n@54: 	}
n@54: 	return holdArr;
n@125: }
n@125: 
n@125: function returnDateNode()
n@125: {
n@125: 	// Create an XML Node for the Date and Time a test was conducted
n@125: 	// Structure is
n@125: 	// <datetime> 
n@125: 	//	<date year="##" month="##" day="##">DD/MM/YY</date>
n@125: 	//	<time hour="##" minute="##" sec="##">HH:MM:SS</time>
n@125: 	// </datetime>
n@125: 	var dateTime = new Date();
n@125: 	var year = document.createAttribute('year');
n@125: 	var month = document.createAttribute('month');
n@125: 	var day = document.createAttribute('day');
n@125: 	var hour = document.createAttribute('hour');
n@125: 	var minute = document.createAttribute('minute');
n@125: 	var secs = document.createAttribute('secs');
n@125: 	
n@125: 	year.nodeValue = dateTime.getFullYear();
n@125: 	month.nodeValue = dateTime.getMonth()+1;
n@125: 	day.nodeValue = dateTime.getDate();
n@125: 	hour.nodeValue = dateTime.getHours();
n@125: 	minute.nodeValue = dateTime.getMinutes();
n@125: 	secs.nodeValue = dateTime.getSeconds();
n@125: 	
n@125: 	var hold = document.createElement("datetime");
n@125: 	var date = document.createElement("date");
n@125: 	date.textContent = year.nodeValue+'/'+month.nodeValue+'/'+day.nodeValue;
n@125: 	var time = document.createElement("time");
n@125: 	time.textContent = hour.nodeValue+':'+minute.nodeValue+':'+secs.nodeValue;
n@125: 	
n@125: 	date.setAttributeNode(year);
n@125: 	date.setAttributeNode(month);
n@125: 	date.setAttributeNode(day);
n@125: 	time.setAttributeNode(hour);
n@125: 	time.setAttributeNode(minute);
n@125: 	time.setAttributeNode(secs);
n@125: 	
n@125: 	hold.appendChild(date);
n@125: 	hold.appendChild(time);
n@125: 	return hold
n@125: 	
nicholas@135: }
nicholas@135: 
nicholas@135: function testWaitIndicator() {
nicholas@135: 	var hold = document.createElement("div");
nicholas@135: 	hold.id = "testWaitIndicator";
nicholas@135: 	hold.style.position = "absolute";
nicholas@135: 	hold.style.left = "100px";
nicholas@135: 	hold.style.top = "10px";
nicholas@135: 	hold.style.width = "500px";
nicholas@135: 	hold.style.height = "100px";
nicholas@135: 	hold.style.padding = "20px";
nicholas@135: 	hold.style.backgroundColor = "rgb(100,200,200)";
nicholas@135: 	hold.style.visibility = "hidden";
nicholas@135: 	var span = document.createElement("span");
nicholas@135: 	span.textContent = "Please wait! Elements still loading";
nicholas@135: 	hold.appendChild(span);
nicholas@135: 	var body = document.getElementsByTagName('body')[0];
nicholas@135: 	body.appendChild(hold);
nicholas@135: }
nicholas@135: 
nicholas@135: var hidetestwait = null;