패키지fl.motion
클래스public class Animator
상속Animator Inheritance EventDispatcher Inheritance Object

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

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

중요: Flash CS3을 사용하여 SWF 파일을 컴파일하지 않는 경우 컴파일 시에 클래스 경로에 fl.motion 클래스가 있어야 표시 객체에 모션이 적용됩니다.

기본 MXML 속성motion

참고 사항

Motion XML Elements


Public 속성
 속성다음에 의해 정의됨
  autoRewind : Boolean = false
애니메이션이 끝난 후 다시 시작되도록 설정합니다.
Animator
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  isPlaying : Boolean
[read-only] 현재 애니메이션을 재생 중인지 여부를 나타냅니다.
Animator
  motion : Motion
애니메이션의 모션 트윈 속성이 들어 있는 객체입니다.
Animator
  orientToPath : Boolean = false
모션 경로에서 표시 객체의 위치를 설정합니다.
Animator
  positionMatrix : Matrix
모션 경로에 전체 변형을 적용하는 Matrix 객체입니다.
Animator
 Inheritedprototype : Object
[static] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  repeatCount : int = 1
애니메이션 반복 횟수입니다.
Animator
  target : DisplayObject
애니메이션으로 재생 중인 표시 객체입니다.
Animator
  time : int
0부터 시작하는 정수로, 현재 애니메이션의 재생 시간을 나타내고 제어합니다.
Animator
  transformationPoint : Point
표시 객체 회전 및 크기 조정을 위한 참조 포인트입니다.
Animator
Public 메서드
 메서드다음에 의해 정의됨
  
Animator(xml:XML = null, target:DisplayObject = null)
XML 기반 모션 트윈 설명을 표시 객체에 적용하기 위해 Animator 객체를 만듭니다.
Animator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.
EventDispatcher
 Inherited
이벤트를 이벤트 흐름으로 전달합니다.
EventDispatcher
  
end():void
애니메이션을 중단하고 Flash Player의 애니메이션 시퀀스에서 마지막 프레임으로 즉시 이동합니다.
Animator
  
fromXMLString(xmlString:String, target:DisplayObject = null):Animator
[static] XML의 문자열을 사용하여 Animator 객체를 만듭니다.
Animator
 Inherited
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
  
Flash Player의 애니메이션 시퀀스에서 다음 프레임으로 이동합니다.
Animator
  
사용자가 resume() 메서드를 호출할 때까지 애니메이션을 일시 정지합니다.
Animator
  
애니메이션을 시작합니다.
Animator
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher 객체에서 리스너를 제거합니다.
EventDispatcher
  
pause() 메서드로 일시 정지된 애니메이션을 다시 시작합니다.
Animator
  
Flash Player를 애니메이션의 첫 번째 프레임으로 설정합니다.
Animator
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
  
애니메이션을 중단하고 Flash Player의 애니메이션 시퀀스에서 첫 번째 프레임으로 이동합니다.
Animator
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
 Inherited
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
이벤트
 이벤트 요약 다음에 의해 정의됨
 Inherited Flash Player가 운영 체제에서 포커스를 얻어 활성화될 때 전달됩니다.EventDispatcher
 Inherited Flash Player가 운영 체제에서 포커스를 잃고 비활성화될 때 전달됩니다.EventDispatcher
   모션이 끝에 도달하거나 stop() 또는 end() 메서드 호출에 의해 중단되어 모션의 재생이 끝나면 전달됩니다.Animator
   모션이 재생을 시작하면 전달됩니다.Animator
   모션이 변경되고 화면이 업데이트되면 전달됩니다.Animator
   Animator의 시간 값이 변경되었지만 화면이 업데이트되지 않은 경우(motionUpdate 이벤트) 전달됩니다.Animator
속성 정보
autoRewind속성
public var autoRewind:Boolean = false

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

isPlaying속성 
isPlaying:Boolean  [read-only]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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


구현
    public function get isPlaying():Boolean
motion속성 
motion:Motion  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

애니메이션의 모션 트윈 속성이 들어 있는 객체입니다.


구현
    public function get motion():Motion
    public function set motion(value:Motion):void
orientToPath속성 
public var orientToPath:Boolean = false

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

positionMatrix속성 
public var positionMatrix:Matrix

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

repeatCount속성 
public var repeatCount:int = 1

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

기본값은 1.

참고 사항

target속성 
target:DisplayObject  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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


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

참고 사항

time속성 
time:int  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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


구현
    public function get time():int
    public function set time(value:int):void
transformationPoint속성 
public var transformationPoint:Point

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

표시 객체 회전 및 크기 조정을 위한 참조 포인트입니다. 변형점은 표시 객체의 경계 상자에 상대적입니다. 점의 좌표는 1px x 1px 크기의 상자로 지정해야 합니다. 이때 (1, 1)은 객체의 오른쪽 하단 모서리를 나타내고 (0, 0)은 객체의 왼쪽 상단 모서리를 나타냅니다.

생성자 정보
Animator()생성자
public function Animator(xml:XML = null, target:DisplayObject = null)

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

XML 기반 모션 트윈 설명을 표시 객체에 적용하기 위해 Animator 객체를 만듭니다.

매개 변수
xml:XML (default = null) — XML 기반 모션 트윈 설명이 들어 있는 E4X 객체입니다.
 
target:DisplayObject (default = null) — 모션 트윈을 사용하는 표시 객체입니다.

참고 사항

메서드 정보
end()메서드
public function end():void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

참고 사항

fromXMLString()메서드 
public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

XML의 문자열을 사용하여 Animator 객체를 만듭니다. 이 메서드는 E4X 객체를 사용하는 Animator 생성자 대신 사용됩니다.

매개 변수

xmlString:String — 모션 트윈을 설명하는 XML의 문자열입니다.
 
target:DisplayObject (default = null) — 모션 트윈을 사용하는 표시 객체입니다.

반환값
Animator — 지정한 xmlString을 지정한 target에 적용하는 Animator 인스턴스입니다.

참고 사항

nextFrame()메서드 
public function nextFrame():void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

pause()메서드 
public function pause():void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

참고 사항

play()메서드 
public function play():void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

참고 사항

resume()메서드 
public function resume():void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

참고 사항

rewind()메서드 
public function rewind():void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

stop()메서드 
public function stop():void

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

참고 사항

이벤트 정보
motionEnd 이벤트
이벤트 객체 유형: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_END

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

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

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

속성
bubblesfalse
cancelablefalse
currentTarget이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButtoncurrentTarget 값으로 설정됩니다.
target이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체를 항상 액세스하려면 currentTarget 속성을 사용합니다.
motionStart 이벤트  
이벤트 객체 유형: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_START

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

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

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

속성
bubblesfalse
cancelablefalse
currentTarget이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButtoncurrentTarget 값으로 설정됩니다.
target이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체를 항상 액세스하려면 currentTarget 속성을 사용합니다.
motionUpdate 이벤트  
이벤트 객체 유형: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_UPDATE

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

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

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

속성
bubblesfalse
cancelablefalse
currentTarget이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButtoncurrentTarget 값으로 설정됩니다.
target이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체를 항상 액세스하려면 currentTarget 속성을 사용합니다.
timeChange 이벤트  
이벤트 객체 유형: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.TIME_CHANGE

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9.0.28.0

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

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

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

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




 

이 페이지에 의견 추가되면 전자 메일 알림 받기 | 의견 보고서

현재 페이지: http://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/fl/motion/Animator.html