+Show TOC
×Hide TOC

MultiTweenMS

Kind of class:	class
Inherits from:	BasicMultiTweenMS < AbstractMultiTween
Implements:	ITween
Version:	1.0
Author:	Francis Bourre
Classpath:	com.bourre.transitions.MultiTweenMS
File last modified:	Wednesday, 31 October 2007, 07:35:30

► View source

▼ Hide source

/*
 * Copyright the original author or authors.
 * 
 * Licensed under the MOZILLA PUBLIC LICENSE, Version 1.1 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *      http://www.mozilla.org/MPL/MPL-1.1.html
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
/**
 * @author Francis Bourre
 * @version 1.0
 */
 
import com.bourre.events.EventBroadcaster;
import com.bourre.events.IEvent;
import com.bourre.log.PixlibStringifier;
import com.bourre.transitions.BasicMultiTweenMS;
import com.bourre.transitions.ITween;
import com.bourre.transitions.ITweenListener;
import com.bourre.transitions.TweenEvent;
import com.bourre.transitions.TweenEventType;

class com.bourre.transitions.MultiTweenMS 
    extends BasicMultiTweenMS
    implements ITween
{
    /**
     * Broadcasted to listeners when tween starts.<br>
     */
    [Event("onStart")]
    public static var onStartEVENT:TweenEventType = TweenEventType.onStartEVENT;
    
    /**
     * Broadcasted to listeners when tween stops.<br>
     */
    [Event("onStop")]
    public static var onStopEVENT:TweenEventType = TweenEventType.onStopEVENT;
    
    /**
     * Broadcasted to listeners when tween is finished.<br>
     */
    [Event("onMotionFinished")]
    public static var onMotionFinishedEVENT:TweenEventType = TweenEventType.onMotionFinishedEVENT;
    
    /**
     * Broadcasted to listeners when property value is updated.<br>
     */
    [Event("onMotionChanged")]
    public static var onMotionChangedEVENT:TweenEventType = TweenEventType.onMotionChangedEVENT;
    
    //-------------------------------------------------------------------------
    // Private properties
    //-------------------------------------------------------------------------
    
    private var _oEB:EventBroadcaster;
    
    private var _eOnMotionChangedEvent : TweenEvent;
    private var _eOnMotionFinishedEvent : TweenEvent;
    private var _eOnMotionStartEvent : TweenEvent;
    private var _eOnMotionStopEvent : TweenEvent;
    
    
    //-------------------------------------------------------------------------
    // Public API
    //-------------------------------------------------------------------------
    
        
    /**
     * Constructs a new {@code MultiTweenMS} instance.
     * 
     * <p>Example
     * <code>
     *   var t0:MultiTweenMS = new MultiTweenMS( mc, ["_x", "_y", "_alpha"], [600, 500, 0], 1200 );
     *   var t1:MultiTweenMS = new MultiTweenMS( [mc0, mc1, mc2], ["_x", "_y", "_alpha"], [600, 500, 0], 1200, [0, 0, 100] );
     *   var t2:MultiTweenMS = new MultiTweenMS( this, "arrayProperty", [600, 500, 0], 1200 );
     * </code>
     * 
     * @param t     Object which the Tween targets.
     * @param p     Setter (method or property).
     * @param e     Ending value of property.
     * @param n     Length of time of the motion in frames.
     * @param s     (optional) Starting value of property.
     * @param f     (optional) Easing function.
    */
    public function MultiTweenMS(    t,
                                    p, 
                                    e : Array, 
                                    n : Number, 
                                    s : Array, 
                                    f : Function )
    {
        super( t, p, e, n, s, f );
        _oEB = new EventBroadcaster( this );
        
        _eOnMotionStartEvent = new TweenEvent( onStartEVENT, this );
        _eOnMotionStopEvent = new TweenEvent( onStopEVENT, this );
        _eOnMotionChangedEvent = new TweenEvent( onMotionChangedEVENT, this );
        _eOnMotionFinishedEvent = new TweenEvent( onMotionFinishedEVENT, this );
    }

    /**
     * Adds listener for receiving all events.
     * 
     * <p>Example
     * <code>
     *   t.addListener(myListener);
     * </code>
     * 
     * @param oL Listener object which implements {@link ITweenListener} interface.
     */
    public function addListener( oL : ITweenListener ) : Void
    {
        _oEB.addListener( oL );
    }
    
    /**
     * Removes listener for receiving all events.
     * 
     * <p>Example
     * <code>
     *   t.removeListener(myListener);
     * </code>
     * 
     * @param oL Listener object which implements {@link ITweenListener} interface.
     */
    public function removeListener( oL : ITweenListener ) : Void
    {
        _oEB.removeListener( oL );
    }
    
    /**
     * Adds listener for specifical event.
     * 
     * <p>Example
     * <code>
     *   t.addEventListener( MultiTweenMS.onMotionFinishedEVENT, myListener );
     * </code>
     * 
     * @param t Name of the Event.
     * @param oL Listener object.
     */
    public function addEventListener( e : TweenEventType, oL ) : Void
    {
        _oEB.addEventListener.apply( _oEB, arguments );
    }
    
    /**
     * Removes listener for specifical event.
     * 
     * <p>Example
     * <code>
     *   t.removeEventListener( MultiTweenMS.onMotionFinishedEVENT, myListener );
     * </code>
     * 
     * @param t Name of the Event.
     * @param oL Listener object.
     */
    public function removeEventListener( e : TweenEventType, oL ) : Void
    {
        _oEB.removeEventListener( e, oL );
    }
    
    /**
     * Starts tweening.
     * 
     * <p>{@link AbstractTween#start} overridding
     */
    public function start() : Void
    {
        execute();
    }
    
    /**
     * Stops tweening.
     * 
     * <p>{@link AbstractTween#stop} overridding
     */
    public function stop() : Void
    {
        super.stop();
        _oEB.broadcastEvent( _eOnMotionStopEvent );
    }
    
    /**
     * Starts tweening
     * 
     * <p>{@link com.bourre.commands.Command} polymorphism.
     * 
     * @see com.bourre.commands.Command
     */
    public function execute( e : IEvent ) : Void
    {
        super.execute();
        _oEB.broadcastEvent( _eOnMotionStartEvent );
    }
    
    /**
     * Returns the string representation of this instance.
     * @return the string representation of this instance
     */
    public function toString() : String 
    {
        return PixlibStringifier.stringify( this );
    }
    
    /**
     *    Implemented to add tween as listener to another tween.
     */
    public function onMotionFinished() : Void
    {
        execute();
    }

    
    //-------------------------------------------------------------------------
    // Private implementation
    //-------------------------------------------------------------------------
    
    private function _onMotionEnd() : Void
    {
        super._onMotionEnd();
        _oEB.broadcastEvent( _eOnMotionChangedEvent );
        _oEB.broadcastEvent( _eOnMotionFinishedEvent );
    }
    
    private function _onUpdate() : Void
    {
        super._onUpdate();
        _oEB.broadcastEvent( _eOnMotionChangedEvent );
    }
}

Summary

Constructor

MultiTweenMS

Class properties

onStartEVENT
onStopEVENT
onMotionFinishedEVENT
onMotionChangedEVENT

Instance properties

Instance properties inherited from BasicMultiTweenMS

_nM _nT

Instance properties inherited from AbstractMultiTween

_aE _aRE _aRS _aS _bP _fE _isMotionFinished _nCurrentFPS _nRate _oBeacon _oSetter _update

Instance methods

addListener
removeListener
addEventListener
removeEventListener
start
stop
execute
toString

Instance methods inherited from BasicMultiTweenMS

_isMotionFinished _update execute resume stop toString

Instance methods inherited from AbstractMultiTween

_buildAccessor _onMotionEnd _onUpdate execute getEasing getTarget isPlaying resume setEasing start stop toString yoyo

Event handlers

onMotionFinished

Event handlers inherited from AbstractMultiTween

onEnterFrame

Constructor

MultiTweenMS

function MultiTweenMS (

e:Array, n:Number, s:Array, f:Function)

Constructs a new MultiTweenMS instance.

Example

var t0:MultiTweenMS = new MultiTweenMS( mc, ["_x", "_y", "_alpha"], [600, 500, 0], 1200 );
var t1:MultiTweenMS = new MultiTweenMS( [mc0, mc1, mc2], ["_x", "_y", "_alpha"], [600, 500, 0], 1200, [0, 0, 100] );
var t2:MultiTweenMS = new MultiTweenMS( this, "arrayProperty", [600, 500, 0], 1200 );

Parameters:

Object which the Tween targets.

Setter (method or property).

Ending value of property.

Length of time of the motion in frames.

(optional) Starting value of property.

(optional) Easing function.

Class properties

onMotionChangedEVENT

static onMotionChangedEVENT:TweenEventType = TweenEventType.onMotionChangedEVENT

(read,write)

Broadcasted to listeners when property value is updated.

Component metadata:

Event	onMotionChanged

onMotionFinishedEVENT

static onMotionFinishedEVENT:TweenEventType = TweenEventType.onMotionFinishedEVENT

(read,write)

Broadcasted to listeners when tween is finished.

Component metadata:

Event	onMotionFinished

onStartEVENT

static onStartEVENT:TweenEventType = TweenEventType.onStartEVENT

(read,write)

Broadcasted to listeners when tween starts.

Component metadata:

Event	onStart

onStopEVENT

static onStopEVENT:TweenEventType = TweenEventType.onStopEVENT

(read,write)

Broadcasted to listeners when tween stops.

Component metadata:

Event	onStop

Instance methods

addEventListener

function addEventListener (

e:TweenEventType) : Void

Adds listener for specifical event.

Example

t.addEventListener( MultiTweenMS.onMotionFinishedEVENT, myListener );

Parameters:

t :

Name of the Event.

oL:

Listener object.

Specified by:

ITween.addEventListener

addListener

function addListener (

oL:ITweenListener) : Void

Adds listener for receiving all events.

Example

t.addListener(myListener);

Parameters:

oL:

Listener object which implements ITweenListener interface.

Specified by:

ITween.addListener

execute

function execute (

e:IEvent) : Void

Starts tweening

com.bourre.commands.Command polymorphism.

removeEventListener

function removeEventListener (

e:TweenEventType) : Void

Removes listener for specifical event.

Example

t.removeEventListener( MultiTweenMS.onMotionFinishedEVENT, myListener );

Parameters:

t :

Name of the Event.

oL:

Listener object.

Specified by:

ITween.removeEventListener

removeListener

function removeListener (

oL:ITweenListener) : Void

Removes listener for receiving all events.

Example

t.removeListener(myListener);

Parameters:

oL:

Listener object which implements ITweenListener interface.

Specified by:

ITween.removeListener

start

function start (

) : Void

Starts tweening.

AbstractTween.start overridding

Overrides:

AbstractMultiTween.start

Specified by:

IBasicTween.start

stop

function stop (

) : Void

Stops tweening.

AbstractTween.stop overridding

Overrides:

BasicMultiTweenMS.stop

Specified by:

IBasicTween.stop

toString

function toString (

) : String

Returns the string representation of this instance.

Returns:

the string representation of this instance

Overrides:

BasicMultiTweenMS.toString

Event handlers

onMotionFinished

function onMotionFinished (

) : Void

Implemented to add tween as listener to another tween.