mx.effects.Tween (Flex™ 2 레퍼런스 가이드)

Package	mx.effects
Class	public class Tween
Inheritance	Tween EventDispatcher Object

Tween 클래스는, 트인, 즉 일정시간에 타겟 object상에서 실행되는 property 애니메이션을 정의합니다. Move effect에 의해 실행되는 위치의 변경, Resize 나 Zoom effect에 의해 실행되는 크기의 변경, 또는 Fade 나 Dissolve effect에 의해 실행되는 가시성의 변경이 애니메이션인 경우도 있으면, 그 외의 타입의 애니메이션인 경우도 있습니다.

tween effects 를 정의하는 경우, 통상,EffectInstance.play() Methods의 재정의(override)로 Tween 클래스의 인스턴스를 작성합니다. Tween 인스턴스에서는, 애니메이션을 정의하기 위한 startValue,endValue, 및 duration property와 옵션의 이징 함수를 사용할 수 있습니다.

Tween object는, effect 인스턴스로, effect의 지속 시간의 사이,mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() 콜백 함수를 일정한 간격으로 호출해,startValue 와 endValue 의 사이의 보간치를 onTweenUpdate() Methods에 건네줍니다. 통상, 콜백 함수는 타겟 object의 property를 몇개인가 갱신하는 것으로, effect의 지속 시간의 사이, 그 object를 애니메이션화합니다.

effect의 재생이 종료하면, Tween object는 mx.effects.effectClasses.TweenEffectInstance.onTweenEnd() 콜백 함수를 호출합니다 (정의되고 있는 경우).

	property	정의
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		duration : Number = 3000 애니메이션의 계속 시간을 나타냅니다 (밀리 세컨드 단위).	Tween
		easingFunction : Function [write-only] 애니메이션의 이징 함수를 설정합니다.	Tween
		listener : Object 애니메이션의 간격 마다 통지되는 object를 나타냅니다.	Tween
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object

Public Methods

상속된 Public Methods의 비표시

상속된 Public Methods 보기

	Methods		정의
		Tween (listener:Object , startValue:Object , endValue:Object , duration:Number = -1, minFps:Number = -1) constructor　　.	Tween
		addEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.	EventDispatcher
		dispatchEvent (event:Event ):Boolean 이벤트를 event 플로우(flow)에 dispatch합니다.	EventDispatcher
		endTween ():void 트인을 중단해, 즉시 트인의 끝나에 점프 해,`onTweenEnd()` 콜백 함수를 호출합니다.	Tween
		hasEventListener (type:String ):Boolean EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.	EventDispatcher
		hasOwnProperty (name:String ):Boolean object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.	Object
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		pause ():void `resume()` Methods를 호출할 때까지, effect를 일시정지합니다.	Tween
		propertyIsEnumerable (name:String ):Boolean 지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.	Object
		removeEventListener (type:String , listener:Function , useCapture:Boolean = false):void EventDispatcher object로부터 listener를 삭제합니다.	EventDispatcher
		resume ():void `pause()` Methods를 호출해, effect를 일시정지한 후, 재개시킵니다.	Tween
		reverse ():void effect의 현재 위치로부터 개시해, 역순서로 effect를 재생합니다.	Tween
		seek (playheadTime:Number ):void tween effects 를 지정의 위치로 이동합니다.	Tween
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		setTweenHandlers (updateFunction:Function , endFunction:Function ):void 디폴트에서는, Tween 클래스는 effect 인스턴스로 effect의 지속 시간의 사이,`mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()` 콜백 함수를 일정한 간격으로 호출해, 한층 더 effect의 지속 시간의 종료시에, 옵션의 `mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()` 콜백 함수를 호출합니다.	Tween
		toString ():String 지정된 object의 string 표현을 돌려줍니다.	Object
		valueOf ():Object 지정된 object의 원시적치를 돌려줍니다.	Object
		willTrigger (type:String ):Boolean 지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.	EventDispatcher

property의 상세

duration

property

public var duration:Number = 3000

애니메이션의 계속 시간을 나타냅니다 (밀리 세컨드 단위).

easingFunction

property

easingFunction:Function [write-only]

애니메이션의 이징 함수를 설정합니다. 이징 함수는 startValue 값와 endValue 값의 사이의 보간에 사용됩니다. 일반의 이징 함수는 선형 보간을 실행합니다만, 보다 확장된 이징 함수에서는 가속과 감속의 효과를 생성해, 애니메이션이 보다 자연스럽게 되도록(듯이) 합니다.

이징 함수를 지정하지 않는 경우는,Math.sin() Methods에 근거하는 이징 함수가 사용됩니다.

이징 함수는, Robert Penner 씨가 보급에 진력한 함수 서명에 따르고 있습니다. 이 함수에서는, 4 개의 인수를 사용할 수 있습니다. 1 번째의 인수는, 애니메이션의 개시시각을 0 으로 한 "현재의 시각" 입니다. 2 번째의 인수는, 애니메이션 개시시의 초기치 (수치)입니다. 3 번째의 인수는, 종료치로부터 초기값을 깎은 값입니다. 4 번째의 인수는, 애니메이션의 재생 시간입니다. 반환값은, 현재의 시각에 대한 보간치가 됩니다. 통상은, 초기치와 종료치의 사이의 값이 됩니다.

Flex 는, mx.effects.easing 패키지에 이징 함수를 일식 포함하고 있습니다.

상세한 것에 대하여는, http://www.ericd.net/chapter7.pdf 를 참조해 주세요.

Implements
public function set easingFunction(value:Function ):void

listener

property

public var listener:Object

애니메이션의 간격 마다 통지되는 object를 나타냅니다.

constructor　　 의 상세

Tween

()

constructor　　

public 함수 Tween(listener:Object , startValue:Object , endValue:Object , duration:Number = -1, minFps:Number = -1)

constructor　　.

constructor　　 이 불려 가면, 애니메이션의 재생이 자동적으로 개시됩니다.

Parameters

	`listener:Object` — 애니메이션의 간격 마다 통지되는 object를 나타냅니다. 통상은,`this` 키워드를 값으로 해서 건네줍니다. `listener` 로 `onTweenUpdate()` Methods를 정의할 필요가 있어, 경우에 따라서는 `onTweenEnd()` Methods도 정의할 필요가 있습니다. 전자의 Methods는 애니메이션의 간격 마다 불려 가 후자는 애니메이션이 완료한 후에게만 불려 갑니다.

	`startValue:Object` — 애니메이션의 초기치를 나타냅니다 (1 개 또는 복수). 수치, 또는 수치의 배열의 어느 쪽인가에 됩니다. 수치가 건네받았을 경우, Tween 는, 그 수치와 `endValue` Parameters로 건네받은 수치와의 사이에 보간을 실행합니다. 수치의 배열이 건네받았을 경우는, 배열내의 각 수치가 보간 됩니다.

	`endValue:Object` — 애니메이션의 종료치를 나타냅니다 (1 개 또는 복수). 이 인수의 형태는 `startValue` Parameters의 형태와 같은 필요가 있습니다.

	`duration:Number` (default = `-1`) — 애니메이션의 재생 시간을 나타냅니다 (밀리 세컨드 단위).

	`minFps:Number` (default = `-1`) — `onTweenUpdate()` Methods를 호출할 필요가 있는 1 초 마다의 최소 회수를 나타냅니다. 트인코드는, 가능한 한 많은 빈도로 `onTweenUpdate()` Methods를 호출하려고 합니다 (최대로 1 초 쯤 100 회). 다만, 빈도가 `minFps` 보다 적게 되었을 경우는, 애니메이션의 재생 시간이 자동적으로 늘려집니다. 그 결과, CPU 사이클을 얻지 못하고 일시적으로 다운 당한 애니메이션은, 다운 당한 위치로부터 재생이 재개됩니다. 다운 당한 위치보다 후의 위치로부터 돌연 재개할 것은 없습니다.

Methods의 상세

endTween

()

Methods

public function endTween():void

트인을 중단해, 즉시 트인의 끝나에 점프 해,onTweenEnd() 콜백 함수를 호출합니다.

pause

()

Methods

public function pause():void

resume() Methods를 호출할 때까지, effect를 일시정지합니다.

resume

()

Methods

public function resume():void

pause() Methods를 호출해, effect를 일시정지한 후, 재개시킵니다.

reverse

()

Methods

public function reverse():void

effect의 현재 위치로부터 개시해, 역순서로 effect를 재생합니다.

seek

()

Methods

public function seek(playheadTime:Number ):void

tween effects 를 지정의 위치로 이동합니다.

Parameters

playheadTime:Number — 0 으로부터 duration property의 값의 범위에 들어가는 위치를 나타냅니다 (밀리 세컨드 단위).

setTweenHandlers

()

Methods

public function setTweenHandlers(updateFunction:Function , endFunction:Function ):void

디폴트에서는, Tween 클래스는 effect 인스턴스로 effect의 지속 시간의 사이,mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() 콜백 함수를 일정한 간격으로 호출해, 한층 더 effect의 지속 시간의 종료시에, 옵션의 mx.effects.effectClasses.TweenEffectInstance.onTweenEnd() 콜백 함수를 호출합니다.

이 Methods에 의해, 다른 Methods를, 갱신 콜백 함수와 종료 콜백 함수로서 지정할 수가 있습니다.

Parameters

	`updateFunction:Function` — 갱신 콜백 함수를 지정합니다.

	`endFunction:Function` — 종료 콜백 함수를 지정합니다.

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class Tween	property \| Methods