| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.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 인스턴스가 삭제되어 대상 객체에 애니메이션이 적용되지 않습니다.
motion
public var autoRewind:Boolean = false| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
애니메이션이 끝난 후 다시 시작되도록 설정합니다.
frameEvent:String [읽기/쓰기]
구현 public function get frameEvent():String public function set frameEvent(value:String):voidinitialPosition:Array [쓰기 전용]
구현 public function set initialPosition(value:Array):voidisPlaying:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
현재 애니메이션을 재생 중인지 여부를 나타냅니다.
구현 public function get isPlaying():Booleanmotion:MotionBase [읽기/쓰기]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
애니메이션의 모션 트윈 속성이 들어 있는 객체입니다.
구현 public function get motion():MotionBase public function set motion(value:MotionBase):voidpublic var orientToPath:Boolean = false| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
모션 경로에서 표시 객체의 위치를 설정합니다. true로 설정되어 있으면 표시 객체의 기준선에 따라 모션 경로의 위치가 지정되고, 그렇지 않은 경우 등록 포인트에 따라 모션 경로의 위치가 지정됩니다.
public var positionMatrix:Matrix| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
모션 경로에 전체 변형을 적용하는 Matrix 객체입니다. 이 행렬을 사용하면 표시 객체의 모양을 변경하지 않고도 경로를 이동하거나 크기 조정하거나 기울이거나 회전할 수 있습니다.
public var repeatCount:int = 1| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
애니메이션 반복 횟수입니다. 0보다 크거나 같은 정수 값을 사용할 수 있습니다. 값이 1이면 애니메이션을 한 번 재생합니다. 값이 0이면 end() 메서드를 호출하는 등의 방법으로 명시적으로 중단할 때까지 애니메이션이 무한 반복 재생됩니다.
기본값은 1.
참고 사항
sceneName:String [읽기/쓰기]
구현 public function get sceneName():String public function set sceneName(value:String):voidspanEnd:int [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
대상의 애니메이션이 끝나는 대상 부모의 프레임을 반환합니다. 이 값은 spanStart 및 모션의 duration 속성을 사용하여 결정됩니다.
구현 public function get spanEnd():intspanStart:int [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
대상의 애니메이션이 시작되는 대상 부모의 프레임을 반환합니다.
구현 public function get spanStart():inttarget:DisplayObject [읽기/쓰기]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
애니메이션으로 재생 중인 표시 객체입니다. MovieClip, Sprite 또는 Bitmap 등 flash.display.DisplayObject의 모든 하위 클래스를 사용할 수 있습니다.
구현 public function get target():DisplayObject public function set target(value:DisplayObject):void참고 사항
targetName:String [읽기/쓰기]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
부모 DisplayObjectContainer에 표시되는 대상 객체의 이름입니다. 타임라인에서 제거 후 대체된 대상 객체를 가져오는 데 targetParent와 함께 사용할 수 있습니다.
구현 public function get targetName():String public function set targetName(value:String):voidtargetParent:DisplayObjectContainer [읽기/쓰기]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
애니메이션을 적용할 대상 부모 DisplayObjectContainer입니다. 이 속성은 타임라인에서 제거 후 대체된 대상 객체를 가져오는 데 targetName과 함께 사용할 수 있습니다.
구현 public function get targetParent():DisplayObjectContainer public function set targetParent(value:DisplayObjectContainer):voidtargetState3D:Array [읽기/쓰기]
| 런타임 버전: | Flash Player 10, AIR 1.5 |
대상 객체의 초기 방향입니다. 모든 3D 회전은 모션 데이터에 절대적으로 의존합니다. 시작 3D 방향에 차이가 나는 다른 객체를 대상으로 삼는 경우 3D 회전은 먼저 이 대상의 상태로 재설정됩니다.
구현 public function get targetState3D():Array public function set targetState3D(value:Array):voidtime:int [읽기/쓰기]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
0부터 시작하는 정수로, 현재 애니메이션의 재생 시간을 나타내고 제어합니다. 애니메이션의 첫 번째 프레임에서 time 값은 0입니다. 애니메이션의 길이가 10프레임이면 마지막 프레임에서 time 값은 9입니다.
구현 public function get time():int public function set time(value:int):voidpublic var transformationPoint:Point| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
표시 객체 회전 및 크기 조정을 위한 참조 포인트입니다. 2D 모션의 경우 변형점은 표시 객체의 경계 상자를 기준으로 합니다. 점의 좌표는 1px x 1px 크기의 상자로 지정해야 합니다. 이때 (1, 1)은 객체의 오른쪽 하단 모서리를 나타내고 (0, 0)은 객체의 왼쪽 상단 모서리를 나타냅니다. AnimatorBase 인스턴스가 Animator3D인 3D 모션의 경우 transformationPoint의 x 및 y와 transformationPointZ는 대상 부모의 좌표 공간에 표시되는 위치의 절대값입니다.
public var transformationPointZ:intusingCurrentFrame:Boolean [읽기 전용]
| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
새 프레임을 시작할 때마다 currentFrame 속성을 확인할지 여부와 해당 부모의 타임라인 프레임에 맞춰 대상의 애니메이션을 동기화할지 아니면 항상 부모의 현재 프레임과 상관없이 애니메이션을 진행할지 여부를 지정합니다.
구현 public function get usingCurrentFrame():Booleanpublic function AnimatorBase(xml:XML = null, target:DisplayObject = null)| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
XML 기반의 모션 트윈 설명을 표시 객체에 적용하기 위해 AnimatorBase 객체를 만듭니다. XML이 기본값인 null인 경우 XML을 Motion 인스턴스에 직접 제공하거나 Motion 인스턴스에 속성 값의 배열을 설정할 수 있습니다.
매개 변수 | xml:XML (default = null) — XML 기반 모션 트윈 설명이 들어 있는 E4X 객체입니다. |
| |
| target:DisplayObject (default = null) — 모션 트윈을 사용하는 표시 객체입니다. |
참고 사항
public function end(reset:Boolean = false, stopEnterFrame:Boolean = true):void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
애니메이션을 중단하고 Flash Player의 애니메이션 시퀀스에서 마지막 프레임으로 즉시 이동합니다. autoRewind 속성이 true로 설정되어 있으면 Flash Player의 애니메이션 시퀀스에서 첫 번째 프레임으로 이동합니다.
매개 변수
| reset:Boolean (default = false) —
_lastRenderedTime 및 _target을 각각의 원래 값으로 되돌릴지 여부를 지정합니다. _target은 targetParent 및 targetName을 지정한 경우에만 재설정됩니다.
|
| |
| stopEnterFrame:Boolean (default = true) |
참고 사항
public function nextFrame():void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
Flash Player의 애니메이션 시퀀스에서 다음 프레임으로 이동합니다.
public function pause():void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
사용자가 resume() 메서드를 호출할 때까지 애니메이션을 일시 정지합니다.
참고 사항
public function play(startTime:int = -1, startEnterFrame:Boolean = true):void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
애니메이션을 시작합니다. 새 인스턴스를 시작하기 전에 애니메이션의 이전 인스턴스가 모두 끝났는지 확인하기 위해 end() 메서드를 play() 메서드 호출 전에 호출합니다.
매개 변수
| startTime:int (default = -1) — 프레임을 기준으로 하여 사용할 대체 시작 시간을 나타냅니다. 이 값을 지정하지 않으면 기본 시작 시간인 0이 사용됩니다. |
| |
| startEnterFrame:Boolean (default = true) —
프레임 이벤트를 캡처하기 위해 이벤트 리스너를 부모에 추가해야 할지 여부를 지정합니다. 이 값이 false일 수 있는 경우는 registerParentFrameHandler()를 통해 부모가 해당 AnimatorBase 인스턴스에 등록된 경우입니다.
|
참고 사항
public static function processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void 매개 변수
public static function registerButtonState(targetParentBtn:SimpleButton, anim:AnimatorBase, stateFrame:int):void 매개 변수
public static function registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.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 속성을 확인할지 여부를 나타냅니다. |
public function resume():void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
pause() 메서드로 일시 정지된 애니메이션을 다시 시작합니다.
참고 사항
public function rewind():void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
Flash Player를 애니메이션의 첫 번째 프레임으로 설정합니다. 애니메이션을 재생하는 중이면 첫 번째 프레임부터 계속 재생합니다. 애니메이션이 중단되어 있으면 첫 번째 프레임에서 중단된 상태를 유지합니다.
public function startFrameEvents():void public function stop():void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
애니메이션을 중단하고 Flash Player의 애니메이션 시퀀스에서 첫 번째 프레임으로 이동합니다.
참고 사항
public function useCurrentFrame(enable:Boolean, spanStart:int):void| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.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의 타임라인을 기준으로 하는 애니메이션의 시작 프레임입니다. |
이벤트 객체 유형: fl.motion.MotionEvent속성 MotionEvent.type = fl.motion.MotionEvent.MOTION_END| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
모션이 끝에 도달하거나 stop() 또는 end() 메서드 호출에 의해 중단되어 모션의 재생이 끝나면 전달됩니다.
모션이
Animator.stop() 또는
Animator.end()를 명시적으로 호출하여 중지되었는지, 아니면 Motion 인스턴스의 끝에 도달하여 중지되었는지를 나타냅니다.
이벤트 객체의 속성 값은 다음과 같습니다.
| 속성 | 값 |
|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButton이 currentTarget 값으로 설정됩니다.
|
target
|
이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
|
이벤트 객체 유형: fl.motion.MotionEvent속성 MotionEvent.type = fl.motion.MotionEvent.MOTION_START| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
모션이 재생을 시작하면 전달됩니다.
Motion 인스턴스가 재생되기 시작했음을 나타냅니다.
이벤트 객체의 속성 값은 다음과 같습니다.
| 속성 | 값 |
|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButton이 currentTarget 값으로 설정됩니다.
|
target
|
이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
|
이벤트 객체 유형: fl.motion.MotionEvent속성 MotionEvent.type = fl.motion.MotionEvent.MOTION_UPDATE| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
모션이 변경되고 화면이 업데이트되면 전달됩니다.
Motion 인스턴스가 변경되고 화면이 업데이트되었는지를 나타냅니다.
이벤트 객체의 속성 값은 다음과 같습니다.
| 속성 | 값 |
|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButton이 currentTarget 값으로 설정됩니다.
|
target
|
이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
|
이벤트 객체 유형: fl.motion.MotionEvent속성 MotionEvent.type = fl.motion.MotionEvent.TIME_CHANGE| 런타임 버전: | AIR 1.0 Flash Player 9.0.28.0 |
Animator의 시간 값이 변경되었지만 화면이 업데이트되지 않으면(motionUpdate 이벤트) 전달됩니다.
Animator 인스턴스의
time 값이 변경되었지만 화면이 업데이트되지 않았음을 나타냅니다. 즉, Flash Player에서
motionUpdate 이벤트를 전달하지 않았음을 나타냅니다.
이벤트 객체의 속성 값은 다음과 같습니다.
| 속성 | 값 |
|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButton이 currentTarget 값으로 설정됩니다.
|
target
|
이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
|
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 02:16 AM -08:00