Animator3D

Package	fl.motion
Class	public class Animator3D
Inheritance	Animator3D AnimatorBase EventDispatcher Object
Subclasses	AnimatorUniversal

Language Version:

ActionScript 3.0

Product Version:

Flash CS3

Runtime Versions:

Flash Player 10, AIR 1.5, AIR 1.0

The Animator3D class applies an XML description of a three-dimensional motion tween to a display object. The properties and methods of the Animator3D class control the playback of the motion, and Flash Player broadcasts events in response to changes in the motion's status. If there isn't any three-dimensional content in the motion tween, the Copy Motion as ActionScript command in Flash CS4 uses the Animator class. For three-dimensional content, the Animator3D class is used, instead, which shares the same base class as the Animator class but is specifically for three-dimensional content. You can then edit the ActionScript using the application programming interface (API) or construct your own custom animation.

If you plan to call methods of the Animator3D class within a function, declare the Animator3D instance outside of the function so the scope of the object is not restricted to the function itself. If you declare the instance within a function, Flash Player deletes the Animator instance at the end of the function as part of Flash Player's routine "garbage collection" and the target object will not animate.

Default MXML Propertymotion

Related API Elements

Motion XML Elements

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		autoRewind : Boolean = false Sets the animation to restart after it finishes.	AnimatorBase
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		frameEvent : String The name of the event object created by the Event.ENTER_FRAME event.	AnimatorBase
		initialPosition : Array [override] [write-only] Establishes, the x-, y-, and z- coordinates of the display object.	Animator3D
		instanceFactoryClass : Class When creating instances with ActionScript, this is the class that creates the instance.	AnimatorBase
		isPlaying : Boolean [read-only] Indicates whether the animation is currently playing.	AnimatorBase
		motion : MotionBase The object that contains the motion tween properties for the animation.	AnimatorBase
		motionArray : Array The Array of objects that contains the motion tween properties for the animation.	AnimatorBase
		orientToPath : Boolean = false Sets the position of the display object along the motion path.	AnimatorBase
		placeholderName : String When creating instances with ActionScript, this is the instance that appears on stage that we will replace.	AnimatorBase
		positionMatrix : Matrix The Matrix object that applies an overall transformation to the motion path.	AnimatorBase
		repeatCount : int = 1 Number of times to repeat the animation.	AnimatorBase
		sceneName : String A reference for exported scenes, for 3D motion, so the scene can be loaded into a parent timeline.	AnimatorBase
		spanEnd : int [read-only] Returns the frame of the target's parent on which the animation of the target ends.	AnimatorBase
		spanStart : int [read-only] Returns the frame of the target's parent on which the animation of the target begins.	AnimatorBase
		target : DisplayObject The display object being animated.	AnimatorBase
		targetName : String The name of the target object as seen by the parent DisplayObjectContainer.	AnimatorBase
		targetParent : DisplayObjectContainer The target parent DisplayObjectContainer being animated, which can be used in conjunction with targetName to retrieve the target object after it is removed and then replaced on the timeline.	AnimatorBase
		targetParentButton : SimpleButton	AnimatorBase
		targetState3D : Array The initial orientation for the target object.	AnimatorBase
		time : int A zero-based integer that indicates and controls the time in the current animation.	AnimatorBase
		transformationPoint : Point The point of reference for rotating or scaling a display object.	AnimatorBase
		transformationPointZ : int The z-coordinate point of reference for rotating or scaling a display object.	AnimatorBase
		usingCurrentFrame : Boolean [read-only] Indicates whether the currentFrame property is checked whenever a new frame is entered and whether the target's animation is synchronized to the frames in its parent's timeline, or always advancing no matter what the parent's current frame is.	AnimatorBase

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		Animator3D(xml:XML = null, target:DisplayObject = null) Creates an Animator3D object to apply the XML-based motion tween description in three dimensions to a display object.	Animator3D
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.	EventDispatcher
		dispatchEvent(event:Event):Boolean Dispatches an event into the event flow.	EventDispatcher
		end(reset:Boolean = false, stopEnterFrame:Boolean = true, pastLastFrame:Boolean = false):void Stops the animation and Flash Player goes immediately to the last frame in the animation sequence.	AnimatorBase
		hasEventListener(type:String):Boolean Checks whether the EventDispatcher object has any listeners registered for a specific type of event.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		nextFrame(reset:Boolean = false, stopEnterFrame:Boolean = true):void Advances Flash Player to the next frame in the animation sequence.	AnimatorBase
		pause():void Pauses the animation until you call the resume() method.	AnimatorBase
		play(startTime:int = -1, startEnterFrame:Boolean = true):void Begins the animation.	AnimatorBase
		processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void [static]	AnimatorBase
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void [static] Registers the given MovieClip and an AnimatorBase instance for a child of that MovieClip.	AnimatorBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Removes a listener from the EventDispatcher object.	EventDispatcher
		resume():void Resumes the animation after it has been paused by the pause() method.	AnimatorBase
		rewind():void Sets Flash Player to the first frame of the animation.	AnimatorBase
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		startFrameEvents():void Initiates frame events.	AnimatorBase
		stop():void Stops the animation and Flash Player goes back to the first frame in the animation sequence.	AnimatorBase
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		useCurrentFrame(enable:Boolean, spanStart:int):void Sets the currentFrame property whenever a new frame is entered, and sets whether the target's animation is synchronized to the frames in its parent MovieClips's timeline.	AnimatorBase
		valueOf():Object Returns the primitive value of the specified object.	Object
		willTrigger(type:String):Boolean Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.	EventDispatcher

Protected Methods

	Method		Defined By
		convertMatrixToMatrix3D(mat2D:Matrix):Matrix3D [static]	Animator3D
		matrices3DEqual(a:Matrix3D, b:Matrix3D):Boolean [static]	Animator3D

Events

Click for more information on events

Hide Inherited Events

Show Inherited Events

	Summary	Defined By
activate	[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.	EventDispatcher
deactivate	[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.	EventDispatcher
motionEnd	Dispatched when the motion finishes playing, either when it reaches the end, or when the motion is interrupted by a call to the stop() or end() methods.	AnimatorBase
motionStart	Dispatched when the motion starts playing.	AnimatorBase
motionUpdate	Dispatched when the motion has changed and the screen has been updated.	AnimatorBase
timeChange	Dispatched when the Animator's time value has changed, but the screen has not yet been updated (i.e., the motionUpdate event).	AnimatorBase

Property Detail

initialPosition

property

initialPosition:Array [write-only] [override]

Language Version:

ActionScript 3.0

Product Version:

Flash CS3

Runtime Versions:

Flash Player 10, AIR 1.5, AIR 1.0

Establishes, the x-, y-, and z- coordinates of the display object.

Implementation
override public function set initialPosition(value:Array):void

Related API Elements

Motion XML Elements

Constructor Detail

()

Constructor

public function Animator3D(xml:XML = null, target:DisplayObject = null)

Language Version:

ActionScript 3.0

Product Version:

Flash CS3

Runtime Versions:

Flash Player 10, AIR 1.5, AIR 1.0

Creates an Animator3D object to apply the XML-based motion tween description in three dimensions to a display object.

Parameters

	`xml:XML` (default = `null`) — An E4X object containing an XML-based motion tween description.

	`target:DisplayObject` (default = `null`) — The display object using the motion tween.

Related API Elements

Motion XML Elements

Method Detail

convertMatrixToMatrix3D

()

method

protected static function convertMatrixToMatrix3D(mat2D:Matrix):Matrix3D

Parameters

mat2D:Matrix

Returns

Matrix3D

matrices3DEqual

()

method

protected static function matrices3DEqual(a:Matrix3D, b:Matrix3D):Boolean

Parameters

	`a:Matrix3D`

	`b:Matrix3D`

Returns

Boolean

Animator3D - AS3 Flash

Classes x

initialPosition

Animator3D

convertMatrixToMatrix3D

matrices3DEqual

fl.motion Animator3D - AS3 Flash		Properties \| Properties \| Constructor \| Methods \| Global Constants \| Events \| Styles \| Skin Parts \| Skin States \| Effects \| Constants \| Global Functions \| Functions \| Interfaces \| Classes \| Examples