mako 0.0.0

data/lib/mako/data/flash_widget_dev_core/src/materia/utils/CommonUtils.as

@@ -0,0 +1,186 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  UCF COURSE DEVELOPMENT AND WEB SERVICES
+//  Copyright 2009 UCF Course Development and Web Services
+//  All Rights Reserved.
+//
+//  NOTICE: Course Development and Webservices prohibits the use of the
+//  following code without explicit permission.  Permission can be obtained
+//  from the New Media team at <newmedia@mail.ucf.edu>.
+//
+////////////////////////////////////////////////////////////////////////////////
+package materia.utils
+{
+	import mx.utils.ObjectUtil;
+	/**
+	 *  A class full utility functions to be used across Kogneato
+	 */
+	public class CommonUtils
+	{
+		//--------------------------------------------------------------------------
+		//
+		//  Static Functions
+		//
+		//--------------------------------------------------------------------------
+		/**
+		 *  Number compares two strings that have numbers
+		 *
+		 *  @returns an integer that determines the result of comparison
+		 *  if n1 > n2	return 1
+		 *  if n1 < n2	return -1
+		 *  if n1 = n2	return 0
+		 *  </p>
+		 */
+		public static function stringNumberCompare(n1:String, n2:String):int
+		{
+			//trace("n1 = " + n1 + ", n2 = " + n2);
+			//hacky fix for N/A showing before 0
+			// we changed the N/A to "- - -"
+			if(n1 == "N/A" || n1 === "- - -")
+			{
+				n1 = "-9999";
+			}
+			if(n2 == "N/A" || n2 === "- - -")
+			{
+				n2 = "-9999";
+			}
+			if(Number(n1) > Number(n2)) return 1;
+			else if(Number(n1) < Number(n2)) return -1;
+			return 0;
+		}
+		public static function getStringNumberCompareOn(field:String):Function
+		{
+			var f:Function = function(obj1:Object, obj2:Object):int
+			{
+				return stringNumberCompare(obj1[field], obj2[field]);
+			}
+			return f;
+		}
+		public static function stringCompare(s1:String, s2:String):int
+		{
+			return ObjectUtil.stringCompare(s1.toUpperCase(),s2.toUpperCase());
+		}
+		public static function getStringCompareOn(field:String):Function
+		{
+			var f:Function = function( obj1:Object, obj2:Object):int
+			{
+				return stringCompare(obj1[field], obj2[field]);
+			}
+			return f;
+		}
+		/**
+		 *  Removes any commas, spaces, Q-Marks, and Ampersands to make URL compatible
+		 */
+		public static function replaceForURL(s:String):String
+		{
+			var replaceCommas:RegExp = /,/g;
+			var replaceSpaces:RegExp = / /g;
+			var replaceQmarks:RegExp = /?/g;
+			var replaceAmps:RegExp = /&/g;
+			return s.replace(replaceSpaces, '%20').replace(replaceQmarks, '').replace(replaceAmps, '');
+		}
+		//----------------------------------
+		//  QSET Data Retrieval
+		//----------------------------------
+		/**
+		 *  Takes questions from a QSET and returns them all in an array
+		 *
+		 *  @param QSET The question set from which to extract questions
+		 *  @return An array with all the Questions in the QSET
+		 */
+		public static function listQuestionsFromQSET(qset:Object):Array
+		{
+			// turns qset into a list of questions
+			// for multiple choice, need to store values
+			if(qset == null) return new Array();
+			// search down through the object and pull out questions and items elements
+			var qaList:Array = new Array();
+			searchForQuestions(qset, qaList);
+			return qaList;
+		}
+		/**
+		 *  Loads a given array up with questions from the given Question Set
+		 *
+		 *  @param qset A Question Set with a Q Array and A Array
+		 *  @param list An array to be filled with questions from qset
+		 */
+		private static function searchForQuestions(qset:Object, list:Array):void
+		{
+			if(qset.hasOwnProperty("questions"))
+			{
+				var questions:Array = new Array();
+				var answers:Array = new Array();
+				var answerValues:Array = new Array();
+				getQuestions(qset.questions, questions);
+				getAnswers(qset.items, answers, answerValues);
+				list.push({questions:questions, answers:answers, values:answerValues});
+			}
+			else
+			{
+				if(qset.hasOwnProperty("items"))
+				{
+					for(var i:int=0; i< qset.items.length; i++)
+					{
+						searchForQuestions(qset.items[i], list);
+					}
+				}
+			}
+		}
+		/**
+		 *  Copies question text from one array to the next
+		 *
+		 *  @param source The array to copy from
+		 *  @param dest The array to copy to
+		 */
+		private static function getQuestions(source:Array, dest:Array):void
+		{
+			for(var i:int = 0; i < source.length; i++)
+			{
+				dest.push(source[i].text);
+			}
+		}
+		/**
+		 *  Copies answer text and value from one array to the next
+		 *
+		 *  @param source The array to copy from
+		 *  @param dest The array to copy to
+		 */
+		private static function getAnswers(source:Array, dest1:Array, dest2:Array):void
+		{
+			if(!source) return;
+			for(var i:int = 0; i < source.length; i++)
+			{
+				dest1.push(source[i].text);
+				if(source[i]["value"] != null)
+				{
+					dest2.push(source[i]["value"]);
+				}
+				else
+				{
+					dest2.push(0);
+				}
+			}
+		}
+		/**
+		 * Make an array into an object.
+		 * Flashcards' options were coming in as arrays, but I wanted them to be objects.
+		 */
+		public static function convertArrayToObject(arr:*):Object
+		{
+			if(arr is Array)
+			{
+				var obj:Object = new Object();
+				for( var i:String in arr)
+				{
+					// objects will not need the .length that arrays have?
+					obj[i] == arr[i];
+				}
+				return obj;
+			}
+			else // it should be an object
+			{
+				return arr;
+			}
+		}
+	}
+}

data/lib/mako/data/flash_widget_dev_core/src/materia/utils/DateUtils.as

@@ -0,0 +1,273 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+//  UCF COURSE DEVELOPMENT AND WEB SERVICES
+//  Copyright 2009 UCF Course Development and Web Services
+//  All Rights Reserved.
+//
+//  NOTICE: Course Development and Webservices prohibits the use of the
+//  following code without explicit permission.  Permission can be obtained
+//  from the New Media team at <newmedia@mail.ucf.edu>.
+//
+////////////////////////////////////////////////////////////////////////////////
+package materia.utils
+{
+	import mx.formatters.DateFormatter;
+/**
+ *  A class full Date utility functions to be used across Kogneato
+ */
+public class DateUtils
+{
+	/**
+	 *  Converts a gameserv formatted date into a
+	 *  mm/dd/yyyy format.
+	 *
+	 *  @param theDate A gameserv formatted date
+	 *  (number of seconds since 1 Jan 1970)
+	 *
+	 *  @return A string in the mm/dd/yyyy format
+	 */
+	public static function monthDayYearFormat(theDate:Number):String
+	{
+		// from a gameserv date to a date string
+		var d:Date = new Date(theDate*1000);
+		var x:DateFormatter = new DateFormatter()
+		x.formatString = "MM/DD/YYYY"
+		return x.format(d)
+	}
+	/**
+	 *  Converts a gameserv formatted date into a
+	 *  mm/dd/yyyy 00:00 AM/PM format.
+	 *
+	 *  @param theDate A gameserv formatted date
+	 *  (number of seconds since 1 Jan 1970)
+	 *
+	 *  @return A string in the mm/dd/yyyy 00:00 AM/PM format
+	 */
+	public static function monthDayYearTimeFormat(theDate:Number):String
+	{
+		// from a gameserv date to a date string
+		var d:Date = new Date(theDate*1000);
+		var x:DateFormatter = new DateFormatter()
+		x.formatString = "MM/DD/YY L:NN A"
+		return x.format(d)
+	}
+	/**
+	 *  Converts a gameserv formatted date into a
+	 *  00:00 AM/PM format.
+	 *
+	 *  @param theDate A gameserv formatted date
+	 *  (number of seconds since 1 Jan 1970)
+	 *
+	 *  @return A string in the 00:00 AM/PM format
+	 */
+	public static function ampmTimeFormat(theDate:Number):String
+	{
+		// from a gameserv date to a date string
+		var d:Date = new Date(theDate*1000);
+		var x:DateFormatter = new DateFormatter()
+		x.formatString = "L:NN A"
+		return x.format(d)
+	}
+	/**
+	 *  Converts duration in seconds to duration formatted in Hours, Minutes, Seconds Format
+	 */
+	public static function formatDuration(seconds:int):String
+	{
+		var hours:int = seconds / 3600;
+		var mins:int = (seconds % 3600) / 60;
+		var secs:int = seconds % 60;
+		if(hours > 24) return "> 24 hrs";
+		if(hours > 0) return hours + "h " + mins + "m " + secs + "s";
+		else if(mins > 0) return mins + "m " + secs + "s";
+		else return secs + " seconds";
+	}
+	/**
+	 *  Converts duration in seconds to duration formatted in Hours, Minutes, Seconds Format
+	 */
+	public static function unFormatDuration(formattedDuration:String):int
+	{
+		if(formattedDuration == ">24Hours")
+		{
+			return 86401;
+		}
+		var hours:int = 0;
+		var mins:int = 0;
+		var secs:int = 0;
+		var currentNum:int = 0;
+		for(var i:int = 0; i < formattedDuration.length; i++)
+		{
+//			//trace("----- loop ----- " + formattedDuration);
+			var curr:String = formattedDuration.charAt(i);
+			//If char value is a number
+			if(curr >= '0' && curr <= '9')
+			{
+//				//trace("    ----- found number ----- " + curr);
+				currentNum *= 10;
+				currentNum += Number(curr);
+			}
+			else if(curr == "H")
+			{
+//				//trace("    ----- added hours ----- " + currentNum);
+				hours = currentNum;
+				currentNum = 0;
+			}
+			else if(curr == "M")
+			{
+//				//trace("    ----- added mins ----- " + currentNum);
+				mins = currentNum;
+				currentNum = 0;
+			}
+			else if(curr == "S")
+			{
+//				//trace("    ----- added secs ----- " + currentNum);
+				secs = currentNum;
+				break;
+			}
+		}
+		return hours*60*60 + mins*60 + secs;
+	}
+	/**
+	 *  Takes a date string in the mm/dd/yyyy or mm/dd/yyyy 00:00 AM/PM format and
+	 *  organizes it into an object with properties .month
+	 *  .date and .string
+	 *
+	 *  @params s A date string in the mm/dd/yyyy or mm/dd/yyyy 00:00 AM/PM format
+	 *
+	 *  @returns An object with properties .month
+	 *  .date and .string and possibly .hour .minutes .ampm
+	 */
+	private static function getDateFromString(s:String):Object
+	{
+		var o:Object = new Object();
+		var dateArr:Array = s.split(" ");
+		if (dateArr.length > 1) {
+			var date:String = dateArr[0];
+			var time:String = dateArr[1];
+			var ampm:String = dateArr[2];
+			var dayArr:Array = date.split("/");
+			o["month"] = int(Number(dayArr[0]));
+			o["day"] = int(Number(dayArr[1]));
+			o["year"] = int(Number(dayArr[2]));
+			var timeArr:Array = time.split(":");
+			o["hour"] = int(Number(timeArr[0]));
+			o["minutes"] = int(Number(timeArr[1]));
+			o["ampm"] = ampm;
+		}
+		else {
+			o["month"] = int(Number(dateArr[0]));
+			o["day"] = int(Number(dateArr[1]));
+			o["year"] = int(Number(dateArr[2]));
+		}
+		return o;
+	}
+	/**
+	 *  Compares two date strings in the mm/dd/yyyy or mm/dd/yyyy 00:00 AM/PM format
+	 *  and determines which one comes first.
+	 *
+	 *  @params obj1 A date string in the mm/dd/yyyy or mm/dd/yyyy 00:00 AM/PM format
+	 *  @params obj2 A date string in the mm/dd/yyyy or mm/dd/yyyy 00:00 AM/PM format
+	 *
+	 *  @returns <p> an integer that determines the result of comparison
+	 *  if obj1 > obj2	return 1
+	 *  if obj1 < obj2	return -1
+	 *  if obj1 = obj2	return 0
+	 */
+	public static function dateSortCompare(date1:String, date2:String):int
+	{
+		// this is too slow to be used for sorting data grids
+		// just store a number representation of the date and use stringNumberCompare
+		//trace('date test')
+		var d1:Object = getDateFromString(date1);
+		var d2:Object = getDateFromString(date2);
+		// year
+		if(d1.year > d2.year)
+		{
+			return 1;
+		}
+		else if(d1.year < d2.year)
+		{
+			return -1;
+		}
+		// month
+		if(d1.month > d2.month)
+		{
+			return 1;
+		}
+		else if(d1.month < d2.month)
+		{
+			return -1;
+		}
+		// day
+		if(d1.day > d2.day)
+		{
+			return 1;
+		}
+		else if(d1.day < d2.day)
+		{
+			return -1;
+		}
+		return 0;
+	}
+	/**
+	 * Displays a date string which will depend upon the current date and passed date.
+	 * If the given date is today, it will display a time.
+	 * If the given date is this year, it will display a month and day
+	 * Else, it will display mm/dd/yy
+	 *
+	 * @params dateArray	dateArray[0] is a mm/dd/yy string. [1] is the time, [2] is am or pm.
+	 * */
+	public static function makeDateString(theDate:Number):String
+	{
+		var dateString:String;
+		// dateArray[0] is the mm/dd/yy format
+		var givenDate:Date = new Date(theDate*1000);
+		//var d:Array = (dateArray[0] as String).split("/");
+		var currentDate:Date = new Date();
+		const monthAbbreviations:Array =
+		[
+			'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'
+		];
+		var df:DateFormatter = new DateFormatter()
+		// if game was made today: show time
+		if(currentDate.getDate() == givenDate.getDate() && currentDate.getMonth() == givenDate.getMonth() && currentDate.getFullYear() == givenDate.getFullYear())
+		{
+			df.formatString = "L:NN A"
+			dateString = df.format(givenDate);
+		}
+		// if game was made this year, show moth day
+		else if(currentDate.getFullYear() == givenDate.getFullYear())
+		{
+			dateString = monthAbbreviations[givenDate.getMonth()] + " " + givenDate.getDate();
+		}
+		else // else show mm/dd/yy
+		{
+			df.formatString = "MM/DD/YY"
+			dateString = df.format(givenDate);
+		}
+		return dateString;
+	}
+	/**
+	 * Returns formatted time from a unix timestamp (generated by the php time function).
+	 * @params time timestamp generated by php time function.
+	 * */
+	public static function timestampToDate(time:int):String {
+		var date:Date = new Date(time*1000);
+		var d:int = date.getDate();
+		var m:int = date.getMonth()+1;
+		var y:int = date.getFullYear();
+		var t:* = date.getMinutes();
+		var h:int = date.getHours();
+		var ampm:String = "am";
+		if (t < 10)
+		{
+			t = "0"+t;
+		}
+		if (h > 12)
+		{
+			h -= 12;
+			ampm = "pm";
+		}
+		return (m + "/" + d + "/" + y + " " + h + ":" + t + ampm);
+	}
+}
+}

data/lib/mako/data/flash_widget_dev_core/src/materia/utils/ImageCacher.as

@@ -0,0 +1,93 @@
+package materia.utils
+{
+	import flash.display.Bitmap;
+	import flash.display.BitmapData;
+	import flash.events.Event;
+	
+	import mx.controls.Image;
+	
+	public class ImageCacher
+	{
+		/**
+		 * By getting images through this class, the image data will be stored so we are not loading
+		 * them too ofter.
+		 * 
+		 */
+		 
+		protected static const TRACE_STRING:String = "ImageCacher.as";
+		
+		protected static var _imageStorage:Object = {}; // using this as an associative array
+		
+		public function ImageCacher()
+		{
+		}
+		
+		/**
+		 * Load an image from a url, but load it from cache / save it to cache 
+		 *    for future calls to this function.
+		 */
+		public static function loadImage(image:Image, imageURL:String):*
+		{
+//			//trace(TRACE_STRING + "::loadImage, imageURL = " + imageURL);
+			
+			if(_imageStorage[imageURL] == undefined)
+			{
+				// load it the normal way, but add an event so we can store it in cache
+				
+//				//trace("Image not cached");
+				
+				image.addEventListener(Event.COMPLETE, onImageComplete, false, 0, true);
+				image.source = imageURL;
+				
+			}
+			else
+			{
+//				//trace("Image is cached");
+				
+				// load it from cache
+				image.source = new Bitmap(_imageStorage[imageURL]);
+			}
+			
+		}
+		
+		/*
+		public function cancelLoadImage():void
+		{
+			
+		}
+		*/
+		
+		/**
+		 * Clear the cache of stored images.
+		 */
+		public static function clearCache():void
+		{
+			_imageStorage = {};
+		}
+		
+		/*
+		// NOTE: this function wasn't working so I decided to use clearCache
+		//  we might want to make this work
+		public static function clearCacheForImage(src:String):void
+		{
+		 	_imageStorage[src] = undefined;
+		}
+		*/
+		
+		protected static function onImageComplete(e:Event):void
+		{
+			var image:Image = e.target as Image;
+			
+			image.removeEventListener(Event.COMPLETE, onImageComplete);
+			
+			var bitmapData:BitmapData = new BitmapData(image.content.width,
+														image.content.height, 
+														true, 0x00ffffff);
+			bitmapData.draw(image.content);
+			
+			_imageStorage[image.source] = bitmapData;
+			
+		}
+
+	}
+}

data/lib/mako/data/flash_widget_dev_core/src/nm/arrays/Randomize.as

@@ -0,0 +1,19 @@
+/* See the file "LICENSE.txt" for the full license governing this code. */
+package nm.arrays {
+	import nm.arrays.SimpleClone;
+	public class Randomize
+	{
+		public static function randArray(arr:Array):Array{
+			var newArr:Array = SimpleClone.clone(arr)
+			var arrLen:Number = newArr.length;
+			var i:Number = arrLen;
+			while (i--) {
+				var tmp:* = newArr[i];
+				var rNum:Number = Math.floor(arrLen*Math.random());
+				newArr[i] = newArr[rNum];
+				newArr[rNum] = tmp;
+			}
+			return newArr;
+		}
+	}
+}

data/lib/mako/data/flash_widget_dev_core/src/nm/arrays/SimpleClone.as

@@ -0,0 +1,32 @@
+/* See the file "LICENSE.txt" for the full license governing this code. */
+/* NewMedia - CDWS - University of Central Florida newmedia.cdws.ucf.edu
+Description:
+	Simple cloning of an array, loops through an array and duplicates each item in the array.
+Usage:
+Version History:
+*/
+package nm.arrays {
+	public class SimpleClone {
+		/*Funtion Name : clone
+		Useage:
+		nm.arrays.SimpleClone.clone(array:Array)
+		Returns:
+		Array
+		Description:
+		Duplicates an array.
+		If items in the array are non Scalar values, they will still reference the original values, ie:
+		array[1] = {name:"foo"}, a simple clone of this array will result in two arrays with index 1 pointing
+		to the same object in memory with .name = "foo"
+		Example:
+		var myArray = new Array(15)
+		var clonedArray = nm.arrays.SimpleClone.clone(myArray)
+		*/
+		public static function clone(arr:Array):Array{
+			var outArr:Array = new Array()
+			for(var i:String in arr){
+				outArr[i] = arr[i]
+			}
+			return outArr;
+		}
+	}
+}