AnimatorBase

패키지	fl.motion
클래스	public class AnimatorBase
상속	AnimatorBase EventDispatcher Object
하위 클래스	Animator, Animator3D

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

AnimatorBase 클래스는 모션 트윈의 XML 설명을 표시 객체에 적용합니다. AnimatorBase 클래스의 속성 및 메서드는 모션의 재생을 제어하며, Flash Player는 모션의 상태 변경에 대한 응답으로 이벤트를 브로드캐스팅합니다. AnimatorBase 클래스는 주로 Flash CS4 이상의 [ActionScript 3.0으로 모션 복사] 명령에서 사용됩니다. API(Application Programming Interface)를 사용하여 이러한 ActionScript를 편집하거나 직접 사용자 정의 애니메이션을 만들 수 있습니다. AnimatorBase 클래스를 직접 사용할 수 없습니다. 하위 클래스인 Animator 또는 Animator3D를 대신 사용해야 합니다.

함수 내에서 AnimatorBase 클래스의 메서드를 호출하려면 객체의 범위가 함수 자체로 제한되지 않도록 함수 외부에서 AnimatorBase 인스턴스를 선언해야 합니다. 함수 내에서 인스턴스를 선언하면 Flash Player에서 수행하는 "가비지 수집" 루틴의 일부로 함수가 끝날 때 AnimatorBase 인스턴스가 삭제되어 대상 객체에 애니메이션이 적용되지 않습니다.

기본 MXML 속성motion

관련 API 요소

모션 XML 요소

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		autoRewind : Boolean = false 애니메이션이 끝난 후 다시 시작되도록 설정합니다.	AnimatorBase
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		frameEvent : String Event.ENTER_FRAME 이벤트에 의해 만들어진 이벤트 객체의 이름입니다.	AnimatorBase
		initialPosition : Array [쓰기 전용] 애니메이션의 시작 지점을 정의하는 좌표의 배열입니다.	AnimatorBase
		instanceFactoryClass : Class ActionScript로 인스턴스를 만드는 경우 인스턴스를 만드는 클래스입니다.	AnimatorBase
		isPlaying : Boolean [읽기 전용] 현재 애니메이션을 재생 중인지 여부를 나타냅니다.	AnimatorBase
		motion : MotionBase 애니메이션의 모션 트윈 속성이 들어 있는 객체입니다.	AnimatorBase
		motionArray : Array 애니메이션의 모션 트윈 속성이 들어 있는 객체 배열입니다.	AnimatorBase
		orientToPath : Boolean = false 모션 경로에서 표시 객체의 위치를 설정합니다.	AnimatorBase
		placeholderName : String ActionScript로 인스턴스를 만드는 경우 스테이지에 나타나는 인스턴스로서, 이후 대체됩니다.	AnimatorBase
		positionMatrix : Matrix 모션 경로에 전체 변형을 적용하는 Matrix 객체입니다.	AnimatorBase
		repeatCount : int = 1 애니메이션 반복 횟수입니다.	AnimatorBase
		sceneName : String 내보낸 장면에 대한 참조입니다. 3D 모션용이므로 부모 타임라인에 장면을 로드할 수 있습니다.	AnimatorBase
		spanEnd : int [읽기 전용] 대상의 애니메이션이 끝나는 대상 부모의 프레임을 반환합니다.	AnimatorBase
		spanStart : int [읽기 전용] 대상의 애니메이션이 시작되는 대상 부모의 프레임을 반환합니다.	AnimatorBase
		target : DisplayObject 애니메이션으로 재생 중인 표시 객체입니다.	AnimatorBase
		targetName : String 부모 DisplayObjectContainer에 표시되는 대상 객체의 이름입니다.	AnimatorBase
		targetParent : DisplayObjectContainer 애니메이션을 적용할 대상 부모 DisplayObjectContainer입니다. 이 속성은 타임라인에서 제거 후 대체된 대상 객체를 가져오는 데 targetName과 함께 사용할 수 있습니다.	AnimatorBase
		targetParentButton : SimpleButton	AnimatorBase
		targetState3D : Array 대상 객체의 초기 방향입니다.	AnimatorBase
		time : int 0부터 시작하는 정수로, 현재 애니메이션의 재생 시간을 나타내고 제어합니다.	AnimatorBase
		transformationPoint : Point 표시 객체 회전 및 크기 조정을 위한 참조 포인트입니다.	AnimatorBase
		transformationPointZ : int 표시 객체 회전 및 크기 조정을 위한 z 좌표 지점입니다.	AnimatorBase
		usingCurrentFrame : Boolean [읽기 전용] 새 프레임을 시작할 때마다 currentFrame 속성을 확인할지 여부와 해당 부모의 타임라인 프레임에 맞춰 대상의 애니메이션을 동기화할지 아니면 항상 부모의 현재 프레임과 상관없이 애니메이션을 진행할지 여부를 지정합니다.	AnimatorBase

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		AnimatorBase(xml:XML = null, target:DisplayObject = null) XML 기반의 모션 트윈 설명을 표시 객체에 적용하기 위해 AnimatorBase 객체를 만듭니다.	AnimatorBase
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		end(reset:Boolean = false, stopEnterFrame:Boolean = true, pastLastFrame:Boolean = false):void 애니메이션을 중단하고 Flash Player의 애니메이션 시퀀스에서 마지막 프레임으로 즉시 이동합니다.	AnimatorBase
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		nextFrame(reset:Boolean = false, stopEnterFrame:Boolean = true):void Flash Player의 애니메이션 시퀀스에서 다음 프레임으로 이동합니다.	AnimatorBase
		pause():void 사용자가 resume() 메서드를 호출할 때까지 애니메이션을 일시 정지합니다.	AnimatorBase
		play(startTime:int = -1, startEnterFrame:Boolean = true):void 애니메이션을 시작합니다.	AnimatorBase
		processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void [정적]	AnimatorBase
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void [정적] 주어진 MovieClip을 등록하고 AnimatorBase 인스턴스를 이 MovieClip의 자식으로 등록합니다.	AnimatorBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		resume():void pause() 메서드로 일시 정지된 애니메이션을 다시 시작합니다.	AnimatorBase
		rewind():void Flash Player를 애니메이션의 첫 번째 프레임으로 설정합니다.	AnimatorBase
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		startFrameEvents():void 프레임 이벤트를 초기화합니다.	AnimatorBase
		stop():void 애니메이션을 중단하고 Flash Player의 애니메이션 시퀀스에서 첫 번째 프레임으로 이동합니다.	AnimatorBase
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		useCurrentFrame(enable:Boolean, spanStart:int):void 새 프레임을 시작할 때마다 currentFrame 속성을 설정하고, 대상의 애니메이션을 부모 MovieClips의 타임라인 프레임에 맞춰 동기화할지 여부를 설정합니다.	AnimatorBase
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	요약	정의 주체
activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher
motionEnd	모션이 끝에 도달하거나 stop() 또는 end() 메서드 호출에 의해 중단되어 모션의 재생이 끝나면 전달됩니다.	AnimatorBase
motionStart	모션이 재생을 시작하면 전달됩니다.	AnimatorBase
motionUpdate	모션이 변경되고 화면이 업데이트되면 전달됩니다.	AnimatorBase
timeChange	Animator의 시간 값이 변경되었지만 화면이 업데이트되지 않은 경우(motionUpdate 이벤트) 전달됩니다.	AnimatorBase

속성 세부 정보

autoRewind

속성

public var autoRewind:Boolean = false

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션이 끝난 후 다시 시작되도록 설정합니다.

frameEvent

속성

frameEvent:String

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

Event.ENTER_FRAME 이벤트에 의해 만들어진 이벤트 객체의 이름입니다.

구현
public function get frameEvent():String
public function set frameEvent(value:String):void

initialPosition

속성

initialPosition:Array [쓰기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션의 시작 지점을 정의하는 좌표의 배열입니다.

구현
public function set initialPosition(value:Array):void

instanceFactoryClass

속성

instanceFactoryClass:Class

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

ActionScript로 인스턴스를 만드는 경우 인스턴스를 만드는 클래스입니다.

구현
public function get instanceFactoryClass():Class
public function set instanceFactoryClass(value:Class):void

isPlaying

속성

isPlaying:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

현재 애니메이션을 재생 중인지 여부를 나타냅니다.

구현
public function get isPlaying():Boolean

motion

속성

motion:MotionBase

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션의 모션 트윈 속성이 들어 있는 객체입니다. motion과 motionArray를 모두 null이 아닌 값으로 설정할 수는 없습니다. motionArray를 null이 아닌 값으로 설정할 경우 motion은 자동으로 null로 설정되고, 반대의 경우도 마찬가지입니다.

구현
public function get motion():MotionBase
public function set motion(value:MotionBase):void

motionArray

속성

motionArray:Array

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션의 모션 트윈 속성이 들어 있는 객체 배열입니다. motion과 motionArray를 모두 null이 아닌 값으로 설정할 수는 없습니다. motionArray를 null이 아닌 값으로 설정할 경우 motion은 자동으로 null로 설정되고, 반대의 경우도 마찬가지입니다. motionArray를 사용하는 애니메이션은 usingCurrentFrame이 true인 경우에만 올바르게 작동합니다. 배열에는 spanStart 속성과 initialPosition 속성(3D가 지원되는 경우)이 설정된 MotionBase 인스턴스가 있어야 합니다. 배열 인스턴스는 spanStart 순서가 가장 낮은 것부터 높은 것 순서로 배열에 배치해야 합니다. 또한 motionArray가 설정된 경우 time 속성이 하나의 모션 인스턴스에 대한 상대 값이 아니라 대상 부모에 대한 절대 값이 되고, 인덱스가 여전히 0부터 시작하며, 모션의 범위로 제한됩니다. 따라서 currentFrame - 1이 spanStart보다 크고 spanEnd보다 작을 경우 parent.currentFrame - 1이 되어야 합니다. 빈 배열을 허용하지 않습니다. 빈 배열을 전달하는 것은 null로 설정하는 것과 같습니다. motionArray에는 null 항목이 없어야 하고 spanStart 및 duration 항목에는 구멍이 없어야 합니다. 따라서 예를 들어 첫 번째 항목이 spanStart == 5, duration == 3인 경우 두 번째 항목은 spanStart == 8이어야 합니다.

구현
public function get motionArray():Array
public function set motionArray(value:Array):void

orientToPath

속성

public var orientToPath:Boolean = false

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

모션 경로에서 표시 객체의 위치를 설정합니다. true로 설정되어 있으면 표시 객체의 기준선에 따라 모션 경로의 위치가 지정되고, 그렇지 않은 경우 등록 포인트에 따라 모션 경로의 위치가 지정됩니다.

placeholderName

속성

placeholderName:String

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

ActionScript로 인스턴스를 만드는 경우 스테이지에 나타나는 인스턴스로서, 이후 대체됩니다.

구현
public function get placeholderName():String
public function set placeholderName(value:String):void

positionMatrix

속성

public var positionMatrix:Matrix

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

모션 경로에 전체 변형을 적용하는 Matrix 객체입니다. 이 행렬을 사용하면 표시 객체의 모양을 변경하지 않고도 경로를 이동하거나 크기 조정하거나 기울이거나 회전할 수 있습니다.

repeatCount

속성

public var repeatCount:int = 1

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션 반복 횟수입니다. 0보다 크거나 같은 정수 값을 사용할 수 있습니다. 값이 1이면 애니메이션을 한 번 재생합니다. 값이 0이면 end() 메서드를 호출하는 등의 방법으로 명시적으로 중단할 때까지 애니메이션이 무한 반복 재생됩니다.

기본값: 1.

관련 API 요소

end()

sceneName

속성

sceneName:String

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

내보낸 장면에 대한 참조입니다. 3D 모션용이므로 부모 타임라인에 장면을 로드할 수 있습니다.

구현
public function get sceneName():String
public function set sceneName(value:String):void

spanEnd

속성

spanEnd:int [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

대상의 애니메이션이 끝나는 대상 부모의 프레임을 반환합니다. 이 값은 spanStart 및 모션의 duration 속성을 사용하여 결정됩니다.

구현
public function get spanEnd():int

spanStart

속성

spanStart:int [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

대상의 애니메이션이 시작되는 대상 부모의 프레임을 반환합니다.

구현
public function get spanStart():int

target

속성

target:DisplayObject

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션으로 재생 중인 표시 객체입니다. MovieClip, Sprite 또는 Bitmap 등 flash.display.DisplayObject의 모든 하위 클래스를 사용할 수 있습니다.

구현
public function get target():DisplayObject
public function set target(value:DisplayObject):void

관련 API 요소

flash.display.DisplayObject

targetName

속성

targetName:String

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

부모 DisplayObjectContainer에 표시되는 대상 객체의 이름입니다. 타임라인에서 제거 후 대체된 대상 객체를 가져오는 데 targetParent와 함께 사용할 수 있습니다.

구현
public function get targetName():String
public function set targetName(value:String):void

targetParent

속성

targetParent:DisplayObjectContainer

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션을 적용할 대상 부모 DisplayObjectContainer입니다. 이 속성은 타임라인에서 제거 후 대체된 대상 객체를 가져오는 데 targetName과 함께 사용할 수 있습니다.

구현
public function get targetParent():DisplayObjectContainer
public function set targetParent(value:DisplayObjectContainer):void

targetParentButton

속성

targetParentButton:SimpleButton

구현
public function get targetParentButton():SimpleButton
public function set targetParentButton(value:SimpleButton):void

targetState3D

속성

targetState3D:Array

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

대상 객체의 초기 방향입니다. 모든 3D 회전은 모션 데이터에 절대적으로 의존합니다. 시작 3D 방향에 차이가 나는 다른 객체를 대상으로 삼는 경우 3D 회전은 먼저 이 대상의 상태로 재설정됩니다.

구현
public function get targetState3D():Array
public function set targetState3D(value:Array):void

time

속성

time:int

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

0부터 시작하는 정수로, 현재 애니메이션의 재생 시간을 나타내고 제어합니다. 애니메이션의 첫 번째 프레임에서 time 값은 0입니다. 애니메이션의 길이가 10프레임이면 마지막 프레임에서 time 값은 9입니다.

motionArray를 null이 아닌 값으로 설정할 경우 time이 0부터 시작하는 상대 인덱스가 아니라 대상 부모에 대한 절대 값이 되고, 모션의 범위로 제한되며, 인덱스가 여전히 0부터 시작합니다. 따라서 해당 범위 내에서 currentFrame - 1이 spanStart보다 크고 spanEnd보다 작을 경우 parent.currentFrame - 1이 되어야 합니다.

구현
public function get time():int
public function set time(value:int):void

transformationPoint

속성

public var transformationPoint:Point

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

표시 객체 회전 및 크기 조정을 위한 참조 포인트입니다. 2D 모션의 경우 변형점은 표시 객체의 경계 상자를 기준으로 합니다. 점의 좌표는 1px x 1px 크기의 상자로 지정해야 합니다. 이때 (1, 1)은 객체의 오른쪽 하단 모서리를 나타내고 (0, 0)은 객체의 왼쪽 상단 모서리를 나타냅니다. AnimatorBase 인스턴스가 Animator3D인 3D 모션의 경우 transformationPoint의 x 및 y와 transformationPointZ는 대상 부모의 좌표 공간에 표시되는 위치의 절대값입니다.

transformationPointZ

속성

public var transformationPointZ:int

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

표시 객체 회전 및 크기 조정을 위한 z 좌표 지점입니다. transformationPointZ 속성(또는 setter)은 AnimatorFactory3D 하위 클래스에서 재정의됩니다. 3D의 경우 포인트는 2D에서와 같은 백분율이 아니라 원본 객체의 변형점에 대한 절대값입니다.

usingCurrentFrame

속성

usingCurrentFrame:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

새 프레임을 시작할 때마다 currentFrame 속성을 확인할지 여부와 해당 부모의 타임라인 프레임에 맞춰 대상의 애니메이션을 동기화할지 아니면 항상 부모의 현재 프레임과 상관없이 애니메이션을 진행할지 여부를 지정합니다.

구현
public function get usingCurrentFrame():Boolean

생성자 세부 정보

()

생성자

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

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

XML 기반의 모션 트윈 설명을 표시 객체에 적용하기 위해 AnimatorBase 객체를 만듭니다. XML이 기본값인 null인 경우 XML을 Motion 인스턴스에 직접 제공하거나 Motion 인스턴스에 속성 값의 배열을 설정할 수 있습니다.

매개 변수

	`xml:XML` (default = `null`) — XML 기반 모션 트윈 설명이 들어 있는 E4X 객체입니다.

	`target:DisplayObject` (default = `null`) — 모션 트윈을 사용하는 표시 객체입니다.

관련 API 요소

모션 XML 요소

메서드 세부 정보

end

()

메서드

public function end(reset:Boolean = false, stopEnterFrame:Boolean = true, pastLastFrame:Boolean = false):void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션을 중단하고 Flash Player의 애니메이션 시퀀스에서 마지막 프레임으로 즉시 이동합니다. autoRewind 속성이 true로 설정되어 있으면 Flash Player의 애니메이션 시퀀스에서 첫 번째 프레임으로 이동합니다.

매개 변수

	`reset:Boolean` (default = `false`) — `_lastRenderedTime` 및 `_target`을 각각의 원래 값으로 되돌릴지 여부를 지정합니다. `_target`은 `targetParent` 및 `targetName`을 지정한 경우에만 재설정됩니다.

	`stopEnterFrame:Boolean` (default = `true`)

	`pastLastFrame:Boolean` (default = `false`)

관련 API 요소

autoRewind

nextFrame

()

메서드

public function nextFrame(reset:Boolean = false, stopEnterFrame:Boolean = true):void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

Flash Player의 애니메이션 시퀀스에서 다음 프레임으로 이동합니다.

매개 변수

	`reset:Boolean` (default = `false`)

	`stopEnterFrame:Boolean` (default = `true`)

pause

()

메서드

public function pause():void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

사용자가 resume() 메서드를 호출할 때까지 애니메이션을 일시 정지합니다.

관련 API 요소

resume()

play

()

메서드

public function play(startTime:int = -1, startEnterFrame:Boolean = true):void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션을 시작합니다. 새 인스턴스를 시작하기 전에 애니메이션의 이전 인스턴스가 모두 끝났는지 확인하기 위해 end() 메서드를 play() 메서드 호출 전에 호출합니다.

매개 변수

	`startTime:int` (default = `-1`) — 프레임을 기준으로 하여 사용할 대체 시작 시간을 나타냅니다. 이 값을 지정하지 않으면 기본 시작 시간인 0이 사용됩니다. motionArray를 null이 아닌 값으로 설정할 경우 startTime은 time 속성처럼 상대 값이 아닌 절대 값이 됩니다.

	`startEnterFrame:Boolean` (default = `true`) — 프레임 이벤트를 캡처하기 위해 이벤트 리스너를 부모에 추가해야 할지 여부를 지정합니다. 이 값이 `false`일 수 있는 경우는 `registerParentFrameHandler()`를 통해 부모가 해당 AnimatorBase 인스턴스에 등록된 경우입니다.

관련 API 요소

end()

processCurrentFrame

()

메서드

 public static function processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void

매개 변수

	`parent:MovieClip`

	`anim:AnimatorBase`

	`startEnterFrame:Boolean`

	`playOnly:Boolean` (default = `false`)

registerParentFrameHandler

()

메서드

 public static function registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

주어진 MovieClip을 등록하고 AnimatorBase 인스턴스를 이 MovieClip의 자식으로 등록합니다. 부모 MovieClip의 FRAME_CONSTRUCTED 이벤트를 처리하고 해당 currentFrame 및 AnimatorBase의 spanStart 속성을 사용하여 재생해야 할 애니메이션의 현재 상대 프레임을 결정합니다.

이 함수를 호출하면 자동으로 AnimatorBase의 useCurrentFrame 속성이 true로 설정되고 같은 이름의 매개 변수를 사용하여 spanStart 속성이 설정됩니다.

매개 변수

	`parent:MovieClip` — AnimatorBase 인스턴스의 부모 MovieClip입니다.

	`anim:AnimatorBase` — 부모 MovieClip과 관련된 AnimatorBase 인스턴스입니다.

	`spanStart:int` — 부모 MovieClip의 타임라인을 기준으로 하는 애니메이션의 시작 프레임입니다.

	`repeatCount:int` (default = `0`) — 애니메이션이 재생되는 횟수입니다. 기본값은 0으로, 애니메이션이 무한히 반복됩니다.

	`useCurrentFrame:Boolean` (default = `false`) — 새 프레임을 시작할 때마다 useCurrentFrame 속성을 확인할지 여부를 나타냅니다.

resume

()

메서드

public function resume():void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

pause() 메서드로 일시 정지된 애니메이션을 다시 시작합니다.

관련 API 요소

pause()

rewind

()

메서드

public function rewind():void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

Flash Player를 애니메이션의 첫 번째 프레임으로 설정합니다. 애니메이션을 재생하는 중이면 첫 번째 프레임부터 계속 재생합니다. 애니메이션이 중단되어 있으면 첫 번째 프레임에서 중단된 상태를 유지합니다.

startFrameEvents

()

메서드

public function startFrameEvents():void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

프레임 이벤트를 초기화합니다.

stop

()

메서드

public function stop():void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

애니메이션을 중단하고 Flash Player의 애니메이션 시퀀스에서 첫 번째 프레임으로 이동합니다.

관련 API 요소

end()

useCurrentFrame

()

메서드

public function useCurrentFrame(enable:Boolean, spanStart:int):void

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

새 프레임을 시작할 때마다 currentFrame 속성을 설정하고, 대상의 애니메이션을 부모 MovieClips의 타임라인 프레임에 맞춰 동기화할지 여부를 설정합니다. spanStart는 부모의 타임라인을 기준으로 하는 애니메이션의 시작 프레임입니다. enable이 true이면 임의의 주어진 프레임 진입 이벤트가 애니메이션의 범위 내에 포함되고 time 속성은 spanStart 프레임을 기준으로 한 프레임 번호로 설정됩니다.

예를 들어 4프레임 애니메이션이 프레임 5에서 시작하는 경우(spanStart=5) 프레임 5에 프레임 8로 이동하는 gotoAndPlay 스크립트가 있으면 프레임 8에 진입할 때 time 속성이 3(time = 1 및 time = 2 생략)으로 설정됩니다.

매개 변수

	`enable:Boolean` — currentFrame 속성을 확인할지 여부를 결정하는 true 또는 false 값입니다.

	`spanStart:int` — 부모 MovieClip의 타임라인을 기준으로 하는 애니메이션의 시작 프레임입니다.

이벤트 세부 정보

motionEnd

이벤트

이벤트 객체 유형: fl.motion.MotionEvent
속성 MotionEvent.type = fl.motion.MotionEvent.MOTION_END

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

모션이 끝에 도달하거나 stop() 또는 end() 메서드 호출에 의해 중단되어 모션의 재생이 끝나면 전달됩니다.

모션이 Animator.stop() 또는 Animator.end()를 명시적으로 호출하여 중지되었는지, 아니면 Motion 인스턴스의 끝에 도달하여 중지되었는지를 나타냅니다.

이벤트 객체의 속성 값은 다음과 같습니다.

속성	값
`bubbles`	false
`cancelable`	false
`currentTarget`	이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 `myButton.addEventListener()`를 사용하여 이벤트 리스너를 등록하면 `myButton`이 `currentTarget` 값으로 설정됩니다.
`target`	이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 `currentTarget` 속성을 사용합니다.

motionStart

이벤트

이벤트 객체 유형: fl.motion.MotionEvent
속성 MotionEvent.type = fl.motion.MotionEvent.MOTION_START

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

모션이 재생을 시작하면 전달됩니다.

Motion 인스턴스가 재생되기 시작했음을 나타냅니다.

이벤트 객체의 속성 값은 다음과 같습니다.

속성	값
`bubbles`	false
`cancelable`	false
`currentTarget`	이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 `myButton.addEventListener()`를 사용하여 이벤트 리스너를 등록하면 `myButton`이 `currentTarget` 값으로 설정됩니다.
`target`	이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 `currentTarget` 속성을 사용합니다.

motionUpdate

이벤트

이벤트 객체 유형: fl.motion.MotionEvent
속성 MotionEvent.type = fl.motion.MotionEvent.MOTION_UPDATE

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

모션이 변경되고 화면이 업데이트되면 전달됩니다.

Motion 인스턴스가 변경되고 화면이 업데이트되었는지를 나타냅니다.

이벤트 객체의 속성 값은 다음과 같습니다.

속성	값
`bubbles`	false
`cancelable`	false
`currentTarget`	이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 `myButton.addEventListener()`를 사용하여 이벤트 리스너를 등록하면 `myButton`이 `currentTarget` 값으로 설정됩니다.
`target`	이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 `currentTarget` 속성을 사용합니다.

timeChange

이벤트

이벤트 객체 유형: fl.motion.MotionEvent
속성 MotionEvent.type = fl.motion.MotionEvent.TIME_CHANGE

언어 버전:

ActionScript 3.0

제품 버전:

Flash CS4

런타임 버전:

Flash Player 9.0.28.0, AIR 1.0

Animator의 시간 값이 변경되었지만 화면이 업데이트되지 않으면(motionUpdate 이벤트) 전달됩니다.

Animator 인스턴스의 time 값이 변경되었지만 화면이 업데이트되지 않았음을 나타냅니다. 즉, Flash Player에서 motionUpdate 이벤트를 전달하지 않았음을 나타냅니다.

이벤트 객체의 속성 값은 다음과 같습니다.

속성	값
`bubbles`	false
`cancelable`	false
`currentTarget`	이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 `myButton.addEventListener()`를 사용하여 이벤트 리스너를 등록하면 `myButton`이 `currentTarget` 값으로 설정됩니다.
`target`	이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 `currentTarget` 속성을 사용합니다.

법적 고지 사항 | 온라인 개인 정보 보호 정책

AnimatorBase - AS3 Flash

패키지x

언어 요소

부록

패키지 fl.motion

autoRewind

frameEvent

initialPosition

instanceFactoryClass

isPlaying

motion

motionArray

orientToPath

placeholderName

positionMatrix

repeatCount

sceneName

spanEnd

spanStart

target

targetName

targetParent

targetParentButton

targetState3D

time

transformationPoint

transformationPointZ

usingCurrentFrame

AnimatorBase

end

nextFrame

pause

play

processCurrentFrame

registerParentFrameHandler

resume

rewind

startFrameEvents

stop

useCurrentFrame

motionEnd

motionStart

motionUpdate

timeChange