n@470: /**
n@470:  *  mushra.js
n@470:  *  Create the MUSHRA interface
n@470:  */
n@470: 
n@470: // Once this is loaded and parsed, begin execution
n@470: loadInterface();
n@470: 
n@470: function loadInterface() {
n@470: 	// Get the dimensions of the screen available to the page
n@470: 	var width = window.innerWidth;
n@470: 	var height = window.innerHeight;
n@470: 	
n@470: 	// The injection point into the HTML page
n@470: 	interfaceContext.insertPoint = document.getElementById("topLevelBody");
n@470: 	var testContent = document.createElement('div');
n@470: 	testContent.id = 'testContent';
n@470: 	
n@470: 	// Create the top div for the Title element
n@470: 	var titleAttr = specification.title;
n@470: 	var title = document.createElement('div');
n@470: 	title.className = "title";
n@470: 	title.align = "center";
n@470: 	var titleSpan = document.createElement('span');
n@470: 	
n@470: 	// Set title to that defined in XML, else set to default
n@470: 	if (titleAttr != undefined) {
n@470: 		titleSpan.textContent = titleAttr;
n@470: 	} else {
n@470: 		titleSpan.textContent =  'Listening test';
n@470: 	}
n@470: 	// Insert the titleSpan element into the title div element.
n@470: 	title.appendChild(titleSpan);
n@470: 	
n@470: 	var pagetitle = document.createElement('div');
n@470: 	pagetitle.className = "pageTitle";
n@470: 	pagetitle.align = "center";
n@470: 	var titleSpan = document.createElement('span');
n@470: 	titleSpan.id = "pageTitle";
n@470: 	pagetitle.appendChild(titleSpan);
n@470: 	
n@470: 	// Create Interface buttons!
n@470: 	var interfaceButtons = document.createElement('div');
n@470: 	interfaceButtons.id = 'interface-buttons';
n@470: 	interfaceButtons.style.height = '25px';
n@470: 	
n@470: 	// Create playback start/stop points
n@470: 	var playback = document.createElement("button");
n@470: 	playback.innerHTML = 'Stop';
n@470: 	playback.id = 'playback-button';
n@470: 	playback.style.float = 'left';
n@470: 	// onclick function. Check if it is playing or not, call the correct function in the
n@470: 	// audioEngine, change the button text to reflect the next state.
n@470: 	playback.onclick = function() {
n@470: 		if (audioEngineContext.status == 1) {
n@470: 			audioEngineContext.stop();
n@470: 			this.innerHTML = 'Stop';
n@470:             var time = audioEngineContext.timer.getTestTime();
n@470:             console.log('Stopped at ' + time); // DEBUG/SAFETY
n@470: 		}
n@470: 	};
n@470: 	// Create Submit (save) button
n@470: 	var submit = document.createElement("button");
n@470: 	submit.innerHTML = 'Submit';
n@470: 	submit.onclick = buttonSubmitClick;
n@470: 	submit.id = 'submit-button';
n@470: 	submit.style.float = 'left';
n@470: 	// Append the interface buttons into the interfaceButtons object.
n@470: 	interfaceButtons.appendChild(playback);
n@470: 	interfaceButtons.appendChild(submit);
n@470: 	
n@470: 	// Create a slider box
n@470: 	var sliderBox = document.createElement('div');
n@470: 	sliderBox.style.width = "100%";
n@470: 	sliderBox.style.height = window.innerHeight - 200+12 + 'px';
n@470: 	sliderBox.style.marginBottom = '10px';
n@470: 	sliderBox.id = 'slider';
n@470: 	var scaleHolder = document.createElement('div');
n@470: 	scaleHolder.id = "scale-holder";
n@470: 	sliderBox.appendChild(scaleHolder);
n@470: 	var scaleText = document.createElement('div');
n@470: 	scaleText.id = "scale-text-holder";
n@470: 	scaleHolder.appendChild(scaleText);
n@470: 	var scaleCanvas = document.createElement('canvas');
n@470: 	scaleCanvas.id = "scale-canvas";
n@470: 	scaleHolder.appendChild(scaleCanvas);
n@470: 	var sliderObjectHolder = document.createElement('div');
n@470: 	sliderObjectHolder.id = 'slider-holder';
n@470: 	sliderObjectHolder.align = "center";
n@470: 	sliderBox.appendChild(sliderObjectHolder);
n@470: 	
n@470: 	// Global parent for the comment boxes on the page
n@470: 	var feedbackHolder = document.createElement('div');
n@470: 	feedbackHolder.id = 'feedbackHolder';
n@470: 	
n@470: 	testContent.style.zIndex = 1;
n@470: 	interfaceContext.insertPoint.innerHTML = null; // Clear the current schema
n@470: 	
n@470: 	// Inject into HTML
n@470: 	testContent.appendChild(title); // Insert the title
n@470: 	testContent.appendChild(pagetitle);
n@470: 	testContent.appendChild(interfaceButtons);
n@470: 	testContent.appendChild(sliderBox);
n@470: 	testContent.appendChild(feedbackHolder);
n@470: 	interfaceContext.insertPoint.appendChild(testContent);
n@470: 
n@470: 	// Load the full interface
n@470: 	testState.initialise();
n@470: 	testState.advanceState();
n@470: }
n@470: 
n@470: function loadTest(audioHolderObject)
n@470: {
n@470: 	var id = audioHolderObject.id;
n@470: 	
n@470: 	var feedbackHolder = document.getElementById('feedbackHolder');
n@485:     feedbackHolder.innerHTML = null;
n@470: 	var interfaceObj = audioHolderObject.interfaces;
n@470: 	if (interfaceObj.length > 1)
n@470: 	{
n@470: 		console.log("WARNING - This interface only supports one <interface> node per page. Using first interface node");
n@470: 	}
n@470: 	interfaceObj = interfaceObj[0];
n@470: 	if(interfaceObj.title != null)
n@470: 	{
n@470: 		document.getElementById("pageTitle").textContent = interfaceObj.title;
n@470: 	}
n@485:     var interfaceOptions = specification.interfaces.options.concat(interfaceObj.options);
n@485:     for (var option of interfaceOptions)
n@485:     {
n@485:         if (option.type == "show")
n@485:         {
n@485:             switch(option.name) {
n@485:                 case "playhead":
n@485:                     var playbackHolder = document.getElementById('playback-holder');
n@485:                     if (playbackHolder == null)
n@485:                     {
n@485:                         playbackHolder = document.createElement('div');
n@485:                         playbackHolder.style.width = "100%";
n@485:                         playbackHolder.align = 'center';
n@485:                         playbackHolder.appendChild(interfaceContext.playhead.object);
n@485:                         feedbackHolder.appendChild(playbackHolder);
n@485:                     }
n@485:                     break;
n@485:                 case "page-count":
n@485:                     var pagecountHolder = document.getElementById('page-count');
n@485:                     if (pagecountHolder == null)
n@485:                     {
n@485:                         pagecountHolder = document.createElement('div');
n@485:                         pagecountHolder.id = 'page-count';
n@485:                     }
n@559:                     pagecountHolder.innerHTML = '<span>Page '+(testState.stateIndex+1)+' of '+testState.stateMap.length+'</span>';
n@485:                     var inject = document.getElementById('interface-buttons');
n@485:                     inject.appendChild(pagecountHolder);
n@485:                     break;
n@485:                 case "volume":
n@485:                     if (document.getElementById('master-volume-holder') == null)
n@485:                     {
n@485:                         feedbackHolder.appendChild(interfaceContext.volume.object);
n@485:                     }
n@485:                     break;
n@485:             }
n@485:         }
n@485:     }
n@470: 	
n@470: 	// Delete outside reference
n@470: 	var outsideReferenceHolder = document.getElementById('outside-reference');
n@470: 	if (outsideReferenceHolder != null) {
n@470: 		document.getElementById('interface-buttons').removeChild(outsideReferenceHolder);
n@470: 	}
n@470: 	
n@470: 	var sliderBox = document.getElementById('slider-holder');
n@470: 	sliderBox.innerHTML = null;
n@470: 	
n@470: 	var commentBoxPrefix = "Comment on track";
n@470: 	if (interfaceObj.commentBoxPrefix != undefined) {
n@470: 		commentBoxPrefix = interfaceObj.commentBoxPrefix;
n@470: 	}
n@470: 	var loopPlayback = audioHolderObject.loop;
n@470: 	
n@470: 	currentTestHolder = document.createElement('audioHolder');
n@470: 	currentTestHolder.id = audioHolderObject.id;
n@470: 	currentTestHolder.repeatCount = audioHolderObject.repeatCount;
n@470: 	
n@470: 	// Find all the audioElements from the audioHolder
n@470: 	var label = 0;
n@470: 	$(audioHolderObject.audioElements).each(function(index,element){
n@470: 		// Find URL of track
n@470: 		// In this jQuery loop, variable 'this' holds the current audioElement.
n@470: 		
n@470: 		var audioObject = audioEngineContext.newTrack(element);
n@470: 		if (element.type == 'outside-reference')
n@470: 		{
n@470: 			// Construct outside reference;
n@470: 			var orNode = new outsideReferenceDOM(audioObject,index,document.getElementById('interface-buttons'));
n@470: 			audioObject.bindInterface(orNode);
n@470: 		} else {
n@470: 			// Create a slider per track
n@471: 			var sliderObj = new sliderObject(audioObject,label);
n@470: 			
n@470: 			if (typeof audioHolderObject.initialPosition === "number")
n@470: 			{
n@470: 				// Set the values
n@471: 				sliderObj.slider.value = audioHolderObject.initalPosition;
n@470: 			} else {
n@470: 				// Distribute it randomnly
n@471: 				sliderObj.slider.value = Math.random();
n@470: 			}
n@471: 			sliderBox.appendChild(sliderObj.holder);
n@471: 			audioObject.bindInterface(sliderObj);
n@550:             interfaceContext.commentBoxes.createCommentBox(audioObject);
n@470: 			label += 1;
n@470: 		}
n@470:         
n@470: 	});
n@540:     
n@540:     if (audioHolderObject.showElementComments) {
n@550: 		interfaceContext.commentBoxes.showCommentBoxes(feedbackHolder,true);
n@540: 	}
n@540: 	
n@540: 	$(audioHolderObject.commentQuestions).each(function(index,element) {
n@540: 		var node = interfaceContext.createCommentQuestion(element);
n@540: 		feedbackHolder.appendChild(node.holder);
n@540: 	});
n@470: 	
n@470: 	// Auto-align
n@470: 	resizeWindow(null);
n@470: }
n@470: 
n@470: function sliderObject(audioObject,label)
n@470: {
n@470: 	// Constructs the slider object. We use the HTML5 slider object
n@470: 	this.parent = audioObject;
n@470: 	this.holder = document.createElement('div');
n@470: 	this.title = document.createElement('span');
n@470: 	this.slider = document.createElement('input');
n@470: 	this.play = document.createElement('button');
n@470: 	
n@470: 	this.holder.className = 'track-slider';
n@470: 	this.holder.style.height = window.innerHeight-200 + 'px';
n@470: 	this.holder.appendChild(this.title);
n@470: 	this.holder.appendChild(this.slider);
n@470: 	this.holder.appendChild(this.play);
n@470: 	this.holder.align = "center";
n@472: 	if (label == 0)
n@470: 	{
n@470: 		this.holder.style.marginLeft = '0px';
n@470: 	}
n@470: 	this.holder.setAttribute('trackIndex',audioObject.id);
n@470: 	
n@470: 	this.title.textContent = label;
n@470: 	this.title.style.width = "100%";
n@470: 	this.title.style.float = "left";
n@470: 	
n@470: 	this.slider.type = "range";
n@470: 	this.slider.className = "track-slider-range track-slider-not-moved";
n@470: 	this.slider.min = "0";
n@470: 	this.slider.max = "1";
n@470: 	this.slider.step = "0.01";
n@470: 	this.slider.setAttribute('orient','vertical');
n@470: 	this.slider.style.height = window.innerHeight-250 + 'px';
n@470: 	this.slider.onchange = function()
n@470: 	{
n@470: 		var time = audioEngineContext.timer.getTestTime();
n@470: 		var id = Number(this.parentNode.getAttribute('trackIndex'));
n@470: 		audioEngineContext.audioObjects[id].metric.moved(time,this.value);
n@470: 		console.log('slider '+id+' moved to '+this.value+' ('+time+')');
n@470: 		$(this).removeClass('track-slider-not-moved');
n@470: 	};
n@470: 	
n@470: 	this.play.textContent = "Loading...";
n@470: 	this.play.value = audioObject.id;
n@470: 	this.play.style.float = "left";
n@470: 	this.play.style.width = "100%";
n@470: 	this.play.disabled = true;
n@508:     this.play.setAttribute("playstate","ready");
n@470: 	this.play.onclick = function(event)
n@470: 	{
n@470: 		var id = Number(event.currentTarget.value);
n@470: 		//audioEngineContext.metric.sliderPlayed(id);
n@508: 		if (event.currentTarget.getAttribute("playstate") == "ready")
n@508:         {audioEngineContext.play(id);}
n@508:         else if (event.currentTarget.getAttribute("playstate") == "playing")
n@508:         {audioEngineContext.stop();}
n@470: 	};
n@470: 	
n@470: 	this.enable = function() {
n@470: 		this.play.disabled = false;
n@470: 		this.play.textContent = "Play";
n@470: 		$(this.slider).removeClass('track-slider-disabled');
n@470: 	};
n@470: 	
n@470: 	this.exportXMLDOM = function(audioObject) {
n@470: 		// Called by the audioObject holding this element. Must be present
n@470: 		var node = storage.document.createElement('value');
n@470: 		node.textContent = this.slider.value;
n@470: 		return node;
n@470: 	};
n@489:     this.startPlayback = function()
n@489:     {
n@489:         // Called when playback has begun
n@508:         this.play.setAttribute("playstate","playing");
n@489:         $(".track-slider").removeClass('track-slider-playing');
n@489: 		$(this.holder).addClass('track-slider-playing');
n@489: 		var outsideReference = document.getElementById('outside-reference');
n@489: 		if (outsideReference != null) {
n@489: 			$(outsideReference).removeClass('track-slider-playing');
n@489: 		}
n@514:         this.play.textContent = "Stop";
n@489:     };
n@489:     this.stopPlayback = function()
n@489:     {
n@489:         // Called when playback has stopped. This gets called even if playback never started!
n@508:         this.play.setAttribute("playstate","ready");
n@489:         $(this.holder).removeClass('track-slider-playing');
n@514:         this.play.textContent = "Play";
n@489:     };
n@470: 	this.getValue = function() {
n@470: 		return this.slider.value;
n@470: 	};
n@470: 	
n@470: 	this.resize = function(event)
n@470: 	{
n@470: 		this.holder.style.height = window.innerHeight-200 + 'px';
n@470: 		this.slider.style.height = window.innerHeight-250 + 'px';
n@470: 	};
n@470: 	this.updateLoading = function(progress)
n@470: 	{
n@470: 		progress = String(progress);
n@470: 		progress = progress.substr(0,5);
n@470: 		this.play.textContent = "Loading: "+progress+"%";
n@470: 	};
n@470: 	
n@470: 	if (this.parent.state == 1)
n@470: 	{
n@470: 		this.enable();
n@470: 	}
n@470: 	this.getPresentedId = function()
n@470: 	{
n@470: 		return this.title.textContent;
n@470: 	};
n@470: 	this.canMove = function()
n@470: 	{
n@470: 		return true;
n@470: 	};
n@546:     this.error = function() {
n@546:             // audioObject has an error!!
n@546:         this.playback.textContent = "Error";
n@546:         $(this.playback).addClass("error-colour");
n@546:     }
n@470: }
n@470: 
n@470: function outsideReferenceDOM(audioObject,index,inject)
n@470: {
n@470: 	this.parent = audioObject;
n@470: 	this.outsideReferenceHolder = document.createElement('button');
n@470: 	this.outsideReferenceHolder.id = 'outside-reference';
n@470: 	this.outsideReferenceHolder.className = 'outside-reference';
n@470: 	this.outsideReferenceHolder.setAttribute('track-id',index);
n@470: 	this.outsideReferenceHolder.textContent = "Play Reference";
n@470: 	this.outsideReferenceHolder.disabled = true;
n@470: 	
n@470: 	this.outsideReferenceHolder.onclick = function(event)
n@470: 	{
n@470: 		audioEngineContext.play(event.currentTarget.getAttribute('track-id'));
n@470: 	};
n@470: 	inject.appendChild(this.outsideReferenceHolder);
n@470: 	this.enable = function()
n@470: 	{
n@470: 		if (this.parent.state == 1)
n@470: 		{
n@470: 			this.outsideReferenceHolder.disabled = false;
n@470: 		}
n@470: 	};
n@470: 	this.updateLoading = function(progress)
n@470: 	{
n@470: 		if (progress != 100)
n@470: 		{
n@470: 			progress = String(progress);
n@470: 			progress = progress.split('.')[0];
n@470: 			this.outsideReferenceHolder[0].children[0].textContent = progress+'%';
n@470: 		} else {
n@470: 			this.outsideReferenceHolder[0].children[0].textContent = "Play Reference";
n@470: 		}
n@470: 	};
n@489:     this.startPlayback = function()
n@489:     {
n@489:         // Called when playback has begun
n@489:         $('.track-slider').removeClass('track-slider-playing');
n@489:         $('.comment-div').removeClass('comment-box-playing');
n@489:         $(this.outsideReferenceHolder).addClass('track-slider-playing');
n@489:     };
n@489:     this.stopPlayback = function()
n@489:     {
n@489:         // Called when playback has stopped. This gets called even if playback never started!
n@489:         $(this.outsideReferenceHolder).removeClass('track-slider-playing');
n@489:     };
n@470: 	this.exportXMLDOM = function(audioObject)
n@470: 	{
n@470: 		return null;
n@470: 	};
n@470: 	this.getValue = function()
n@470: 	{
n@470: 		return 0;
n@470: 	};
n@470: 	this.getPresentedId = function()
n@470: 	{
n@470: 		return 'reference';
n@470: 	};
n@470: 	this.canMove = function()
n@470: 	{
n@470: 		return false;
n@470: 	};
n@546:     this.error = function() {
n@546:             // audioObject has an error!!
n@546:         this.outsideReferenceHolder.textContent = "Error";
n@546:         $(this.outsideReferenceHolder).addClass("error-colour");
n@546:     }
n@470: }
n@470: 
n@470: function resizeWindow(event)
n@470: {
n@470: 	// Function called when the window has been resized.
n@470: 	// MANDATORY FUNCTION
n@470: 	
n@470: 	var outsideRef = document.getElementById('outside-reference');
n@470: 	if(outsideRef != null)
n@470: 	{
n@470: 		outsideRef.style.left = (window.innerWidth-120)/2 + 'px';
n@470: 	}
n@470: 	
n@470: 	// Auto-align
n@470: 	var numObj = document.getElementsByClassName('track-slider').length;
n@470: 	var totalWidth = (numObj-1)*150+100;
n@470: 	var diff = (window.innerWidth - totalWidth)/2;
n@470: 	document.getElementById('slider').style.height = window.innerHeight - 180 + 'px';
n@470: 	if (diff <= 0){diff = 0;}
n@470: 	document.getElementById('slider-holder').style.marginLeft = diff + 'px';
n@470: 	for (var i in audioEngineContext.audioObjects)
n@470: 	{
n@470: 		if (audioEngineContext.audioObjects[i].specification.type != 'outside-reference'){
n@470: 			audioEngineContext.audioObjects[i].interfaceDOM.resize(event);
n@470: 		}
n@470: 	}
n@470: 	document.getElementById('scale-holder').style.marginLeft = (diff-100) + 'px';
n@470: 	document.getElementById('scale-text-holder').style.height = window.innerHeight-194 + 'px';
n@470: 	var canvas = document.getElementById('scale-canvas');
n@470: 	canvas.width = totalWidth;
n@470: 	canvas.height = window.innerHeight-194;
n@470: 	drawScale();
n@470: }
n@470: 
n@470: function drawScale()
n@470: {
n@470: 	var interfaceObj = testState.currentStateMap.interfaces[0];
n@470: 	var scales = testState.currentStateMap.interfaces[0].scales;
n@470: 	scales = scales.sort(function(a,b) {
n@470: 		return a.position - b.position;
n@470: 	});
n@470: 	var canvas = document.getElementById('scale-canvas');
n@470: 	var ctx = canvas.getContext("2d");
n@470: 	var height = canvas.height;
n@470: 	var width = canvas.width;
n@470: 	var draw_heights = [24, height-34];
n@470: 	var textHolder = document.getElementById('scale-text-holder');
n@470: 	textHolder.innerHTML = null;
n@470: 	var lastHeight = 0;
n@470: 	for (var scale of scales)
n@470: 	{
n@470: 		var posPercent = scale.position / 100.0;
n@470: 		var posPix = (1-posPercent)*(draw_heights[1]-draw_heights[0])+draw_heights[0];
n@470: 		ctx.fillStyle = "#000000";
n@470: 		ctx.setLineDash([1,2]);
n@470: 		ctx.moveTo(0,posPix);
n@470: 		ctx.lineTo(width,posPix);
n@470: 		ctx.stroke();
n@470: 		var text = document.createElement('div');
n@470: 		text.align = "right";
n@470: 		var textC = document.createElement('span');
n@470: 		textC.textContent = scale.text;
n@470: 		text.appendChild(textC);
n@470: 		text.className = "scale-text";
n@470: 		textHolder.appendChild(text);
n@470: 		text.style.top = (posPix-9) + 'px';
n@470: 		text.style.left = 100 - ($(text).width()+3) + 'px';
n@470: 		lastHeight = posPix;
n@470: 	}
n@470: }
n@470: 
n@470: function buttonSubmitClick() // TODO: Only when all songs have been played!
n@470: {
n@470: 	var checks = [];
n@470: 	checks = checks.concat(testState.currentStateMap.interfaces[0].options);
n@470: 	checks = checks.concat(specification.interfaces.options);
n@470: 	var canContinue = true;
n@470: 	
n@470: 	// Check that the anchor and reference objects are correctly placed
n@470: 	if (interfaceContext.checkHiddenAnchor() == false) {return;}
n@470: 	if (interfaceContext.checkHiddenReference() == false) {return;}
n@470: 	
n@470: 	for (var i=0; i<checks.length; i++) {
n@470: 		if (checks[i].type == 'check')
n@470: 		{
n@470: 			switch(checks[i].name) {
n@470: 			case 'fragmentPlayed':
n@470: 				// Check if all fragments have been played
n@470: 				var checkState = interfaceContext.checkAllPlayed();
n@470: 				if (checkState == false) {canContinue = false;}
n@470: 				break;
n@470: 			case  'fragmentFullPlayback':
n@470: 				// Check all fragments have been played to their full length
n@470: 				var checkState = interfaceContext.checkAllPlayed();
n@470: 				if (checkState == false) {canContinue = false;}
n@470: 				console.log('NOTE: fragmentFullPlayback not currently implemented, performing check fragmentPlayed instead');
n@470: 				break;
n@470: 			case 'fragmentMoved':
n@470: 				// Check all fragment sliders have been moved.
n@470: 				var checkState = interfaceContext.checkAllMoved();
n@470: 				if (checkState == false) {canContinue = false;}
n@470: 				break;
n@470: 			case 'fragmentComments':
n@470: 				// Check all fragment sliders have been moved.
n@470: 				var checkState = interfaceContext.checkAllCommented();
n@470: 				if (checkState == false) {canContinue = false;}
n@470: 				break;
n@470: 			//case 'scalerange':
n@470: 				// Check the scale is used to its full width outlined by the node
n@470: 				//var checkState = interfaceContext.checkScaleRange();
n@470: 				//if (checkState == false) {canContinue = false;}
n@470: 			//	break;
n@470: 			default:
n@470: 				console.log("WARNING - Check option "+checks[i].check+" is not supported on this interface");
n@470: 				break;
n@470: 			}
n@470: 
n@470: 		}
n@470: 		if (!canContinue) {break;}
n@470: 	}
n@470: 	
n@470:     if (canContinue) {
n@470: 	    if (audioEngineContext.status == 1) {
n@470: 	        var playback = document.getElementById('playback-button');
n@470: 	        playback.click();
n@470: 	    // This function is called when the submit button is clicked. Will check for any further tests to perform, or any post-test options
n@470: 	    } else
n@470: 	    {
n@470: 	        if (audioEngineContext.timer.testStarted == false)
n@470: 	        {
n@470: 	            alert('You have not started the test! Please press start to begin the test!');
n@470: 	            return;
n@470: 	        }
n@470: 	    }
n@470: 	    testState.advanceState();
n@470:     } 
n@470: }
n@470: 
n@470: function pageXMLSave(store, pageSpecification)
n@470: {
n@470: 	// MANDATORY
n@470: 	// Saves a specific test page
n@470: 	// You can use this space to add any extra nodes to your XML <audioHolder> saves
n@470: 	// Get the current <page> information in store (remember to appendChild your data to it)
n@470: 	// pageSpecification is the current page node configuration
n@470: 	// To create new XML nodes, use storage.document.createElement();
n@470: }