nickjillings@1575: /**
nickjillings@1575:  * core.js
nickjillings@1575:  * 
nickjillings@1575:  * Main script to run, calls all other core functions and manages loading/store to backend.
nickjillings@1575:  * Also contains all global variables.
nickjillings@1575:  */
nickjillings@1575: 
nickjillings@1575: /* create the web audio API context and store in audioContext*/
nickjillings@1575: var audioContext; // Hold the browser web audio API
nickjillings@1575: var projectXML; // Hold the parsed setup XML
nickjillings@1581: var specification;
nickjillings@1575: var popup; // Hold the interfacePopup object
nickjillings@1575: var testState;
nickjillings@1575: var currentTrackOrder = []; // Hold the current XML tracks in their (randomised) order
nickjillings@1575: var audioEngineContext; // The custome AudioEngine object
nickjillings@1575: var projectReturn; // Hold the URL for the return
nickjillings@1575: 
nickjillings@1575: 
nickjillings@1575: // Add a prototype to the bufferSourceNode to reference to the audioObject holding it
nickjillings@1575: AudioBufferSourceNode.prototype.owner = undefined;
nickjillings@1575: 
nickjillings@1575: window.onload = function() {
nickjillings@1575: 	// Function called once the browser has loaded all files.
nickjillings@1575: 	// This should perform any initial commands such as structure / loading documents
nickjillings@1575: 	
nickjillings@1575: 	// Create a web audio API context
nickjillings@1575: 	// Fixed for cross-browser support
nickjillings@1575: 	var AudioContext = window.AudioContext || window.webkitAudioContext;
nickjillings@1575: 	audioContext = new AudioContext;
nickjillings@1575: 	
nickjillings@1575: 	// Create test state
nickjillings@1575: 	testState = new stateMachine();
nickjillings@1575: 	
nickjillings@1575: 	// Create the audio engine object
nickjillings@1575: 	audioEngineContext = new AudioEngine();
nickjillings@1575: 	
nickjillings@1575: 	// Create the popup interface object
nickjillings@1575: 	popup = new interfacePopup();
nickjillings@1581: 	
nickjillings@1581: 	// Create the specification object
nickjillings@1581: 	specification = new Specification();
nickjillings@1575: };
nickjillings@1575: 
nickjillings@1575: function interfacePopup() {
nickjillings@1575: 	// Creates an object to manage the popup
nickjillings@1575: 	this.popup = null;
nickjillings@1575: 	this.popupContent = null;
nickjillings@1575: 	this.popupButton = null;
nickjillings@1575: 	this.popupOptions = null;
nickjillings@1575: 	this.currentIndex = null;
nickjillings@1575: 	this.responses = null;
nickjillings@1581: 	
nickjillings@1575: 	this.createPopup = function(){
nickjillings@1575: 		// Create popup window interface
nickjillings@1575: 		var insertPoint = document.getElementById("topLevelBody");
nickjillings@1575: 		var blank = document.createElement('div');
nickjillings@1575: 		blank.className = 'testHalt';
nickjillings@1575: 		
nickjillings@1575: 		this.popup = document.createElement('div');
nickjillings@1575: 		this.popup.id = 'popupHolder';
nickjillings@1575: 		this.popup.className = 'popupHolder';
nickjillings@1575: 		this.popup.style.position = 'absolute';
nickjillings@1575: 		this.popup.style.left = (window.innerWidth/2)-250 + 'px';
nickjillings@1575: 		this.popup.style.top = (window.innerHeight/2)-125 + 'px';
nickjillings@1575: 		
nickjillings@1575: 		this.popupContent = document.createElement('div');
nickjillings@1575: 		this.popupContent.id = 'popupContent';
nickjillings@1575: 		this.popupContent.style.marginTop = '25px';
nickjillings@1575: 		this.popupContent.align = 'center';
nickjillings@1575: 		this.popup.appendChild(this.popupContent);
nickjillings@1575: 		
nickjillings@1575: 		this.popupButton = document.createElement('button');
nickjillings@1575: 		this.popupButton.className = 'popupButton';
nickjillings@1575: 		this.popupButton.innerHTML = 'Next';
nickjillings@1575: 		this.popupButton.onclick = function(){popup.buttonClicked();};
nickjillings@1581: 		this.popup.style.zIndex = -1;
nickjillings@1581: 		this.popup.style.visibility = 'hidden';
nickjillings@1581: 		blank.style.zIndex = -2;
nickjillings@1581: 		blank.style.visibility = 'hidden';
nickjillings@1575: 		insertPoint.appendChild(this.popup);
nickjillings@1575: 		insertPoint.appendChild(blank);
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.showPopup = function(){
nickjillings@1581: 		if (this.popup == null) {
nickjillings@1575: 			this.createPopup();
nickjillings@1575: 		}
nickjillings@1575: 		this.popup.style.zIndex = 3;
nickjillings@1575: 		this.popup.style.visibility = 'visible';
nickjillings@1575: 		var blank = document.getElementsByClassName('testHalt')[0];
nickjillings@1575: 		blank.style.zIndex = 2;
nickjillings@1575: 		blank.style.visibility = 'visible';
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.hidePopup = function(){
nickjillings@1575: 		this.popup.style.zIndex = -1;
nickjillings@1575: 		this.popup.style.visibility = 'hidden';
nickjillings@1575: 		var blank = document.getElementsByClassName('testHalt')[0];
nickjillings@1575: 		blank.style.zIndex = -2;
nickjillings@1575: 		blank.style.visibility = 'hidden';
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.postNode = function() {
nickjillings@1575: 		// This will take the node from the popupOptions and display it
nickjillings@1575: 		var node = this.popupOptions[this.currentIndex];
nickjillings@1575: 		this.popupContent.innerHTML = null;
nickjillings@1581: 		if (node.type == 'statement') {
nickjillings@1575: 			var span = document.createElement('span');
nickjillings@1581: 			span.textContent = node.statement;
nickjillings@1575: 			this.popupContent.appendChild(span);
nickjillings@1581: 		} else if (node.type == 'question') {
nickjillings@1575: 			var span = document.createElement('span');
nickjillings@1581: 			span.textContent = node.question;
nickjillings@1575: 			var textArea = document.createElement('textarea');
nickjillings@1575: 			var br = document.createElement('br');
nickjillings@1575: 			this.popupContent.appendChild(span);
nickjillings@1575: 			this.popupContent.appendChild(br);
nickjillings@1575: 			this.popupContent.appendChild(textArea);
nickjillings@1575: 			this.popupContent.childNodes[2].focus();
nickjillings@1575: 		}
nickjillings@1575: 		this.popupContent.appendChild(this.popupButton);
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.initState = function(node) {
nickjillings@1575: 		//Call this with your preTest and postTest nodes when needed to
nickjillings@1575: 		// initialise the popup procedure.
nickjillings@1581: 		this.popupOptions = node.options;
nickjillings@1575: 		if (this.popupOptions.length > 0) {
nickjillings@1581: 			if (node.type == 'pretest') {
nickjillings@1575: 				this.responses = document.createElement('PreTest');
nickjillings@1581: 			} else if (node.type == 'posttest') {
nickjillings@1575: 				this.responses = document.createElement('PostTest');
nickjillings@1575: 			} else {
nickjillings@1575: 				console.log ('WARNING - popup node neither pre or post!');
nickjillings@1575: 				this.responses = document.createElement('responses');
nickjillings@1575: 			}
nickjillings@1575: 			this.currentIndex = 0;
nickjillings@1575: 			this.showPopup();
nickjillings@1575: 			this.postNode();
nickjillings@1581: 		} else {
nickjillings@1581: 			advanceState();
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.buttonClicked = function() {
nickjillings@1575: 		// Each time the popup button is clicked!
nickjillings@1575: 		var node = this.popupOptions[this.currentIndex];
nickjillings@1581: 		if (node.type == 'question') {
nickjillings@1575: 			// Must extract the question data
nickjillings@1575: 			var textArea = $(popup.popupContent).find('textarea')[0];
nickjillings@1581: 			if (node.mandatory == true && textArea.value.length == 0) {
nickjillings@1575: 				alert('This question is mandatory');
nickjillings@1575: 				return;
nickjillings@1575: 			} else {
nickjillings@1575: 				// Save the text content
nickjillings@1575: 				var hold = document.createElement('comment');
nickjillings@1581: 				hold.id = node.id;
nickjillings@1575: 				hold.innerHTML = textArea.value;
nickjillings@1575: 				console.log("Question: "+ node.textContent);
nickjillings@1575: 				console.log("Question Response: "+ textArea.value);
nickjillings@1575: 				this.responses.appendChild(hold);
nickjillings@1575: 			}
nickjillings@1575: 		}
nickjillings@1575: 		this.currentIndex++;
nickjillings@1575: 		if (this.currentIndex < this.popupOptions.length) {
nickjillings@1575: 			this.postNode();
nickjillings@1575: 		} else {
nickjillings@1575: 			// Reached the end of the popupOptions
nickjillings@1575: 			this.hidePopup();
nickjillings@1575: 			if (this.responses.nodeName == testState.stateResults[testState.stateIndex].nodeName) {
nickjillings@1575: 				testState.stateResults[testState.stateIndex] = this.responses;
nickjillings@1575: 			} else {
nickjillings@1575: 				testState.stateResults[testState.stateIndex].appendChild(this.responses);
nickjillings@1575: 			}
nickjillings@1575: 			advanceState();
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function advanceState()
nickjillings@1575: {
nickjillings@1575: 	// Just for complete clarity
nickjillings@1575: 	testState.advanceState();
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function stateMachine()
nickjillings@1575: {
nickjillings@1575: 	// Object prototype for tracking and managing the test state
nickjillings@1575: 	this.stateMap = [];
nickjillings@1575: 	this.stateIndex = null;
nickjillings@1575: 	this.currentStateMap = [];
nickjillings@1575: 	this.currentIndex = null;
nickjillings@1575: 	this.currentTestId = 0;
nickjillings@1575: 	this.stateResults = [];
nickjillings@1575: 	this.timerCallBackHolders = null;
nickjillings@1575: 	this.initialise = function(){
nickjillings@1575: 		if (this.stateMap.length > 0) {
nickjillings@1575: 			if(this.stateIndex != null) {
nickjillings@1575: 				console.log('NOTE - State already initialise');
nickjillings@1575: 			}
nickjillings@1575: 			this.stateIndex = -1;
nickjillings@1575: 			var that = this;
nickjillings@1575: 			for (var id=0; id<this.stateMap.length; id++){
nickjillings@1581: 				var name = this.stateMap[id].type;
nickjillings@1575: 				var obj = document.createElement(name);
nickjillings@1575: 				this.stateResults.push(obj);
nickjillings@1575: 			}
nickjillings@1575: 		} else {
nickjillings@1575: 			conolse.log('FATAL - StateMap not correctly constructed. EMPTY_STATE_MAP');
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	this.advanceState = function(){
nickjillings@1575: 		if (this.stateIndex == null) {
nickjillings@1575: 			this.initialise();
nickjillings@1575: 		}
nickjillings@1575: 		if (this.stateIndex == -1) {
nickjillings@1575: 			console.log('Starting test...');
nickjillings@1575: 		}
nickjillings@1575: 		if (this.currentIndex == null){
nickjillings@1581: 			if (this.currentStateMap.type == "audioHolder") {
nickjillings@1575: 				// Save current page
nickjillings@1575: 				this.testPageCompleted(this.stateResults[this.stateIndex],this.currentStateMap,this.currentTestId);
nickjillings@1575: 				this.currentTestId++;
nickjillings@1575: 			}
nickjillings@1575: 			this.stateIndex++;
nickjillings@1575: 			if (this.stateIndex >= this.stateMap.length) {
nickjillings@1575: 				console.log('Test Completed');
nickjillings@1575: 				createProjectSave(projectReturn);
nickjillings@1575: 			} else {
nickjillings@1575: 				this.currentStateMap = this.stateMap[this.stateIndex];
nickjillings@1581: 				if (this.currentStateMap.type == "audioHolder") {
nickjillings@1575: 					console.log('Loading test page');
nickjillings@1575: 					loadTest(this.currentStateMap);
nickjillings@1575: 					this.initialiseInnerState(this.currentStateMap);
nickjillings@1581: 				} else if (this.currentStateMap.type == "pretest" || this.currentStateMap.type == "posttest") {
nickjillings@1581: 					if (this.currentStateMap.options.length >= 1) {
nickjillings@1575: 						popup.initState(this.currentStateMap);
nickjillings@1575: 					} else {
nickjillings@1575: 						this.advanceState();
nickjillings@1575: 					}
nickjillings@1575: 				} else {
nickjillings@1575: 					this.advanceState();
nickjillings@1575: 				}
nickjillings@1575: 			}
nickjillings@1575: 		} else {
nickjillings@1575: 			this.advanceInnerState();
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.testPageCompleted = function(store, testXML, testId) {
nickjillings@1575: 		// Function called each time a test page has been completed
nickjillings@1575: 		// Can be used to over-rule default behaviour
nickjillings@1575: 		
nickjillings@1581: 		pageXMLSave(store, testXML);
nickjillings@1576: 	};
nickjillings@1575: 	
nickjillings@1581: 	this.initialiseInnerState = function(node) {
nickjillings@1575: 		// Parses the received testXML for pre and post test options
nickjillings@1575: 		this.currentStateMap = [];
nickjillings@1581: 		var preTest = node.preTest;
nickjillings@1581: 		var postTest = node.postTest;
nickjillings@1575: 		if (preTest == undefined) {preTest = document.createElement("preTest");}
nickjillings@1575: 		if (postTest == undefined){postTest= document.createElement("postTest");}
nickjillings@1575: 		this.currentStateMap.push(preTest);
nickjillings@1581: 		this.currentStateMap.push(node);
nickjillings@1575: 		this.currentStateMap.push(postTest);
nickjillings@1575: 		this.currentIndex = -1;
nickjillings@1575: 		this.advanceInnerState();
nickjillings@1576: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.advanceInnerState = function() {
nickjillings@1575: 		this.currentIndex++;
nickjillings@1575: 		if (this.currentIndex >= this.currentStateMap.length) {
nickjillings@1575: 			this.currentIndex = null;
nickjillings@1575: 			this.currentStateMap = this.stateMap[this.stateIndex];
nickjillings@1575: 			this.advanceState();
nickjillings@1575: 		} else {
nickjillings@1581: 			if (this.currentStateMap[this.currentIndex].type == "audioHolder") {
nickjillings@1575: 				console.log("Loading test page"+this.currentTestId);
nickjillings@1581: 			} else if (this.currentStateMap[this.currentIndex].type == "pretest") {
nickjillings@1575: 				popup.initState(this.currentStateMap[this.currentIndex]);
nickjillings@1581: 			} else if (this.currentStateMap[this.currentIndex].type == "posttest") {
nickjillings@1575: 				popup.initState(this.currentStateMap[this.currentIndex]);
nickjillings@1575: 			} else {
nickjillings@1575: 				this.advanceInnerState();
nickjillings@1575: 			}
nickjillings@1575: 		}
nickjillings@1576: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.previousState = function(){};
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function testEnded(testId)
nickjillings@1575: {
nickjillings@1575: 	pageXMLSave(testId);
nickjillings@1575: 	if (testXMLSetups.length-1 > testId)
nickjillings@1575: 	{
nickjillings@1575: 		// Yes we have another test to perform
nickjillings@1575: 		testId = (Number(testId)+1);
nickjillings@1575: 		currentState = 'testRun-'+testId;
nickjillings@1575: 		loadTest(testId);
nickjillings@1575: 	} else {
nickjillings@1575: 		console.log('Testing Completed!');
nickjillings@1575: 		currentState = 'postTest';
nickjillings@1575: 		// Check for any post tests
nickjillings@1575: 		var xmlSetup = projectXML.find('setup');
nickjillings@1575: 		var postTest = xmlSetup.find('PostTest')[0];
nickjillings@1575: 		popup.initState(postTest);
nickjillings@1575: 	}
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function loadProjectSpec(url) {
nickjillings@1575: 	// Load the project document from the given URL, decode the XML and instruct audioEngine to get audio data
nickjillings@1575: 	// If url is null, request client to upload project XML document
nickjillings@1575: 	var r = new XMLHttpRequest();
nickjillings@1575: 	r.open('GET',url,true);
nickjillings@1575: 	r.onload = function() {
nickjillings@1575: 		loadProjectSpecCallback(r.response);
nickjillings@1575: 	};
nickjillings@1575: 	r.send();
nickjillings@1575: };
nickjillings@1575: 
nickjillings@1575: function loadProjectSpecCallback(response) {
nickjillings@1575: 	// Function called after asynchronous download of XML project specification
nickjillings@1580: 	//var decode = $.parseXML(response);
nickjillings@1580: 	//projectXML = $(decode);
nickjillings@1580: 	
nickjillings@1580: 	var parse = new DOMParser();
nickjillings@1580: 	projectXML = parse.parseFromString(response,'text/xml');
nickjillings@1575: 	
nickjillings@1581: 	// Build the specification
nickjillings@1581: 	specification.decode();
nickjillings@1576: 	
nickjillings@1581: 	testState.stateMap.push(specification.preTest);
nickjillings@1576: 	 
nickjillings@1576: 	// New check if we need to randomise the test order
nickjillings@1581: 	if (specification.randomiseOrder)
nickjillings@1581: 	{
nickjillings@1581:  		specification.audioHolders = randomiseOrder(specification.audioHolders);
nickjillings@1576: 	}
nickjillings@1576: 	
nickjillings@1581: 	$(specification.audioHolders).each(function(index,elem){
nickjillings@1576: 		testState.stateMap.push(elem);
nickjillings@1576: 	});
nickjillings@1576: 	 
nickjillings@1581: 	 testState.stateMap.push(specification.postTest);
nickjillings@1576: 	 
nickjillings@1576: 	// Obtain the metrics enabled
nickjillings@1581: 	$(specification.metrics).each(function(index,node){
nickjillings@1576: 		var enabled = node.textContent;
nickjillings@1581: 		switch(node.enabled)
nickjillings@1576: 		{
nickjillings@1576: 		case 'testTimer':
nickjillings@1576: 			sessionMetrics.prototype.enableTestTimer = true;
nickjillings@1576: 			break;
nickjillings@1576: 		case 'elementTimer':
nickjillings@1576: 			sessionMetrics.prototype.enableElementTimer = true;
nickjillings@1576: 			break;
nickjillings@1576: 		case 'elementTracker':
nickjillings@1576: 			sessionMetrics.prototype.enableElementTracker = true;
nickjillings@1576: 			break;
nickjillings@1576: 		case 'elementListenTracker':
nickjillings@1576: 			sessionMetrics.prototype.enableElementListenTracker = true;
nickjillings@1576: 			break;
nickjillings@1576: 		case 'elementInitialPosition':
nickjillings@1576: 			sessionMetrics.prototype.enableElementInitialPosition = true;
nickjillings@1576: 			break;
nickjillings@1576: 		case 'elementFlagListenedTo':
nickjillings@1576: 			sessionMetrics.prototype.enableFlagListenedTo = true;
nickjillings@1576: 			break;
nickjillings@1576: 		case 'elementFlagMoved':
nickjillings@1576: 			sessionMetrics.prototype.enableFlagMoved = true;
nickjillings@1576: 			break;
nickjillings@1576: 		case 'elementFlagComments':
nickjillings@1576: 			sessionMetrics.prototype.enableFlagComments = true;
nickjillings@1576: 			break;
nickjillings@1576: 		}
nickjillings@1576: 	});
nickjillings@1576: 	
nickjillings@1576: 	
nickjillings@1576: 	
nickjillings@1575: 	// Detect the interface to use and load the relevant javascripts.
nickjillings@1575: 	var interfaceJS = document.createElement('script');
nickjillings@1575: 	interfaceJS.setAttribute("type","text/javascript");
nickjillings@1581: 	if (specification.interfaceType == 'APE') {
nickjillings@1575: 		interfaceJS.setAttribute("src","ape.js");
nickjillings@1575: 		
nickjillings@1575: 		// APE comes with a css file
nickjillings@1575: 		var css = document.createElement('link');
nickjillings@1575: 		css.rel = 'stylesheet';
nickjillings@1575: 		css.type = 'text/css';
nickjillings@1575: 		css.href = 'ape.css';
nickjillings@1575: 		
nickjillings@1575: 		document.getElementsByTagName("head")[0].appendChild(css);
nickjillings@1575: 	}
nickjillings@1575: 	document.getElementsByTagName("head")[0].appendChild(interfaceJS);
nickjillings@1575: 	
nickjillings@1575: 	// Define window callbacks for interface
nickjillings@1575: 	window.onresize = function(event){resizeWindow(event);};
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function createProjectSave(destURL) {
nickjillings@1575: 	// Save the data from interface into XML and send to destURL
nickjillings@1575: 	// If destURL is null then download XML in client
nickjillings@1575: 	// Now time to render file locally
nickjillings@1575: 	var xmlDoc = interfaceXMLSave();
nickjillings@1575: 	var parent = document.createElement("div");
nickjillings@1575: 	parent.appendChild(xmlDoc);
nickjillings@1575: 	var file = [parent.innerHTML];
nickjillings@1575: 	if (destURL == "null" || destURL == undefined) {
nickjillings@1575: 		var bb = new Blob(file,{type : 'application/xml'});
nickjillings@1575: 		var dnlk = window.URL.createObjectURL(bb);
nickjillings@1575: 		var a = document.createElement("a");
nickjillings@1575: 		a.hidden = '';
nickjillings@1575: 		a.href = dnlk;
nickjillings@1575: 		a.download = "save.xml";
nickjillings@1575: 		a.textContent = "Save File";
nickjillings@1575: 		
nickjillings@1575: 		popup.showPopup();
nickjillings@1575: 		popup.popupContent.innerHTML = null;
nickjillings@1581: 		popup.popupContent.appendChild(a)
nickjillings@1575: 	} else {
nickjillings@1575: 		var xmlhttp = new XMLHttpRequest;
nickjillings@1575: 		xmlhttp.open("POST",destURL,true);
nickjillings@1575: 		xmlhttp.setRequestHeader('Content-Type', 'text/xml');
nickjillings@1575: 		xmlhttp.onerror = function(){
nickjillings@1575: 			console.log('Error saving file to server! Presenting download locally');
nickjillings@1575: 			createProjectSave(null);
nickjillings@1575: 		};
nickjillings@1575: 		xmlhttp.onreadystatechange  = function() {
nickjillings@1575: 			console.log(xmlhttp.status);
nickjillings@1575: 			if (xmlhttp.status != 200 && xmlhttp.readyState == 4) {
nickjillings@1575: 				createProjectSave(null);
nickjillings@1575: 			}
nickjillings@1575: 		};
nickjillings@1575: 		xmlhttp.send(file);
nickjillings@1575: 	}
nickjillings@1575: 	return submitDiv;
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: // Only other global function which must be defined in the interface class. Determines how to create the XML document.
nickjillings@1575: function interfaceXMLSave(){
nickjillings@1575: 	// Create the XML string to be exported with results
nickjillings@1575: 	var xmlDoc = document.createElement("BrowserEvaluationResult");
nickjillings@1575: 	xmlDoc.appendChild(returnDateNode());
nickjillings@1575: 	for (var i=0; i<testState.stateResults.length; i++)
nickjillings@1575: 	{
nickjillings@1575: 		xmlDoc.appendChild(testState.stateResults[i]);
nickjillings@1575: 	}
nickjillings@1575: 	
nickjillings@1575: 	return xmlDoc;
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function AudioEngine() {
nickjillings@1575: 	
nickjillings@1575: 	// Create two output paths, the main outputGain and fooGain.
nickjillings@1575: 	// Output gain is default to 1 and any items for playback route here
nickjillings@1575: 	// Foo gain is used for analysis to ensure paths get processed, but are not heard
nickjillings@1575: 	// because web audio will optimise and any route which does not go to the destination gets ignored.
nickjillings@1575: 	this.outputGain = audioContext.createGain();
nickjillings@1575: 	this.fooGain = audioContext.createGain();
nickjillings@1575: 	this.fooGain.gain = 0;
nickjillings@1575: 	
nickjillings@1575: 	// Use this to detect playback state: 0 - stopped, 1 - playing
nickjillings@1575: 	this.status = 0;
nickjillings@1575: 	this.audioObjectsReady = false;
nickjillings@1575: 	
nickjillings@1575: 	// Connect both gains to output
nickjillings@1575: 	this.outputGain.connect(audioContext.destination);
nickjillings@1575: 	this.fooGain.connect(audioContext.destination);
nickjillings@1575: 	
nickjillings@1575: 	// Create the timer Object
nickjillings@1575: 	this.timer = new timer();
nickjillings@1575: 	// Create session metrics
nickjillings@1575: 	this.metric = new sessionMetrics(this);
nickjillings@1575: 	
nickjillings@1575: 	this.loopPlayback = false;
nickjillings@1575: 	
nickjillings@1575: 	// Create store for new audioObjects
nickjillings@1575: 	this.audioObjects = [];
nickjillings@1575: 	
nickjillings@1575: 	this.play = function() {
nickjillings@1575: 		// Start the timer and set the audioEngine state to playing (1)
nickjillings@1575: 		if (this.status == 0) {
nickjillings@1575: 			// Check if all audioObjects are ready
nickjillings@1575: 			if (this.audioObjectsReady == false) {
nickjillings@1575: 				this.audioObjectsReady = this.checkAllReady();
nickjillings@1575: 			}
nickjillings@1575: 			if (this.audioObjectsReady == true) {
nickjillings@1575: 				this.timer.startTest();
nickjillings@1575: 				if (this.loopPlayback) {
nickjillings@1575: 					for(var i=0; i<this.audioObjects.length; i++) {
nickjillings@1575: 						this.audioObjects[i].play(this.timer.getTestTime()+1);
nickjillings@1575: 					}
nickjillings@1575: 				}
nickjillings@1575: 				this.status = 1;
nickjillings@1575: 			}
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.stop = function() {
nickjillings@1575: 		// Send stop and reset command to all playback buffers and set audioEngine state to stopped (1)
nickjillings@1575: 		if (this.status == 1) {
nickjillings@1575: 			for (var i=0; i<this.audioObjects.length; i++)
nickjillings@1575: 			{
nickjillings@1575: 				this.audioObjects[i].stop();
nickjillings@1575: 			}
nickjillings@1575: 			this.status = 0;
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	
nickjillings@1575: 	this.newTrack = function(url) {
nickjillings@1575: 		// Pull data from given URL into new audio buffer
nickjillings@1575: 		// URLs must either be from the same source OR be setup to 'Access-Control-Allow-Origin'
nickjillings@1575: 		
nickjillings@1575: 		// Create the audioObject with ID of the new track length;
nickjillings@1575: 		audioObjectId = this.audioObjects.length;
nickjillings@1575: 		this.audioObjects[audioObjectId] = new audioObject(audioObjectId);
nickjillings@1575: 
nickjillings@1575: 		// AudioObject will get track itself.
nickjillings@1575: 		this.audioObjects[audioObjectId].constructTrack(url);
nickjillings@1579: 		return this.audioObjects[audioObjectId];
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.newTestPage = function() {
nickjillings@1575: 		this.state = 0;
nickjillings@1575: 		this.audioObjectsReady = false;
nickjillings@1575: 		this.metric.reset();
nickjillings@1575: 		this.audioObjects = [];
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.checkAllPlayed = function() {
nickjillings@1575: 		arr = [];
nickjillings@1575: 		for (var id=0; id<this.audioObjects.length; id++) {
nickjillings@1575: 			if (this.audioObjects[id].metric.wasListenedTo == false) {
nickjillings@1575: 				arr.push(this.audioObjects[id].id);
nickjillings@1575: 			}
nickjillings@1575: 		}
nickjillings@1575: 		return arr;
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.checkAllReady = function() {
nickjillings@1575: 		var ready = true;
nickjillings@1575: 		for (var i=0; i<this.audioObjects.length; i++) {
nickjillings@1575: 			if (this.audioObjects[i].state == 0) {
nickjillings@1575: 				// Track not ready
nickjillings@1575: 				console.log('WAIT -- audioObject '+i+' not ready yet!');
nickjillings@1575: 				ready = false;
nickjillings@1575: 			};
nickjillings@1575: 		}
nickjillings@1575: 		return ready;
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function audioObject(id) {
nickjillings@1575: 	// The main buffer object with common control nodes to the AudioEngine
nickjillings@1575: 	
nickjillings@1575: 	this.id = id;
nickjillings@1575: 	this.state = 0; // 0 - no data, 1 - ready
nickjillings@1575: 	this.url = null; // Hold the URL given for the output back to the results.
nickjillings@1575: 	this.metric = new metricTracker(this);
nickjillings@1575: 	
nickjillings@1577: 	// Bindings for GUI
nickjillings@1577: 	this.sliderDOM = null;
nickjillings@1577: 	this.commentDOM = null;
nickjillings@1577: 	
nickjillings@1575: 	// Create a buffer and external gain control to allow internal patching of effects and volume leveling.
nickjillings@1575: 	this.bufferNode = undefined;
nickjillings@1575: 	this.outputGain = audioContext.createGain();
nickjillings@1575: 	
nickjillings@1575: 	// Default output gain to be zero
nickjillings@1575: 	this.outputGain.gain.value = 0.0;
nickjillings@1575: 	
nickjillings@1575: 	// Connect buffer to the audio graph
nickjillings@1575: 	this.outputGain.connect(audioEngineContext.outputGain);
nickjillings@1575: 	
nickjillings@1575: 	// the audiobuffer is not designed for multi-start playback
nickjillings@1575: 	// When stopeed, the buffer node is deleted and recreated with the stored buffer.
nickjillings@1575: 	this.buffer;
nickjillings@1575:     
nickjillings@1575: 	this.loopStart = function() {
nickjillings@1575: 		this.outputGain.gain.value = 1.0;
nickjillings@1575: 		this.metric.startListening(audioEngineContext.timer.getTestTime());
nickjillings@1577: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.loopStop = function() {
nickjillings@1575: 		if (this.outputGain.gain.value != 0.0) {
nickjillings@1575: 			this.outputGain.gain.value = 0.0;
nickjillings@1575: 			this.metric.stopListening(audioEngineContext.timer.getTestTime());
nickjillings@1575: 		}
nickjillings@1577: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.play = function(startTime) {
nickjillings@1575: 		this.bufferNode = audioContext.createBufferSource();
nickjillings@1575: 		this.bufferNode.owner = this;
nickjillings@1575: 		this.bufferNode.connect(this.outputGain);
nickjillings@1575: 		this.bufferNode.buffer = this.buffer;
nickjillings@1575: 		this.bufferNode.loop = audioEngineContext.loopPlayback;
nickjillings@1575: 		this.bufferNode.onended = function() {
nickjillings@1575: 			// Safari does not like using 'this' to reference the calling object!
nickjillings@1575: 			event.srcElement.owner.metric.stopListening(audioEngineContext.timer.getTestTime());
nickjillings@1575: 		};
nickjillings@1575: 		if (this.bufferNode.loop == false) {
nickjillings@1575: 			this.metric.startListening(audioEngineContext.timer.getTestTime());
nickjillings@1575: 		}
nickjillings@1575: 		this.bufferNode.start(startTime);
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.stop = function() {
nickjillings@1575: 		if (this.bufferNode != undefined)
nickjillings@1575: 		{
nickjillings@1575: 			this.bufferNode.stop(0);
nickjillings@1575: 			this.bufferNode = undefined;
nickjillings@1575: 			this.metric.stopListening(audioEngineContext.timer.getTestTime());
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.getCurrentPosition = function() {
nickjillings@1575: 		var time = audioEngineContext.timer.getTestTime();
nickjillings@1575: 		if (this.bufferNode != undefined) {
nickjillings@1575: 			if (this.bufferNode.loop == true) {
nickjillings@1575: 				if (audioEngineContext.status  == 1) {
nickjillings@1575: 					return time%this.buffer.duration;
nickjillings@1575: 				} else {
nickjillings@1575: 					return 0;
nickjillings@1575: 				}
nickjillings@1575: 			} else {
nickjillings@1575: 				if (this.metric.listenHold) {
nickjillings@1575: 					return time - this.metric.listenStart;
nickjillings@1575: 				} else {
nickjillings@1575: 					return 0;
nickjillings@1575: 				}
nickjillings@1575: 			}
nickjillings@1575: 		} else {
nickjillings@1575: 			return 0;
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 
nickjillings@1575: 	this.constructTrack = function(url) {
nickjillings@1575: 		var request = new XMLHttpRequest();
nickjillings@1575: 		this.url = url;
nickjillings@1575: 		request.open('GET',url,true);
nickjillings@1575: 		request.responseType = 'arraybuffer';
nickjillings@1575: 		
nickjillings@1575: 		var audioObj = this;
nickjillings@1575: 		
nickjillings@1575: 		// Create callback to decode the data asynchronously
nickjillings@1575: 		request.onloadend = function() {
nickjillings@1575: 			audioContext.decodeAudioData(request.response, function(decodedData) {
nickjillings@1575: 				audioObj.buffer = decodedData;
nickjillings@1575: 				audioObj.state = 1;
nickjillings@1575: 			}, function(){
nickjillings@1575: 				// Should only be called if there was an error, but sometimes gets called continuously
nickjillings@1575: 				// Check here if the error is genuine
nickjillings@1575: 				if (audioObj.state == 0 || audioObj.buffer == undefined) {
nickjillings@1575: 					// Genuine error
nickjillings@1575: 					console.log('FATAL - Error loading buffer on '+audioObj.id);
nickjillings@1575: 				}
nickjillings@1575: 			});
nickjillings@1575: 		};
nickjillings@1575: 		request.send();
nickjillings@1575: 	};
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function timer()
nickjillings@1575: {
nickjillings@1575: 	/* Timer object used in audioEngine to keep track of session timings
nickjillings@1575: 	 * Uses the timer of the web audio API, so sample resolution
nickjillings@1575: 	 */
nickjillings@1575: 	this.testStarted = false;
nickjillings@1575: 	this.testStartTime = 0;
nickjillings@1575: 	this.testDuration = 0;
nickjillings@1575: 	this.minimumTestTime = 0; // No minimum test time
nickjillings@1575: 	this.startTest = function()
nickjillings@1575: 	{
nickjillings@1575: 		if (this.testStarted == false)
nickjillings@1575: 		{
nickjillings@1575: 			this.testStartTime = audioContext.currentTime;
nickjillings@1575: 			this.testStarted = true;
nickjillings@1575: 			this.updateTestTime();
nickjillings@1575: 			audioEngineContext.metric.initialiseTest();
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	this.stopTest = function()
nickjillings@1575: 	{
nickjillings@1575: 		if (this.testStarted)
nickjillings@1575: 		{
nickjillings@1575: 			this.testDuration = this.getTestTime();
nickjillings@1575: 			this.testStarted = false;
nickjillings@1575: 		} else {
nickjillings@1575: 			console.log('ERR: Test tried to end before beginning');
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	this.updateTestTime = function()
nickjillings@1575: 	{
nickjillings@1575: 		if (this.testStarted)
nickjillings@1575: 		{
nickjillings@1575: 			this.testDuration = audioContext.currentTime - this.testStartTime;
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	this.getTestTime = function()
nickjillings@1575: 	{
nickjillings@1575: 		this.updateTestTime();
nickjillings@1575: 		return this.testDuration;
nickjillings@1575: 	};
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function sessionMetrics(engine)
nickjillings@1575: {
nickjillings@1575: 	/* Used by audioEngine to link to audioObjects to minimise the timer call timers;
nickjillings@1575: 	 */
nickjillings@1575: 	this.engine = engine;
nickjillings@1575: 	this.lastClicked = -1;
nickjillings@1575: 	this.data = -1;
nickjillings@1575: 	this.reset = function() {
nickjillings@1575: 		this.lastClicked = -1;
nickjillings@1575: 		this.data = -1;
nickjillings@1575: 	};
nickjillings@1575: 	this.initialiseTest = function(){};
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function metricTracker(caller)
nickjillings@1575: {
nickjillings@1575: 	/* Custom object to track and collect metric data
nickjillings@1575: 	 * Used only inside the audioObjects object.
nickjillings@1575: 	 */
nickjillings@1575: 	
nickjillings@1575: 	this.listenedTimer = 0;
nickjillings@1575: 	this.listenStart = 0;
nickjillings@1575: 	this.listenHold = false;
nickjillings@1575: 	this.initialPosition = -1;
nickjillings@1575: 	this.movementTracker = [];
nickjillings@1575: 	this.listenTracker =[];
nickjillings@1575: 	this.wasListenedTo = false;
nickjillings@1575: 	this.wasMoved = false;
nickjillings@1575: 	this.hasComments = false;
nickjillings@1575: 	this.parent = caller;
nickjillings@1575: 	
nickjillings@1575: 	this.initialised = function(position)
nickjillings@1575: 	{
nickjillings@1575: 		if (this.initialPosition == -1) {
nickjillings@1575: 			this.initialPosition = position;
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.moved = function(time,position)
nickjillings@1575: 	{
nickjillings@1575: 		this.wasMoved = true;
nickjillings@1575: 		this.movementTracker[this.movementTracker.length] = [time, position];
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.startListening = function(time)
nickjillings@1575: 	{
nickjillings@1575: 		if (this.listenHold == false)
nickjillings@1575: 		{
nickjillings@1575: 			this.wasListenedTo = true;
nickjillings@1575: 			this.listenStart = time;
nickjillings@1575: 			this.listenHold = true;
nickjillings@1575: 			
nickjillings@1575: 			var evnt = document.createElement('event');
nickjillings@1575: 			var testTime = document.createElement('testTime');
nickjillings@1575: 			testTime.setAttribute('start',time);
nickjillings@1575: 			var bufferTime = document.createElement('bufferTime');
nickjillings@1575: 			bufferTime.setAttribute('start',this.parent.getCurrentPosition());
nickjillings@1575: 			evnt.appendChild(testTime);
nickjillings@1575: 			evnt.appendChild(bufferTime);
nickjillings@1575: 			this.listenTracker.push(evnt);
nickjillings@1575: 			
nickjillings@1575: 			console.log('slider ' + this.parent.id + ' played (' + time + ')'); // DEBUG/SAFETY: show played slider id
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1575: 	
nickjillings@1575: 	this.stopListening = function(time)
nickjillings@1575: 	{
nickjillings@1575: 		if (this.listenHold == true)
nickjillings@1575: 		{
nickjillings@1575: 			var diff = time - this.listenStart;
nickjillings@1575: 			this.listenedTimer += (diff);
nickjillings@1575: 			this.listenStart = 0;
nickjillings@1575: 			this.listenHold = false;
nickjillings@1575: 			
nickjillings@1575: 			var evnt = this.listenTracker[this.listenTracker.length-1];
nickjillings@1575: 			var testTime = evnt.getElementsByTagName('testTime')[0];
nickjillings@1575: 			var bufferTime = evnt.getElementsByTagName('bufferTime')[0];
nickjillings@1575: 			testTime.setAttribute('stop',time);
nickjillings@1575: 			bufferTime.setAttribute('stop',this.parent.getCurrentPosition());
nickjillings@1575: 			console.log('slider ' + this.parent.id + ' played for (' + diff + ')'); // DEBUG/SAFETY: show played slider id
nickjillings@1575: 		}
nickjillings@1575: 	};
nickjillings@1577: 	
nickjillings@1577: 	this.exportXMLDOM = function() {
nickjillings@1577: 		var root = document.createElement('metric');
nickjillings@1577: 		if (audioEngineContext.metric.enableElementTimer) {
nickjillings@1577: 			var mElementTimer = document.createElement('metricresult');
nickjillings@1577: 			mElementTimer.setAttribute('name','enableElementTimer');
nickjillings@1577: 			mElementTimer.textContent = this.listenedTimer;
nickjillings@1577: 			root.appendChild(mElementTimer);
nickjillings@1577: 		}
nickjillings@1577: 		if (audioEngineContext.metric.enableElementTracker) {
nickjillings@1577: 			var elementTrackerFull = document.createElement('metricResult');
nickjillings@1577: 			elementTrackerFull.setAttribute('name','elementTrackerFull');
nickjillings@1577: 			for (var k=0; k<this.movementTracker.length; k++)
nickjillings@1577: 			{
nickjillings@1577: 				var timePos = document.createElement('timePos');
nickjillings@1577: 				timePos.id = k;
nickjillings@1577: 				var time = document.createElement('time');
nickjillings@1577: 				time.textContent = this.movementTracker[k][0];
nickjillings@1577: 				var position = document.createElement('position');
nickjillings@1577: 				position.textContent = this.movementTracker[k][1];
nickjillings@1577: 				timePos.appendChild(time);
nickjillings@1577: 				timePos.appendChild(position);
nickjillings@1577: 				elementTrackerFull.appendChild(timePos);
nickjillings@1577: 			}
nickjillings@1577: 			root.appendChild(elementTrackerFull);
nickjillings@1577: 		}
nickjillings@1577: 		if (audioEngineContext.metric.enableElementListenTracker) {
nickjillings@1577: 			var elementListenTracker = document.createElement('metricResult');
nickjillings@1577: 			elementListenTracker.setAttribute('name','elementListenTracker');
nickjillings@1577: 			for (var k=0; k<this.listenTracker.length; k++) {
nickjillings@1577: 				elementListenTracker.appendChild(this.listenTracker[k]);
nickjillings@1577: 			}
nickjillings@1577: 			root.appendChild(elementListenTracker);
nickjillings@1577: 		}
nickjillings@1577: 		if (audioEngineContext.metric.enableElementInitialPosition) {
nickjillings@1577: 			var elementInitial = document.createElement('metricResult');
nickjillings@1577: 			elementInitial.setAttribute('name','elementInitialPosition');
nickjillings@1577: 			elementInitial.textContent = this.initialPosition;
nickjillings@1577: 			root.appendChild(elementInitial);
nickjillings@1577: 		}
nickjillings@1577: 		if (audioEngineContext.metric.enableFlagListenedTo) {
nickjillings@1577: 			var flagListenedTo = document.createElement('metricResult');
nickjillings@1577: 			flagListenedTo.setAttribute('name','elementFlagListenedTo');
nickjillings@1577: 			flagListenedTo.textContent = this.wasListenedTo;
nickjillings@1577: 			root.appendChild(flagListenedTo);
nickjillings@1577: 		}
nickjillings@1577: 		if (audioEngineContext.metric.enableFlagMoved) {
nickjillings@1577: 			var flagMoved = document.createElement('metricResult');
nickjillings@1577: 			flagMoved.setAttribute('name','elementFlagMoved');
nickjillings@1577: 			flagMoved.textContent = this.wasMoved;
nickjillings@1577: 			root.appendChild(flagMoved);
nickjillings@1577: 		}
nickjillings@1577: 		if (audioEngineContext.metric.enableFlagComments) {
nickjillings@1577: 			var flagComments = document.createElement('metricResult');
nickjillings@1577: 			flagComments.setAttribute('name','elementFlagComments');
nickjillings@1577: 			if (this.parent.commentDOM == null)
nickjillings@1577: 				{flag.textContent = 'false';}
nickjillings@1577: 			else if (this.parent.commentDOM.textContent.length == 0) 
nickjillings@1577: 				{flag.textContent = 'false';}
nickjillings@1577: 			else 
nickjillings@1577: 				{flag.textContet = 'true';}
nickjillings@1577: 			root.appendChild(flagComments);
nickjillings@1577: 		}
nickjillings@1577: 		
nickjillings@1577: 		return root;
nickjillings@1577: 	};
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function randomiseOrder(input)
nickjillings@1575: {
nickjillings@1575: 	// This takes an array of information and randomises the order
nickjillings@1575: 	var N = input.length;
nickjillings@1575: 	var K = N;
nickjillings@1575: 	var holdArr = [];
nickjillings@1575: 	for (var n=0; n<N; n++)
nickjillings@1575: 	{
nickjillings@1575: 		// First pick a random number
nickjillings@1575: 		var r = Math.random();
nickjillings@1575: 		// Multiply and floor by the number of elements left
nickjillings@1575: 		r = Math.floor(r*input.length);
nickjillings@1575: 		// Pick out that element and delete from the array
nickjillings@1575: 		holdArr.push(input.splice(r,1)[0]);
nickjillings@1575: 	}
nickjillings@1575: 	return holdArr;
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function returnDateNode()
nickjillings@1575: {
nickjillings@1575: 	// Create an XML Node for the Date and Time a test was conducted
nickjillings@1575: 	// Structure is
nickjillings@1575: 	// <datetime> 
nickjillings@1575: 	//	<date year="##" month="##" day="##">DD/MM/YY</date>
nickjillings@1575: 	//	<time hour="##" minute="##" sec="##">HH:MM:SS</time>
nickjillings@1575: 	// </datetime>
nickjillings@1575: 	var dateTime = new Date();
nickjillings@1575: 	var year = document.createAttribute('year');
nickjillings@1575: 	var month = document.createAttribute('month');
nickjillings@1575: 	var day = document.createAttribute('day');
nickjillings@1575: 	var hour = document.createAttribute('hour');
nickjillings@1575: 	var minute = document.createAttribute('minute');
nickjillings@1575: 	var secs = document.createAttribute('secs');
nickjillings@1575: 	
nickjillings@1575: 	year.nodeValue = dateTime.getFullYear();
nickjillings@1575: 	month.nodeValue = dateTime.getMonth()+1;
nickjillings@1575: 	day.nodeValue = dateTime.getDate();
nickjillings@1575: 	hour.nodeValue = dateTime.getHours();
nickjillings@1575: 	minute.nodeValue = dateTime.getMinutes();
nickjillings@1575: 	secs.nodeValue = dateTime.getSeconds();
nickjillings@1575: 	
nickjillings@1575: 	var hold = document.createElement("datetime");
nickjillings@1575: 	var date = document.createElement("date");
nickjillings@1575: 	date.textContent = year.nodeValue+'/'+month.nodeValue+'/'+day.nodeValue;
nickjillings@1575: 	var time = document.createElement("time");
nickjillings@1575: 	time.textContent = hour.nodeValue+':'+minute.nodeValue+':'+secs.nodeValue;
nickjillings@1575: 	
nickjillings@1575: 	date.setAttributeNode(year);
nickjillings@1575: 	date.setAttributeNode(month);
nickjillings@1575: 	date.setAttributeNode(day);
nickjillings@1575: 	time.setAttributeNode(hour);
nickjillings@1575: 	time.setAttributeNode(minute);
nickjillings@1575: 	time.setAttributeNode(secs);
nickjillings@1575: 	
nickjillings@1575: 	hold.appendChild(date);
nickjillings@1575: 	hold.appendChild(time);
nickjillings@1575: 	return hold
nickjillings@1575: 	
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: function testWaitIndicator() {
nickjillings@1575: 	if (audioEngineContext.checkAllReady() == false) {
nickjillings@1575: 		var hold = document.createElement("div");
nickjillings@1575: 		hold.id = "testWaitIndicator";
nickjillings@1575: 		hold.className = "indicator-box";
nickjillings@1575: 		var span = document.createElement("span");
nickjillings@1575: 		span.textContent = "Please wait! Elements still loading";
nickjillings@1575: 		hold.appendChild(span);
nickjillings@1575: 		var body = document.getElementsByTagName('body')[0];
nickjillings@1575: 		body.appendChild(hold);
nickjillings@1575: 		testWaitTimerIntervalHolder = setInterval(function(){
nickjillings@1575: 			var ready = audioEngineContext.checkAllReady();
nickjillings@1575: 			if (ready) {
nickjillings@1575: 				var elem = document.getElementById('testWaitIndicator');
nickjillings@1575: 				var body = document.getElementsByTagName('body')[0];
nickjillings@1575: 				body.removeChild(elem);
nickjillings@1575: 				clearInterval(testWaitTimerIntervalHolder);
nickjillings@1575: 			}
nickjillings@1575: 		},500,false);
nickjillings@1575: 	}
nickjillings@1575: }
nickjillings@1575: 
nickjillings@1575: var testWaitTimerIntervalHolder = null;
nickjillings@1580: 
nickjillings@1580: function Specification() {
nickjillings@1580: 	// Handles the decoding of the project specification XML into a simple JavaScript Object.
nickjillings@1580: 	
nickjillings@1580: 	this.interfaceType;
nickjillings@1580: 	this.projectReturn;
nickjillings@1580: 	this.randomiseOrder;
nickjillings@1580: 	this.collectMetrics;
nickjillings@1580: 	this.preTest;
nickjillings@1580: 	this.postTest;
nickjillings@1580: 	this.metrics =[];
nickjillings@1580: 	
nickjillings@1580: 	this.audioHolders = [];
nickjillings@1580: 	
nickjillings@1580: 	this.decode = function() {
nickjillings@1580: 		// projectXML - DOM Parsed document
nickjillings@1580: 		var setupNode = projectXML.getElementsByTagName('setup')[0];
nickjillings@1580: 		this.interfaceType = setupNode.getAttribute('interface');
nickjillings@1580: 		this.projectReturn = setupNode.getAttribute('projectReturn');
nickjillings@1580: 		if (setupNode.getAttribute('randomiseOrder') == "true") {
nickjillings@1580: 			this.randomiseOrder = true;
nickjillings@1580: 		} else {this.setup.randomiseOrder = false;}
nickjillings@1580: 		if (setupNode.getAttribute('collectMetrics') == "true") {
nickjillings@1580: 			this.collectMetrics = true;
nickjillings@1580: 		} else {this.setup.collectMetrics = false;}
nickjillings@1580: 		var metricCollection = setupNode.getElementsByTagName('Metric');
nickjillings@1580: 		
nickjillings@1581: 		this.preTest = new this.prepostNode('pretest',setupNode.getElementsByTagName('PreTest'));
nickjillings@1581: 		this.postTest = new this.prepostNode('posttest',setupNode.getElementsByTagName('PostTest'));
nickjillings@1580: 		
nickjillings@1580: 		if (metricCollection.length > 0) {
nickjillings@1580: 			metricCollection = metricCollection[0].getElementsByTagName('metricEnable');
nickjillings@1580: 			for (var i=0; i<metricCollection.length; i++) {
nickjillings@1581: 				this.metrics.push(new this.metricNode(metricCollection[i].textContent));
nickjillings@1580: 			}
nickjillings@1580: 		}
nickjillings@1580: 		
nickjillings@1580: 		var audioHolders = projectXML.getElementsByTagName('audioHolder');
nickjillings@1580: 		for (var i=0; i<audioHolders.length; i++) {
nickjillings@1580: 			this.audioHolders.push(new this.audioHolderNode(this,audioHolders[i]));
nickjillings@1580: 		}
nickjillings@1580: 		
nickjillings@1580: 	};
nickjillings@1580: 	
nickjillings@1580: 	this.prepostNode = function(type,Collection) {
nickjillings@1580: 		this.type = type;
nickjillings@1580: 		this.options = [];
nickjillings@1580: 		
nickjillings@1580: 		this.OptionNode = function(child) {
nickjillings@1580: 			this.type = child.nodeName;
nickjillings@1580: 			if (child.nodeName == "question") {
nickjillings@1580: 				this.id = child.id;
nickjillings@1580: 				this.mandatory;
nickjillings@1580: 				if (child.getAttribute('mandatory') == "true") {this.mandatory = true;}
nickjillings@1580: 				else {this.mandatory = false;}
nickjillings@1580: 				this.question = child.textContent;
nickjillings@1580: 			} else if (child.nodeName == "statement") {
nickjillings@1581: 				this.statement = child.textContent;
nickjillings@1580: 			}
nickjillings@1580: 		};
nickjillings@1580: 		
nickjillings@1580: 		// On construction:
nickjillings@1580: 		if (Collection.length != 0) {
nickjillings@1580: 			Collection = Collection[0];
nickjillings@1580: 			for (var i=0; i<Collection.childElementCount; i++) {
nickjillings@1580: 				var child = Collection.children[i];
nickjillings@1580: 				this.options.push(new this.OptionNode(child));
nickjillings@1580: 			}
nickjillings@1580: 		}
nickjillings@1580: 	};
nickjillings@1580: 	
nickjillings@1580: 	this.metricNode = function(name) {
nickjillings@1580: 		this.enabled = name;
nickjillings@1580: 	};
nickjillings@1580: 	
nickjillings@1580: 	this.audioHolderNode = function(parent,xml) {
nickjillings@1581: 		this.type = 'audioHolder';
nickjillings@1580: 		this.interfaceNode = function(DOM) {
nickjillings@1580: 			var title = DOM.getElementsByTagName('title');
nickjillings@1580: 			if (title.length == 0) {this.title = null;}
nickjillings@1580: 			else {this.title = title[0].textContent;}
nickjillings@1580: 			
nickjillings@1580: 			var scale = DOM.getElementsByTagName('scale');
nickjillings@1580: 			this.scale = [];
nickjillings@1580: 			for (var i=0; i<scale.length; i++) {
nickjillings@1580: 				var arr = [null, null];
nickjillings@1580: 				arr[0] = scale[i].getAttribute('position');
nickjillings@1580: 				arr[1] = scale[i].textContent;
nickjillings@1580: 				this.scale.push(arr);
nickjillings@1580: 			}
nickjillings@1580: 		};
nickjillings@1580: 		
nickjillings@1580: 		this.audioElementNode = function(xml) {
nickjillings@1580: 			this.url = xml.getAttribute('url');
nickjillings@1580: 			this.id = xml.id;
nickjillings@1580: 		};
nickjillings@1580: 		
nickjillings@1580: 		this.commentQuestionNode = function(xml) {
nickjillings@1580: 			this.id = xml.id;
nickjillings@1580: 			if (xml.getAttribute('mandatory') == 'true') {this.mandatory = true;}
nickjillings@1580: 			else {this.mandatory = false;}
nickjillings@1580: 			this.question = xml.textContent;
nickjillings@1580: 		};
nickjillings@1580: 		
nickjillings@1580: 		this.id = xml.id;
nickjillings@1580: 		this.hostURL = xml.getAttribute('hostURL');
nickjillings@1580: 		this.sampleRate = xml.getAttribute('sampleRate');
nickjillings@1580: 		if (xml.getAttribute('randomiseOrder') == "true") {this.randomiseOrder = true;}
nickjillings@1580: 		else {this.randomiseOrder = false;}
nickjillings@1580: 		this.repeatCount = xml.getAttribute('repeatCount');
nickjillings@1580: 		if (xml.getAttribute('loop') == 'true') {this.loop = true;}
nickjillings@1580: 		else {this.loop == false;}
nickjillings@1580: 		if (xml.getAttribute('elementComments') == "true") {this.elementComments = true;}
nickjillings@1580: 		else {this.elementComments = false;}
nickjillings@1580: 		
nickjillings@1581: 		this.preTest = new parent.prepostNode('pretest',xml.getElementsByTagName('PreTest'));
nickjillings@1581: 		this.postTest = new parent.prepostNode('posttest',xml.getElementsByTagName('PostTest'));
nickjillings@1580: 		
nickjillings@1580: 		this.interfaces = [];
nickjillings@1580: 		var interfaceDOM = xml.getElementsByTagName('interface');
nickjillings@1580: 		for (var i=0; i<interfaceDOM.length; i++) {
nickjillings@1580: 			this.interfaces.push(new this.interfaceNode(interfaceDOM[i]));
nickjillings@1580: 		}
nickjillings@1580: 		
nickjillings@1580: 		this.commentBoxPrefix = xml.getElementsByTagName('commentBoxPrefix');
nickjillings@1580: 		if (this.commentBoxPrefix.length != 0) {
nickjillings@1580: 			this.commentBoxPrefix = this.commentBoxPrefix[0].textContent;
nickjillings@1580: 		} else {
nickjillings@1580: 			this.commentBoxPrefix = "Comment on track";
nickjillings@1580: 		}
nickjillings@1580: 		
nickjillings@1580: 		this.audioElements  =[];
nickjillings@1580: 		var audioElementsDOM = xml.getElementsByTagName('audioElements');
nickjillings@1580: 		for (var i=0; i<audioElementsDOM.length; i++) {
nickjillings@1580: 			this.audioElements.push(new this.audioElementNode(audioElementsDOM[i]));
nickjillings@1580: 		}
nickjillings@1580: 		
nickjillings@1580: 		this.commentQuestions = [];
nickjillings@1580: 		var commentQuestionsDOM = xml.getElementsByTagName('CommentQuestion');
nickjillings@1580: 		for (var i=0; i<commentQuestionsDOM.length; i++) {
nickjillings@1580: 			this.commentQuestions.push(new this.commentQuestionNode(commentQuestionsDOM[i]));
nickjillings@1580: 		}
nickjillings@1580: 	};
nickjillings@1580: }
nickjillings@1580: 
nickjillings@1580: function Interface() {
nickjillings@1580: 	// This handles the bindings between the interface and the audioEngineContext;
nickjillings@1580: 	
nickjillings@1580: }
nickjillings@1580: