Thread: [virtualcommons-svn] SF.net SVN: virtualcommons:[413] mentalmodels/trunk/flex/src (Page 3)

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Revision: 413
          http://virtualcommons.svn.sourceforge.net/virtualcommons/?rev=413&view=rev
Author:   kjonas
Date:     2009-12-10 21:56:15 +0000 (Thu, 10 Dec 2009)

Log Message:
-----------
added comments to custom/FisheryExperimentCore.mxml and FisheryExperimentShell.mxml

Modified Paths:
--------------
    mentalmodels/trunk/flex/src/FisheryExperimentShell.mxml
    mentalmodels/trunk/flex/src/custom/FisheryExperimentCore.mxml

Modified: mentalmodels/trunk/flex/src/FisheryExperimentShell.mxml
===================================================================

--- mentalmodels/trunk/flex/src/FisheryExperimentShell.mxml	2009-12-08 20:47:25 UTC (rev 412)
+++ mentalmodels/trunk/flex/src/FisheryExperimentShell.mxml	2009-12-10 21:56:15 UTC (rev 413)
@@ -9,6 +9,8 @@
 		[Bindable] public var progressBarWidth:Number = 600;
 		private var repetitions:int = 100;
 		
+		// This timer ticks every 100 milliseconds
+		// repetitions need to be seconds * 10
 		public function setProgressBarTime(hours:int,minutes:int,seconds:int):void
 		{
 			repetitions = seconds * 10;
@@ -23,18 +25,16 @@
 		}
 		public function timerTick(event:TimerEvent):void
 		{
-			tick(progressTimer.currentCount/progressTimer.repeatCount);
+			// set to current/total % of the full progressbar's width
+			progressBarBlock.width = progressBarWidth*(progressTimer.currentCount/progressTimer.repeatCount);
 		}
-		private function tick(percentBlock:Number):void
-		{
-			progressBarBlock.width = progressBarWidth*percentBlock;
-		}
 	]]></mx:Script>
 	
 	<mx:HBox id="shell" horizontalGap="30"
 		y="{(height - shell.height)/2}"
 		x="{(width - shell.width)/2}">
 		
+		<!-- information windows -->
 		<mx:VBox id="vbxInfo">
 			<mx:TitleWindow id="InformationWindowA" width="400" height="220" title="Information Window A"
 				clipContent="true" horizontalScrollPolicy="on" verticalScrollPolicy="on">
@@ -54,6 +54,7 @@
 			
 			<mx:Button id="btnResetPopups" label="Reset Popups" click="{closedFunction(1);closedFunction(2)}"/>
 		</mx:VBox>
+		<!-- END information windows -->
 		
 		<mx:VBox id="vbxContent" horizontalAlign="center" verticalAlign="middle">
 			<mx:VBox id="progressBars" x="0" y="0" verticalGap="0">
@@ -84,15 +85,20 @@
 			import mx.managers.PopUpManager;
 			import mx.messaging.events.MessageFaultEvent;
 			
+			// These are the actual windows that pop up and can be moved around
 			public var popupA:InformationWindowPopup = null;
 			public var popupB:InformationWindowPopup = null;
 			
+			// Lists that contain the data that goes into information windows
 			public var allInfoWindowsA:ArrayCollection = null;
 			public var allInfoWindowsB:ArrayCollection = null;
 			public var allInfoWindowsDescriptions:ArrayCollection = null;
+			
+			// used to update things like daybydaydecisions within information windows 
 			public var updateObjectA:InformationWindowCreator = null;
 			public var updateObjectB:InformationWindowCreator = null;
 			
+			// list of the windows available for this block
 			public var currInfoWindowsA:ArrayCollection = null;
 			public var currInfoWindowsB:ArrayCollection = null;
 			public var currInfoWindowsDescriptions:ArrayCollection = null;
@@ -109,8 +115,18 @@
 				var str:String = msg.body as String;
 				Alert.show("String came from server: " + str);
 			}
+			
 			public function init():void
 			{
+				initWindows();
+			}
+			
+			// Since the FisheryExperimentShell file is largely concerned with
+			//  information windows, this function creates lists of all possible windows
+			// A and B copies must be generated, as Flex will not allow us to display the
+			//  same component in two different locations 
+			public function initWindows():void
+			{
 				// temporarily store all 3 objects returned...
 				allInfoWindowsA = makeWindows();
 				allInfoWindowsB = makeWindows();
@@ -127,36 +143,36 @@
 				
 				// Display only the default windows.
 				selectCurrentWindows( new ArrayCollection() );
-				
 			}
 			
+			// pops up window 1 or 2 (A or B)
+			// This function takes all the data from an information window and puts it into
+			//  a larger popup that can be dragged around the screen. 
 			public function popupInformationWindow(window:int):void
 			{
 				var temp:DisplayObject = null;
 				
+				// first, create the popup (object. this does not make it visible)
 				var popupNew:InformationWindowPopup = PopUpManager.createPopUp(this, InformationWindowPopup, false) as InformationWindowPopup;
 				popupNew.closedFunction = closedFunction;
 				popupNew.window = window;
 				
 				var old:TitleWindow = null;
 				
-				if(window == 1)
-				{
-					old = InformationWindowA;
-					popupA = popupNew;
-					btnPickerA.enabled = cbxPickerA.enabled = false;
-				}
-				else if(window == 2)
-				{
-					old = InformationWindowB;
-					popupB = popupNew;
-					btnPickerB.enabled = cbxPickerB.enabled = false;
-				}
-				else
-				{
+				// set up some variables
+				if(window == 1){
+					old = InformationWindowA; // data source
+					popupA = popupNew; // data destination
+					btnPickerA.enabled = cbxPickerA.enabled = false; // only one "A" popup at a time
+				}else if(window == 2){
+					old = InformationWindowB; // data source
+					popupB = popupNew; // data destination
+					btnPickerB.enabled = cbxPickerB.enabled = false; // only one "B" popup at a time
+				}else{
 					return;
 				}
 				
+				// transfer all data, scale to full size
 				while(old != null && old.numChildren > 0)
 				{
 					temp = old.removeChildAt(0);
@@ -165,14 +181,17 @@
 					popupNew.addChild(temp);
 				}
 				
+				// show the popup itself
 				PopUpManager.centerPopUp(popupNew);
 			}
 			
+			// Closing all popups
 			public function closedFunction(window:int):void
 			{
 				var temp:DisplayObject = null;
 				if(popupA != null && window == 1)
 				{
+					// transfer all data, scale to 75%
 					while(popupA.numChildren > 0)
 					{
 						temp = popupA.removeChildAt(0);
@@ -180,12 +199,14 @@
 						temp.scaleY = 0.75;
 						InformationWindowA.addChild(temp);
 					}
+					// destroy the popup
 					PopUpManager.removePopUp(popupA);
 					popupA = null;
 				}
 				
 				if(popupB != null && window == 2)
 				{
+					// transfer all data, scale to 75%
 					while(popupB.numChildren > 0)
 					{
 						temp = popupB.removeChildAt(0)
@@ -193,14 +214,18 @@
 						temp.scaleY = 0.75;
 						InformationWindowB.addChild(temp);
 					}
+					// destroy the popup
 					PopUpManager.removePopUp(popupB);
 					popupB = null;
 				}
 				
+				// allow "A" and "B" to be popped up again
 				btnPickerA.enabled = btnPickerB.enabled = true;
 				cbxPickerA.enabled = cbxPickerB.enabled = true;
 			}
 			
+			// generates and returns a list of all possible information windows
+			//  and saves their descriptions to a single arraycollection
 			public function makeWindows():ArrayCollection
 			{
 				var windowData:ArrayCollection = InformationWindowCreator.makeWindows();
@@ -209,19 +234,26 @@
 				return windowData;
 			}
 			
+			// only enable the user to see the windows associated with the current block
 			public function selectCurrentWindows(selectedWindows:ArrayCollection):void
 			{
+				// these windows are mandatory: 0,2,3
 				var mustHaveWindows:ArrayCollection = new ArrayCollection([0,2,3]);
 				
+				// close all popups.
 				closedFunction(1);
 				closedFunction(2);
 				
+				// drop data from previous executions
 				currInfoWindowsA = new ArrayCollection();
 				currInfoWindowsB = new ArrayCollection();
 				currInfoWindowsDescriptions = new ArrayCollection();
 				
+				// sort through all possible windows
 				for(var i:int = 0; i < allInfoWindowsA.length; i++)
 				{
+					// if any window is in the list for the block, or mandatory
+					//  then add it to the lists of current windows
 					if(selectedWindows.contains(i) || mustHaveWindows.contains(i))
 					{
 						currInfoWindowsA.addItem(allInfoWindowsA.getItemAt(i));
@@ -229,20 +261,25 @@
 						currInfoWindowsDescriptions.addItem(allInfoWindowsDescriptions.getItemAt(i));
 					}
 				}
-				
 				cbxPickerA.dataProvider = currInfoWindowsDescriptions;
 				cbxPickerB.dataProvider = currInfoWindowsDescriptions;
 				
+				// refresh the information windows on the sides
 				cbxChanged();
 			}
 			
+			// refreshes which information window is shown (ex: user switches selection, or new block)
 			public function cbxChanged():void
 			{
 				var temp:DisplayObject = null;
+				
+				// if a valid selection is made
 				if(cbxPickerA.selectedIndex >= 0 && cbxPickerA.selectedIndex <= currInfoWindowsA.length && cbxPickerA.enabled)
 				{
+					// discard old data
 					InformationWindowA.removeAllChildren();
 					
+					// transfer all data, scale to 75%
 					var windowA:ArrayCollection = currInfoWindowsA.getItemAt(cbxPickerA.selectedIndex) as ArrayCollection;
 					for(var i:int = 0; i < windowA.length; i++)
 					{
@@ -253,10 +290,13 @@
 					}
 				}
 				
+				// if a valid selection is made
 				if(cbxPickerB.selectedIndex >= 0 && cbxPickerB.selectedIndex <= currInfoWindowsB.length && cbxPickerB.enabled)
 				{
+					// discard old data
 					InformationWindowB.removeAllChildren();
 					
+					// transfer all data, scale to 75%
 					var windowB:ArrayCollection = currInfoWindowsB.getItemAt(cbxPickerB.selectedIndex) as ArrayCollection;
 					for(var j:int = 0; j < windowB.length; j++)
 					{
@@ -268,16 +308,20 @@
 				}
 			}
 			
+			// new block is received
 			public function loadBlock(block:Block):void
 			{
 				if(block != null)
 				{
+					// store the new block
 					currentBlock = block;
+					
 					var tempArray:ArrayCollection = new ArrayCollection();
-					
 					var i:int = 0;
 					var temp:Object = null;
 					
+					// search the block's information windows for all valid "BlockInformationWindow" objects
+					//  add the valid ones to the list of desired windows and update the display
 					var str:String = currentBlock.informationWindows.length + " of them.\n";
 					for(i = 0; i < currentBlock.informationWindows.length; i++)
 					{

Modified: mentalmodels/trunk/flex/src/custom/FisheryExperimentCore.mxml
===================================================================
--- mentalmodels/trunk/flex/src/custom/FisheryExperimentCore.mxml	2009-12-08 20:47:25 UTC (rev 412)
+++ mentalmodels/trunk/flex/src/custom/FisheryExperimentCore.mxml	2009-12-10 21:56:15 UTC (rev 413)
@@ -5,6 +5,8 @@
 	width="720" height="490">
 	
 	<mx:states>
+		<!-- This state has nothing but the sociodemographic information
+		It is used to get the game ID to connect to the server -->
 		<mx:State name="socioDemographic">
 			<mx:AddChild relativeTo="{content}">
 				<comp:SocioDemographicPage id="socioDemographic"
@@ -14,6 +16,7 @@
 			<mx:SetStyle target="{content}" name="horizontalCenter" value="0"/>
 		</mx:State>
 		
+		<!-- This is a temporary state that jumpstarts the "instructions" state for the first time -->
 		<mx:State name="instructionsLoad">
 			<mx:AddChild relativeTo="{content}">
 				<comp:InstructionPage id="instructions" initialize="gotoInstructions()" x="0" y="0"
@@ -21,25 +24,28 @@
 			</mx:AddChild>
 		</mx:State>
 		
+		<!-- This state displays Blocks received from the server using InstructionPage -->
 		<mx:State name="instructions" enterState="instructions.init(currentBlock)">
 			<mx:RemoveChild target="{instructions}"/>
 			<mx:AddChild relativeTo="{content}" target="{instructions}"/>
 			<mx:SetProperty target="{instructions}" name="visible" value="true"/>
 		</mx:State>
 		
+		<!-- This state is used between Blocks (ex: a student finishes a block early) -->
 		<mx:State name="wait">
 			<mx:AddChild relativeTo="{content}">
 				<mx:Label id="lblWaiting" text="Waiting for next Block from server..." fontSize="16"/>
 			</mx:AddChild>
 		</mx:State>
 		
+		<!-- This state should only show up when the game is completely finished -->
 		<mx:State name="none">
-			<!--<mx:RemoveChild target="{instructions}"/>-->
 			<mx:AddChild relativeTo="{expiredContent}" target="{instructions}"/>
 			<mx:SetProperty target="{instructions}" name="visible" value="false"/>
 			<mx:AddChild relativeTo="{content}">
 				<mx:Label id="end" text="Thank you for playing!" fontSize="30"/>
 			</mx:AddChild>
+			<!-- disable navigation buttons -->
 			<mx:SetProperty target="{btnAccept}" name="enabled" value="false"/>
 			<mx:SetProperty target="{btnReset}" name="enabled" value="false"/>
 			<mx:SetProperty target="{btnBack}" name="enabled" value="false"/>
@@ -47,9 +53,12 @@
 		</mx:State>
 	</mx:states>
 	
+	<!-- Content - SocioDemographicPage or InstructionPage or "THE END" (visible to user)
+	ExpiredContent - holds sociodemographic and instructionpage so they aren't destroyed (invisible to user) -->
 	<mx:Canvas id="content" x="0" y="0" width="720" height="460"/>
 	<mx:Canvas id="expiredContent" x="-1" y="-1" width="1" height="1" visible="false"/>
 	
+	<!-- Navigation Buttons -->
 	<mx:HBox id="buttonBar" left="{(width-buttonBar.width)/2}" bottom="0" horizontalGap="100">
 		<mx:Button id="btnBack" label="« Back" click="back()" enabled="false"/>
 		<mx:Button id="btnAccept" label="Accept" click="accept()" />
@@ -57,7 +66,7 @@
 		<mx:Button id="btnForward" label="Forward »" click="forward()" enabled="false"/>
 	</mx:HBox>
 	
-	
+	<!-- services that control the connection to the server -->
 	<mx:RemoteObject id="studentService" destination="studentService" fault="faultHandler(event)">
 		<mx:method name="createStudent" result="studentResultHandler(event)"/>
 	</mx:RemoteObject>
@@ -68,7 +77,8 @@
 		<mx:method name="getAllLocations" result="locationResultHandler(event)"/>
 	</mx:RemoteObject>
 	
-
+	<!-- Using Consumer instead of service so that the server can control
+	when responses are sent to multiple clients, (ex: end of block) -->
 	<mx:Consumer id="consumer"  destination="mme" message="messageHandler(event)" fault="faultMsgHandler(event)" channelSet="{cs}" />
 	
 	<mx:ChannelSet id="cs">
@@ -106,22 +116,21 @@
 			// Important Variables
 			//
 			public var gameObject:actionscript.Game = null;
-//			public var currentModule:Module = null;
-//			public var currentModuleNumber:int = 0;
 			public var currentBlock:Block = null;
 			public var currentBlockNumber:int = 0;
 			[Bindable] public var locations:ArrayCollection = new ArrayCollection([newLocation(0, 0)]);
+			public var instructionsLoaded:Boolean = false;
+			[Bindable] public var studentObject:actionscript.Student;
+			[Bindable] public var roundObject:actionscript.Round;
 			
+			// should be set when created by the FisheryExperimentShell (aka "shell")
 			public var shell:FisheryExperimentShell = null;
 			
+			// information window objects given by the shell
 			public var updateObjectA:InformationWindowCreator = null;
 			public var updateObjectB:InformationWindowCreator = null;
 			
-			public var instructionsLoaded:Boolean = false;
 			
-			[Bindable] public var studentObject:actionscript.Student;
-			[Bindable] public var roundObject:actionscript.Round;
-			
 			public function faultMsgHandler(msgevent:MessageFaultEvent):void
 			{
 				Alert.show("Error in getting message: " + msgevent.faultString);
@@ -131,6 +140,10 @@
 			{
 				var msg:IMessage;
 				
+				// Responds to receiving a Block or Game by initializing the new block included
+				// Responds to ArrayCollection by assuming it is of Student objects
+				//  This code assigns group and student numbers based on the object whose id
+				//  matches studentObject
 				if(event.message.body is actionscript.Block)
 				{
 					setBlock(event.message.body as actionscript.Block);
@@ -163,32 +176,36 @@
 //					Alert.show("Current Student Information is: " + "\n"+studentObject.id +"\n"+studentObject.gameCode+"\n"+studentObject.studentNo);
 				}
 			}
-			private function blockResultHandler(event:ResultEvent):void
-			{
-				setBlock(event.result as actionscript.Block);
-			}
+			
+			// new block received
 			private function setBlock(block:Block):void
 			{
-//				Alert.show(currentState);
+				// if the game is over, pop up an error message
 				if(currentState == "none")
 				{
 					Alert.show("Block received in End of Game state.","Unexpected Block");
 				}
+				// if we're waiting for a block, call the function to load the new block
 				else if(currentState == "wait")
 				{
 					loadNextBlock(block);
 				}
+				// if we're not finished with the last block, force it to complete, then load the new block
 				else if(currentState == "instructions")
 				{
-//					Alert.show("FORCING");
 					accept(true);
 					loadNextBlock(block);
 				}
+				// if we're not ready for any blocks, show an error
+				// This will cause a crash for this client
+				//  but this should never happen
 				else if(currentState == "socioDemographic")
 				{
 					currentState = "none";
 					Alert.show("Block received in Socio Demographic state.","Unexpected Block");
 				}
+				// If somehow receiving a second block before loading the first is finished
+				//  avoid conflicts and corrupt data by crashing
 				else if(currentState == "instructionsLoad")
 				{
 					currentState = "none";
@@ -200,24 +217,34 @@
 			{
 				var newLoc:Location = new Location();
 				//newLoc.maxCapacity = maxCapacity;
-				newLoc.growthRate = growth;
 				//newLoc.initialPopulation = maxCapacity / 2.0;
+				newLoc.growthRate = growth;
 				return newLoc;
 			}
-			
 					
 			public function init():void
 			{
-				
+				// asks server to get the list of all locations
 				getLocations();
 			}
 			
+			// asks server to get the list of all locations
+			private function getLocations():void
+			{
+				locationService.getAllLocations();
+			}
+			
+			// this method executed when the instructionsLoad
 			private function gotoInstructions():void
 			{
+				// enable navigation
 				btnForward.enabled = btnBack.enabled = btnReset.enabled = true;
+				
 				instructionsLoaded = true;
 				currentState = "instructions";
 			}
+			
+			// sends answers to questions to the server
 			private function sendBlockQuestions():void
 			{
 				if(currentBlock == null) return;
@@ -226,10 +253,12 @@
 				var studentResponse:StudentResponse;
 				var pages:ArrayCollection = instructions.pageDisplay.pages;
 				
+				// for each page...
 				for(var i:int=0; i<pages.length; i++)
 				{
 					var curr:VBox = pages.getItemAt(i) as VBox
 					
+					// for each question...
 					for(var j:int=0; j<curr.numChildren; j++)
 					{
 						studentResponse = new StudentResponse();
@@ -238,6 +267,7 @@
 						
 						var row:int, col:int;
 						
+						// try to get a student response and send it
 						if(curr.getChildAt(j) is TextQuestionC)
 						{
 							studentResponse.question = (curr.getChildAt(j) as TextQuestionC).question;
@@ -308,7 +338,6 @@
 						}
 						else if(curr.getChildAt(j) is StrategyDesignQuestionC)
 						{
-//							Alert.show("Strategy Saving");
 							studentResponse.response = null;
 							studentResponse.question = null;
 							
@@ -326,6 +355,7 @@
 							answeringService.saveStrategy(tempDBObjects);
 						}
 						
+						// if there was a question found, add it to the list to submit
 						if(studentResponse.question != null)
 						{
 							responseList.addItem(studentResponse);
@@ -333,14 +363,11 @@
 					}
 				}
 				
+				// submit the list of answers
 				answeringService.saveQuestion(responseList);
 			}
 			
-			private function getLocations():void
-			{
-				locationService.getAllLocations();
-			}
-			
+			// save the last instances of each key component to the shell for use in information windows
 			private function saveDataToShell():void
 			{
 				if(instructions.savedDayByDayDecisions != null)
@@ -362,6 +389,7 @@
 				}
 			}
 			
+			// When a new block is received, this method is executed
 			private function loadNextBlock(nextBlock:Block):void
 			{
 				// save questions from previous Block
@@ -372,7 +400,7 @@
 					saveDataToShell();
 				}
 				
-				// update with new block
+				// update reference to recently received block
 				currentBlock = nextBlock;
 				
 				if(currentBlock == null
@@ -384,6 +412,8 @@
 					return;
 				}
 				
+				// If this is the first block, make sure instructions have been loaded first
+				//  (instructionsLoad state will proceed to instructions afterward) 
 				if(!instructionsLoaded)
 				{
 					currentState = "instructionsLoad";
@@ -393,46 +423,18 @@
 					gotoInstructions();
 				}
 				
+				// tell shell that a new block has arrived
 				shell.loadBlock(currentBlock);
 				
-				// start timer to alert students to hurry
+				// start timer
 				shell.setProgressBarTime(0,0,currentBlock.duration);
 				shell.progressBarInit();
 			}
-//			private function moduleResultHandler(event:ResultEvent):void
-//			{
-//				currentModule = (event.result as actionscript.Module);
-//				
-//				if(currentModule == null)
-//				{
-//					currentState = "none";
-//				}
-//				else if(currentModule.blocks == null || currentModule.blocks.length < 1 ||
-//				(currentModule.blocks.getItemAt(0) as Block) == null ||
-//				(currentModule.blocks.getItemAt(0) as Block).questionGroups == null ||
-//				(currentModule.blocks.getItemAt(0) as Block).questionGroups.length < 1)
-//				{
-//					currentState = "none";
-//				}
-//				else if(!instructionsLoaded)
-//				{
-//					currentState = "instructionsLoad";
-//				}
-//				else
-//				{
-//					gotoInstructions();
-//				}
-//			}
 			
-			public function getLocation():void
-			{
-				
-			}
 			private function locationResultHandler(event:ResultEvent):void
 			{
 				if(event.result is ArrayCollection)
 				{
-//					Alert.show(""+(event.result as ArrayCollection).length,"locations received");
 					locations = event.result as ArrayCollection;
 					if(instructions != null)
 					{
@@ -442,16 +444,17 @@
 			}
 			private function strategyResultHandler(event:ResultEvent):void
 			{
-				Alert.show("Strategy Saved");
+				//Alert.show("Strategy Saved");
 			}
 			
+			// complete student object received from server
 			private function studentResultHandler(event:ResultEvent):void
 			{
 				studentObject = event.result as actionscript.Student;	
 			
 				if(studentObject == null)
 				{
-					Alert.show("event.result is null");
+					Alert.show("event.result is null in studentResultHandler()");
 				}
 				else
 				{
@@ -466,44 +469,37 @@
 				Alert.show("Fault:\n"+event.fault.message + "\n" + event.fault.getStackTrace());
 			}
 			
+			// navigation
 			public function back():Boolean
 			{
-				if(content.numChildren == 0)
-				{ return false; }
+				if(content.numChildren == 0) return false;
 				var obj:DisplayObject = content.getChildAt(0);
 				
-				if(obj is InstructionPage)
-				{
-					try
-					{
+				if(obj is InstructionPage){
+					try{
 						return (InstructionPage)(obj).back();
-					}
-					catch(err:Error){}
+					}catch(err:Error){}
 				}
 				return false;
 			}
 			
 			public function forward():Boolean
 			{
-				if(content.numChildren == 0)
-				{ return false; }
+				if(content.numChildren == 0) return false;
 				var obj:DisplayObject = content.getChildAt(0);
 				
-				if(obj is InstructionPage)
-				{
-					try
-					{
+				if(obj is InstructionPage){
+					try{
 						return (InstructionPage)(obj).forward();
-					}
-					catch(err:Error){}
+					}catch(err:Error){}
 				}
 				return false;
 			}
 			
+			// user says they are done with the block/sociodem
 			public function accept(force:Boolean=false):Boolean
 			{
-				if(content.numChildren == 0)
-				{ return false; }
+				if(content.numChildren == 0) return false;
 				
 				var obj:DisplayObject = content.getChildAt(0);
 				var returnValue:Boolean = false;
@@ -515,6 +511,7 @@
 						obj.visible = false;
 						expiredContent.addChild(obj);
 						
+						// feed the info for a student into an object and send to server
 						var newStudent:actionscript.Student = new actionscript.Student();
 						newStudent.birthYear = (int)((obj as SocioDemographicPage).getYear());
 						newStudent.gender = (obj as SocioDemographicPage).getGender();
@@ -524,10 +521,10 @@
 						
 						studentService.createStudent(newStudent);
 						
+						// move from sociodemographic state to waiting for next block
 						currentState = "wait";
 						btnBack.enabled = btnForward.enabled = btnReset.enabled = true;
 						
-						//getNextBlock();
 						returnValue = true;
 					}
 				}
@@ -541,9 +538,7 @@
 							obj.visible = false;
 							expiredContent.addChild(obj);
 							currentState = "wait";
-							//consumer.subscribe();
 							
-							//getNextBlock();
 							returnValue = true;
 						}
 					}
@@ -553,11 +548,13 @@
 					}
 				}
 				
+				// enable navigation if the current state is instructions
 				btnBack.enabled = btnForward.enabled = btnReset.enabled = (currentState == "instructions");
 				
 				return returnValue;
 			}
 			
+			// try to reset questions on any instruction pages
 			public function reset():void
 			{
 				if(content.getChildAt(0) is InstructionPage)


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.


