패키지fl.transitions
클래스public class Tween
상속Tween Inheritance EventDispatcher Inheritance Object

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Tween 클래스는 ActionScript를 사용하여 여러 프레임 또는 수 초에 걸쳐 애니메이션 효과가 나타나도록 대상 무비 클립의 속성을 지정하여 무비 클립의 이동, 크기 조절 및 사라지는 효과를 나타낼 수 있도록 합니다.

Tween 클래스를 사용하면 다양한 여유 메서드를 지정할 수도 있습니다. "여유"는 애니메이션이 재생될 때 속도가 서서히 늘어나거나 줄어드는 것을 의미하며 이렇게 하면 해당 애니메이션은 좀더 사실적으로 보입니다. fl.transitions.easing 패키지에는 여유를 지정한 애니메이션을 조절하는 가속 및 감속 수식을 포함한 다양한 여유 메서드가 제공됩니다.

Tween 클래스의 메서드와 속성을 사용하려면 new 연산자와 생성자 함수를 함께 사용하여 클래스의 인스턴스를 만들고 여유 메서드를 매개 변수로 지정합니다. 예를 들면 다음과 같습니다.

import fl.transitions.Tween;
 import fl.transitions.easing.*;
 var myTween:Tween = new Tween(myObject, "x", Elastic.easeOut, 0, 300, 3, true);

참고 사항

fl.transitions.TransitionManager
fl.transitions.easing
Tween()


Public 속성
 속성다음에 의해 정의됨
  begin : Number = NaN
트윈이 시작되기 전에 대상 객체에서 지정한 속성의 초기 값입니다.
Tween
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  duration : Number
트위닝된 애니메이션의 지속 시간을 프레임 또는 초 단위로 나타냅니다.
Tween
  finish : Number
트위닝되는 대상 객체 속성의 종료 값을 나타내는 숫자입니다.
Tween
  FPS : Number
트위닝된 애니메이션의 계산된 초당 프레임 수입니다.
Tween
  func : Function
트윈과 함께 사용되는 여유 함수입니다.
Tween
  isPlaying : Boolean = false
현재 트윈을 재생 중인지 여부를 나타냅니다.
Tween
  looping : Boolean = false
트윈의 반복 여부를 나타냅니다.
Tween
  obj : Object = null
트위닝 중인 대상 객체입니다.
Tween
  position : Number
트위닝되는 대상 객체 속성의 현재 값입니다.
Tween
  prop : String = ""
대상 객체의 트윈에 의해 영향을 받는 속성의 이름입니다.
Tween
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  time : Number
애니메이션의 지속 시간 중에서 현재 시간을 나타냅니다.
Tween
  useSeconds : Boolean = false
일정 시간(프레임 또는 초) 동안 트윈이 재생되는지 여부를 나타냅니다.
Tween
Public 메서드
 메서드다음에 의해 정의됨
  
Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)
Tween 클래스의 인스턴스를 만듭니다.
Tween
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.
EventDispatcher
  
continueTo(finish:Number, duration:Number):void
트위닝된 애니메이션을 현재 애니메이션 포인트에서 새로운 완료 및 지속 기간 포인트까지 지속하도록 나타냅니다.
Tween
 Inherited
이벤트를 이벤트 흐름으로 전달합니다.
EventDispatcher
  
트위닝된 애니메이션을 트위닝된 애니메이션의 종료 값으로 바로 이동합니다.
Tween
 Inherited
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
  
트위닝된 애니메이션을 중단했던 애니메이션의 다음 프레임으로 이동합니다.
Tween
  
중단된 애니메이션의 현재 중단점에서 트위닝된 애니메이션의 이전 프레임을 재생합니다.
Tween
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher 객체에서 리스너를 제거합니다.
EventDispatcher
  
중단되었던 트위닝된 애니메이션의 재생을 다시 시작합니다.
Tween
  
트위닝된 애니메이션의 재생을 시작 값으로 되돌립니다.
Tween
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
  
트위닝된 애니메이션을 시작점부터 재생하기 시작합니다.
Tween
  
트위닝된 애니메이션의 재생을 현재 값에서 중단합니다.
Tween
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
 Inherited
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
  
트위닝된 속성이 증가한 마지막 방향에서 반대 방향으로 재생하도록 트위닝된 애니메이션에 지시합니다.
Tween
이벤트
 이벤트 요약 다음에 의해 정의됨
 Inherited[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.EventDispatcher
 Inherited[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.EventDispatcher
  Tween이 변경되고 화면이 업데이트되었음을 나타냅니다.Tween
  Tween이 끝에 도달하여 종료되었음을 나타냅니다.Tween
  Tween이 반복 모드의 시작 부분에서 다시 재생을 시작했음을 나타냅니다.Tween
  Tween이 일시 정지된 후에 다시 재생을 시작했음을 나타냅니다.Tween
  모션이 재생되기 시작했음을 나타냅니다.Tween
  Tween.stop()을 명시적으로 호출하여 Tween이 중단되었음을 나타냅니다.Tween
속성 정보
begin속성
public var begin:Number = NaN

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트윈이 시작되기 전에 대상 객체에서 지정한 속성의 초기 값입니다.

duration속성 
duration:Number  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 애니메이션의 지속 시간을 프레임 또는 초 단위로 나타냅니다. 새로운 Tween 인스턴스를 만들거나 Tween.yoyo() 메서드를 호출할 때 이 속성을 매개 변수로 설정합니다.



구현
    public function get duration():Number
    public function set duration(value:Number):void
finish속성 
finish:Number  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝되는 대상 객체 속성의 종료 값을 나타내는 숫자입니다. 새로운 Tween 인스턴스를 만들거나 Tween.yoyo() 메서드를 호출할 때 이 속성을 매개 변수로 설정합니다.



구현
    public function get finish():Number
    public function set finish(value:Number):void

참고 사항

FPS속성 
FPS:Number  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 애니메이션의 계산된 초당 프레임 수입니다. 기본적으로 현재 스테이지 프레임 속도를 사용하여 트위닝된 애니메이션을 계산합니다. 이 속성을 설정하면 현재 스테이지 프레임 속도 대신 1초마다 Tween.FPS 속성에 표시될 애니메이션 속성의 증가 값을 다시 계산합니다. Tween.FPS 속성을 설정해도 스테이지의 실제 프레임 속도는 변경되지 않습니다.

참고: Tween.FPS 속성은 먼저 명시적으로 설정되지 않으면 undefined를 반환합니다.



구현
    public function get FPS():Number
    public function set FPS(value:Number):void
func속성 
public var func:Function

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트윈과 함께 사용되는 여유 함수입니다.

isPlaying속성 
public var isPlaying:Boolean = false

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

현재 트윈을 재생 중인지 여부를 나타냅니다.

looping속성 
public var looping:Boolean = false

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트윈의 반복 여부를 나타냅니다. 값이 true이면 트윈이 완료될 때마다 무한정 다시 시작됩니다. 값이 false이면 트윈이 한 번만 재생됩니다.

obj속성 
public var obj:Object = null

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝 중인 대상 객체입니다.

position속성 
position:Number  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝되는 대상 객체 속성의 현재 값입니다. 이 값은 트위닝된 애니메이션의 각 프레임이 그려질 때마다 업데이트됩니다.



구현
    public function get position():Number
    public function set position(value:Number):void
prop속성 
public var prop:String = ""

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

대상 객체의 트윈에 의해 영향을 받는 속성의 이름입니다.

time속성 
time:Number  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

애니메이션의 지속 시간 중에서 현재 시간을 나타냅니다.



구현
    public function get time():Number
    public function set time(value:Number):void
useSeconds속성 
public var useSeconds:Boolean = false

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

일정 시간(프레임 또는 초) 동안 트윈이 재생되는지 여부를 나타냅니다. 값이 true이면 duration 속성에서 지정한 시간(초) 동안 트윈에 애니메이션이 적용됩니다. 값이 false이면 지정한 시간(프레임) 동안 트윈에 애니메이션이 적용됩니다.

생성자 정보
Tween()생성자
public function Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Tween 클래스의 인스턴스를 만듭니다. var myTween:Tween = new Tween()과 같이 생성자 함수와 new 연산자를 함께 사용합니다.

매개 변수
obj:Object — 트윈의 대상 객체입니다.
 
prop:String — 영향을 받게 될 속성(obj 매개 변수 값)의 이름입니다.
 
func:Function — 사용할 여유 함수의 이름입니다.
 
begin:Numberprop 매개 변수의 시작 값입니다.
 
finish:Numberprop 매개 변수(트위닝할 대상 객체의 속성)의 종료 값을 나타내는 숫자입니다.
 
duration:Number — 모션의 시간 길이입니다. 음수이거나 생략된 경우 infinity로 설정됩니다.
 
useSeconds:Boolean (default = false) — 프레임 대신 초를 사용할지 여부를 지정하는 플래그입니다. 이 함수는 true인 경우 초를 사용하고, false인 경우에는 duration 매개 변수에 지정된 값과 관련된 프레임을 사용합니다.

참고 사항

메서드 정보
continueTo()메서드
public function continueTo(finish:Number, duration:Number):void

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 애니메이션을 현재 애니메이션 포인트에서 새로운 완료 및 지속 기간 포인트까지 지속하도록 나타냅니다.

매개 변수

finish:Number — 트위닝되는 대상 객체 속성의 종료 값을 나타내는 숫자입니다.
 
duration:Number — 트윈 모션의 시간 길이 또는 프레임 수를 나타내는 숫자입니다. 지속 시간은 Tween.start() useSeconds 매개 변수가 true로 설정된 경우 시간의 길이로 측정되고 false로 설정된 경우 프레임으로 측정됩니다.

참고 사항

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

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 애니메이션을 트위닝된 애니메이션의 종료 값으로 바로 이동합니다.

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

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 애니메이션을 중단했던 애니메이션의 다음 프레임으로 이동합니다. Tween.stop() 메서드를 사용하여 애니메이션을 중단시킨 후 트위닝된 애니메이션을 한 번에 한 프레임씩 앞으로 이동할 때 이 메서드를 사용합니다.

참고: 이 메서드는 프레임 기반 트윈에서만 사용합니다. 트위닝된 애니메이션을 만들 때 useSeconds 매개 변수를 false로 설정하여 트윈을 프레임 기반으로 설정합니다.

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

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

중단된 애니메이션의 현재 중단점에서 트위닝된 애니메이션의 이전 프레임을 재생합니다. Tween.stop() 메서드를 사용하여 애니메이션을 중단한 후 트위닝된 애니메이션을 한 번에 한 프레임씩 뒤로 재생할 때 이 메서드를 사용합니다.

참고: 이 메서드는 프레임 기반 트윈에서만 사용합니다. 트위닝된 애니메이션을 만들 때 Tween.start() useSeconds 매개 변수를 false로 설정하여 트윈을 프레임 기반으로 설정합니다.

참고 사항

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

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

중단되었던 트위닝된 애니메이션의 재생을 다시 시작합니다. Tween.stop() 메서드를 사용하여 중단했던 트위닝된 애니메이션을 계속 재생할 때 이 메서드를 사용합니다.

참고: 이 메서드는 프레임 기반 트윈에서만 사용합니다. 트위닝된 애니메이션을 만들 때 useSeconds 매개 변수를 false로 설정하여 트윈을 프레임 기반으로 설정합니다.

rewind()메서드 
public function rewind(t:Number = 0):void

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 애니메이션의 재생을 시작 값으로 되돌립니다. 트위닝된 애니메이션이 재생되는 동안 Tween.rewind()가 호출되면 애니메이션이 시작 값으로 되감겨지고 재생을 계속합니다. 트위닝된 애니메이션이 중단되었거나 종료되었을 때 Tween.rewind() 메서드가 호출되면 트위닝된 애니메이션이 시작 값으로 되감겨지고 재생이 중단된 상태로 있습니다. Tween.stop() 메서드를 사용하여 트위닝된 애니메이션을 중단한 후 시작점으로 되감으려고 하거나 재생 중인 트위닝된 애니메이션을 되감으려고 할 때 이 메서드를 사용합니다.

매개 변수

t:Number (default = 0) — 시작 값입니다.

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

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 애니메이션을 시작점부터 재생하기 시작합니다. 이 메서드는 애니메이션이 중단되었거나 완료된 후 애니메이션의 시작점에서 트윈을 다시 시작하는 데 사용됩니다.

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

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 애니메이션의 재생을 현재 값에서 중단합니다.

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

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

트위닝된 속성이 증가한 마지막 방향에서 반대 방향으로 재생하도록 트위닝된 애니메이션에 지시합니다. Tween 객체의 애니메이션이 완료되기 전에 이 메서드를 호출하면 애니메이션이 갑자기 재생 끝으로 이동한 다음 끝 지점에서 반대 방향으로 재생합니다. TweenEvent.MOTION_FINISH 이벤트 핸들러 내에서 Tween.yoyo() 메서드를 호출하여 애니메이션 전체를 끝까지 재생한 다음 반대 방향으로 전체를 다시 재생하는 효과를 만들 수 있습니다. 이 프로세스를 실행하면 현재 트위닝된 애니메이션이 완료될 때까지 Tween.yoyo() 메서드의 역방향 효과가 시작되지 않습니다.

이벤트 정보
motionChange 이벤트
이벤트 객체 유형: fl.transitions.TweenEvent
속성 TweenEvent.type = fl.transitions.TweenEvent.MOTION_CHANGE

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Tween이 변경되고 화면이 업데이트되었음을 나타냅니다.

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

속성
bubbles false
cancelable false
currentTarget 이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButtoncurrentTarget 속성 값으로 설정됩니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
time 이벤트가 발생했을 때의 Tween 시간입니다.
position 이벤트가 발생했을 때 Tween에 의해 제어되는 속성 값입니다.
motionFinish 이벤트  
이벤트 객체 유형: fl.transitions.TweenEvent
속성 TweenEvent.type = fl.transitions.TweenEvent.MOTION_FINISH

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Tween이 끝에 도달하여 종료되었음을 나타냅니다.

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

속성
bubbles false
cancelable false
currentTarget 이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButtoncurrentTarget 속성 값으로 설정됩니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
time 이벤트가 발생했을 때의 Tween 시간입니다.
position 이벤트가 발생했을 때 Tween에 의해 제어되는 속성 값입니다.
motionLoop 이벤트  
이벤트 객체 유형: fl.transitions.TweenEvent
속성 TweenEvent.type = fl.transitions.TweenEvent.MOTION_LOOP

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Tween이 반복 모드의 시작 부분에서 다시 재생을 시작했음을 나타냅니다.

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

속성
bubbles false
cancelable false
currentTarget 이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButtoncurrentTarget 속성 값으로 설정됩니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
time 이벤트가 발생했을 때의 Tween 시간입니다.
position 이벤트가 발생했을 때 Tween에 의해 제어되는 속성 값입니다.
motionResume 이벤트  
이벤트 객체 유형: fl.transitions.TweenEvent
속성 TweenEvent.type = fl.transitions.TweenEvent.MOTION_RESUME

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Tween이 일시 정지된 후에 다시 재생을 시작했음을 나타냅니다.

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

속성
bubbles false
cancelable false
currentTarget 이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButtoncurrentTarget 속성 값으로 설정됩니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
time 이벤트가 발생했을 때의 Tween 시간입니다.
position 이벤트가 발생했을 때 Tween에 의해 제어되는 속성 값입니다.
motionStart 이벤트  
이벤트 객체 유형: fl.transitions.TweenEvent
속성 TweenEvent.type = fl.transitions.TweenEvent.MOTION_START

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

모션이 재생되기 시작했음을 나타냅니다.

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

속성
bubbles false
cancelable false
currentTarget 이벤트를 처리하는 이벤트 리스너를 정의하는 객체입니다. 예를 들어 myButton.addEventListener()를 사용하여 이벤트 리스너를 등록하면 myButtoncurrentTarget 속성 값으로 설정됩니다.
target 이벤트를 전달한 객체입니다. 이벤트를 수신하는 객체와는 다를 수도 있습니다. 이벤트를 수신하는 객체에 항상 액세스하려면 currentTarget 속성을 사용합니다.
time 이벤트가 발생했을 때의 Tween 시간입니다.
position 이벤트가 발생했을 때 Tween에 의해 제어되는 속성 값입니다.
motionStop 이벤트  
이벤트 객체 유형: fl.transitions.TweenEvent
속성 TweenEvent.type = fl.transitions.TweenEvent.MOTION_STOP

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Tween.stop()을 명시적으로 호출하여 Tween이 중단되었음을 나타냅니다.

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

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