/**
* VERSION: 1.2
* DATE: 12/17/2009
* AS2
* UPDATES AND DOCUMENTATION AT: http://www.TweenMax.com
**/
import com.greensock.*;
import com.greensock.plugins.*;
/**
* To tween any rotation property of the target object in the shortest direction, use "shortRotation"
* For example, if myObject._rotation
is currently 170 degrees and you want to tween it to -170 degrees,
* a normal rotation tween would travel a total of 340 degrees in the counter-clockwise direction,
* but if you use shortRotation, it would travel 20 degrees in the clockwise direction instead. You
* can define any number of rotation properties in the shortRotation object which makes 3D tweening
* easier, like:
*
* TweenMax.to(mc, 2, {shortRotation:{rotationX:-170, rotationY:35, rotationZ:200}});
*
* USAGE:
*
* import com.greensock.TweenLite;
* import com.greensock.plugins.TweenPlugin;
* import com.greensock.plugins.ShortRotationPlugin;
* TweenPlugin.activate([ShortRotationPlugin]); //activation is permanent in the SWF, so this line only needs to be run once.
*
* TweenLite.to(mc, 1, {shortRotation:{_rotation:-170}});
* //or for a 3D tween with multiple rotation values...
* TweenLite.to(mc, 1, {shortRotation:{rotationX:-170, rotationY:35, rotationZ:10}});
*
*
* Copyright 2010, GreenSock. All rights reserved. This work is subject to the terms in http://www.greensock.com/terms_of_use.html or for corporate Club GreenSock members, the software agreement that was issued with the corporate membership.
*
* @author Jack Doyle, jack@greensock.com
*/
class com.greensock.plugins.ShortRotationPlugin extends TweenPlugin {
/** @private **/
public static var API:Number = 1.0; //If the API/Framework for plugins changes in the future, this number helps determine compatibility
/** @private **/
public function ShortRotationPlugin() {
super();
this.propName = "shortRotation";
this.overwriteProps = [];
}
/** @private **/
public function onInitTween(target:Object, value:Object, tween:TweenLite):Boolean {
if (typeof(value) == "number") {
return false;
}
for (var p:String in value) {
initRotation(target, p, target[p], (typeof(value[p]) == "number") ? Number(value[p]) : target[p] + Number(value[p]));
}
return true;
}
/** @private **/
public function initRotation(target:Object, propName:String, start:Number, end:Number):Void {
var dif:Number = (end - start) % 360;
if (dif != dif % 180) {
dif = (dif < 0) ? dif + 360 : dif - 360;
}
addTween(target, propName, start, start + dif, propName);
this.overwriteProps[this.overwriteProps.length] = propName;
}
}