Added Timeline.getCurrentLabel();

Signed-off-by: Grant Skinner <info@gskinner.com>

Author: gskinner

VERSIONS.txt

@@ -20,7 +20,7 @@ CRITICAL (may break existing content):
 - Added "use strict"; to everything.
 - fixed an issue with EventDispatcher when adding the same listener to an event twice
 - fixed hasActiveTweens to return a Boolean consistently
-- added Timeline.getLabels()
+- added Timeline.getLabels() & getCurrentLabel()
 
 
 Version 0.4.1 [May 10, 2013]

docs/TweenJS_docs-NEXT.zip

@@ -288,7 +288,27 @@ var p = Timeline.prototype;
 		return list;
 	};
 
-
+	/**
+	 * Returns the name of the label on or immediately before the current position. For example, given a timeline with
+	 * two labels, "first" on frame index 4, and "second" on frame 8, getCurrentLabel would return:<UL>
+	 * <LI>null if the current position is 2.</LI>
+	 * <LI>"first" if the current position is 4.</LI>
+	 * <LI>"first" if the current position is 7.</LI>
+	 * <LI>"second" if the current position is 15.</LI></UL>
+	 * @method getCurrentLabel
+	 * @return {String} The name of the current label or null if there is no label
+	 **/
+	p.getCurrentLabel = function() {
+		var labels = this.getLabels();
+		var pos = this.position;
+		var l = labels.length;
+		if (l) {
+			for (var i = 0; i<l; i++) { if (pos < labels[i].position) { break; } }
+			return (i==0) ? null : labels[i-1].label;
+		}
+		return null;
+	};
+	
 	/**
 	 * Unpauses this timeline and jumps to the specified position or label.
 	 * @method gotoAndPlay

lib/tweenjs-NEXT.min.js

@@ -27,6 +27,6 @@ this.createjs = this.createjs || {};
 	 * @type String
 	 * @static
 	 **/
-	s.buildDate = /*date*/"Thu, 08 Aug 2013 05:15:28 GMT"; // injected by build process
+	s.buildDate = /*date*/"Mon, 12 Aug 2013 16:06:01 GMT"; // injected by build process
 
 })();