개요

아이템으로 등록된 Animation 오브젝트를 순서대로 수행하는 오브젝트입니다.

지원 환경

- AnimationTimeline 오브젝트는 디자인 시 생성할 수 없습니다.
   스크립트에서 동적 생성 후 addChild() 로 추가하여 사용하여야 합니다.
   AnimationTimeline 오브젝트를 동적으로 생성할 때는 "nexacro." 구문을 반드시 사용하여야 합니다.

- AnimationTimeline 오브젝트에 addTarget() 메소드로 AnimationTimelineItem 오브젝트를 여러개 등록할 수 있습니다.

- AnimationTimeline 오브젝트 실행 시 AnimationTimelineItem 은 등록된 순서로 실행되며, 먼저 실행된 아이템이 종료된 후 다음 아이템이 실행됩니다.

생성자

AnimationTimeline( strName, objParent )

// Create Object  
var objAniTime = new nexacro.AnimationTimeline("AnimationTimeline00", this);  

// Add Object to Parent Form  
this.addChild( "AnimationTimeline00", objAniTime ); 
 
// Remove Object form Parent Form  
this.removeChild("AnimationTimeline00"); 
 
// Destroy Object  
objAniTime.destroy(); 
objAniTime = null;

속성

id

AnimationTimeline 오브젝트의 고유 식별자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

AnimationTimeline.id

문법 설정

var objAniTime = new nexacro.Animation( "Animation00", this );

참고

- new 연산자로 AnimationTimeline 오브젝트를 생성할 때 id 속성값과 name 속성값이 동일하게 설정됩니다.

- 일반적으로 addChild(), insertChild() 메소드로 오브젝트를 자식으로 등록할 때 설정하는 값과 동일하게 설정합니다.

items

AnimationTimeline 오브젝트에 등록된 모든 AnimationTimelineItem 오브젝트를 갖고 있는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

AnimationTimeline.items

문법 설정

var arrAniTimeItem = this.AnimationTimeline00.items[0];

참고

- items 속성은 Collection 접근방식을 사용할 수 있습니다.
   this.AnimationTimeline00.items[0], this.AnimationTimeline00.items["AnimationTimelineItem00"], 
   this.AnimationTimline00.items.length 등의 방법을 사용합니다.

name

AnimationTimeline 오브젝트의 이름을 설정하는 속성입니다.

지원 환경

속성 타입

문법

AnimationTimeline.name

문법 설정

var objAniTime = new nexacro.AnimationTimeline( "Animation00", this );

참고

- new 연산자로 AnimationTimeline 오브젝트를 생성할 때 id 속성값과 name 속성값이 동일하게 설정됩니다.

- 일반적으로 addChild(), insertChild() 메소드로 오브젝트를 자식으로 등록할 때 설정하는 값과 동일하게 설정합니다.

parent

AnimationTimeline 의 부모 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

AnimationTimeline.parent

참고

- 일반적으로 addChild() 메소드를 사용하여 AnimationTimeline 를 추가한 오브젝트가 parent 속성에 설정됩니다.

- AnimationTimeline 가 어디에도 속해있지 않거나 부모 오브젝트로부터 제거되면 null 값을 갖습니다.

메서드

addTarget

애니메이션 효과가 정의된 Animation 오브젝트를 AnimationTimeline 오브젝트에 아이템으로 추가하는 메소드입니다.

지원 환경

문법

AnimationTimeline.addTarget( strID, objAnimation, nOffset );

파라미터

this.AnimationTimeline00.addTarget( "AnimationTimelineItem00", this.Animation00, 1000 );

반환

참고

- AnimationTimelineItem 에 정의된 Animation 오브젝트의 delay 속성이 설정되어 있다면 
   "offset 속성값 + delay 속성값" 만큼 지연된 후 애니메이션 효과가 시작됩니다.

- addTarget() 메소드가 정상적으로 실행되면 items 속성에 AnimationTimelineItem 오브젝트가 아이템으로 추가됩니다.

활용 예제

• 순서대로 애니메이션 처리하기

destroy

스크립트에서 동적으로 생성한 AnimationTimeline 을(를) 삭제하는 메소드입니다.

지원 환경

문법

AnimationTimeline.destroy()

반환

참고

- 동적으로 생성한 AnimationTimeline 을(를) 완전히 삭제하기 위해서는 destroy() 메소드를 호출해야 합니다.

insertTarget

애니메이션 효과가 정의된 Animation 오브젝트를 AnimationTimeline 오브젝트에 아이템으로 삽입하는 메소드입니다.

지원 환경

문법

AnimationTimeline.insertTarget( nIndex, strID, objAnimation, nOffset );

파라미터

this.AnimationTimeline00.insertTarget( 0, "AnimationTimelineItem00", this.Animation00, 1000 );

참고

- AnimationTimelineItem 에 정의된 Animation 오브젝트의 delay 속성이 설정되어 있다면 
   "offset 속성값 + delay 속성값" 만큼 지연된 후 애니메이션 효과가 시작됩니다.

- insertTarget() 메소드가 정상적으로 실행되면 items 속성에 AnimationTimelineItem 오브젝트가 지정된 위치에 아이템으로 삽입됩니다.
   삽입된 위치 이후에 있는 AnimationTimelineItem 의 인덱스는 자동으로 "1"씩 증가합니다.

pause

진행중인 애니메이션 효과를 일시 중지하는 메소드입니다.

지원 환경

문법

AnimationTimeline.pause()

파라미터

this.AnimationTimeline00.pause();

반환

참고

- 일시 중지된 상태에서 AnimationTimelineItem 오브젝트의 속성값을 변경해도 반영되지 않습니다.
   등록된 아이템의 애니메이션 효과가 모두 종료되거나 stop() 메소드를 실행하여야 변경된 속성값이 반영됩니다.

- 일시 중지된 애니메이션 효과는 play() 메소드를 실행하여 다시 진행시킬 수 있습니다.

- 일시 중지된 애니메이션 효과를 진행되던 방향의 반대로 진행하려면 reverse() 메소드 실행 후 play() 메소드를 실행하여야 합니다.

play

애니메이션 효과를 시작하는 메소드입니다.

지원 환경

문법

AnimationTimeline.play()

파라미터

this.Animation00Timeline.play();

반환

참고

- play() 메소드 실행 시 AnimationTimeline 오브젝트에 등록된 AnimationTimelineItem 오브젝트를 차례로 실행합니다.

- 애니메이션 효과는 대상 컴포넌트의 속성값을 실제로 변경시키며 진행됩니다.
   따라서, 애니메이션 효과가 종료되면 변경된 속성값이 유지됩니다.

- 애니메이션 효과가 진행되는 중에 play() 메소드를 실행하면 애니메이션 효과가 처음부터 다시 실행됩니다.

- pause() 메소드에 의해 일시 중지된 애니메이션 효과는 play() 메소드를 실행하여 다시 진행시킬 수 있습니다.

- offset 속성값 또는 delay 속성값이 설정되어 있으면 설정된 시간만큼 지연된 후 애니메이션 효과가 시작됩니다.

removeTarget

AnimationTimeline 오브젝트에 아이템으로 추가된 AnimationTimelineItem 오브젝트를 제거하는 메소드입니다.

지원 환경

문법

AnimationTimeline.removeTarget( strID );

파라미터

this.AnimationTimeline00.removeTarget( "AnimationTimelineItem00" );

반환

참고

- removeTarget() 메소드가 정상적으로 실행되면 items 속성에서 AnimationTimelineItem 오브젝트가 제거됩니다.

reverse

애니메이션 효과의 방향을 반대로 변경하는 메소드입니다.

지원 환경

문법

AnimationTimeline.reverse()

파라미터

this.AnimationTimeline00.reverse()

반환

참고

- reverse() 메소드는 play() 메소드가 한번 이상 수행되어 애니메이션 효과가 실행된 방향의 정보가 있을 때만 사용할 수 있습니다.

- 애니메이션 효과가 진행중일 때 reverse() 메소드를 실행하면 애니메이션 효과의 방향이 즉시 변경됩니다.

- 애니메이션 효과가 진행중이 아닐 때 reverse() 메소드를 실행하면 진행되는 방향의 정보만 변경됩니다.
   따라서 변경된 방향으로 애니메이션 효과를 실행하려면 play() 메소드를 사용하여야 합니다.

seek

애니메이션 효과의 진행위치를 특정 시간으로 이동하는 메소드입니다.

지원 환경

문법

AnimationTimeline.seek( nMSecond )

파라미터

this.AnimationTimeline00.seek( 1500 )

반환

참고

- seek() 메소드 수행 시 애니메이션 효과의 진행위치가 즉시 변경됩니다.

stop

진행중인 애니메이션 효과를 중지하는 메소드입니다.

지원 환경

문법

AnimationTimeline.stop()

파라미터

this.AnimationTimeline00.stop()

반환

참고

- 애니메이션 효과가 진행중일 때 stop() 메소드를 실행하면 대상 컴포넌트는 애니메이션 효과가 진행되기 전 상태로 돌아갑니다.
   애니메이션 효과가 완료된 후 stop() 메소드를 실행하면 대상 컴포넌트는 최종 상태를 유지합니다.

- 애니메이션 효과가 진행중일 때 AnimationTimelineItem 오브젝트의 속성값을 변경해도 반영되지 않습니다.
   애니메이션 효과가 종료되거나 stop() 메소드를 실행하여야 변경된 속성값이 반영됩니다.

이벤트

onbegin

애니메이션 효과가 시작됐을 때 발생하는 이벤트입니다.

지원 환경

문법

onbegin(obj:nexacro.AnimationTimeline,e:nexacro.AnimationEventInfo);

파라미터

참고

- 실제 애니메이션 효과가 시작되기 전에 발생하는 이벤트입니다.
   delay 속성값이 설정되어 있다면 해당 값만큼 지연 된 후 이벤트가 발생합니다.

oncomplete

애니메이션 효과가 종료됐을 때 발생하는 이벤트입니다.

지원 환경

문법

oncomplete(obj:nexacro.AnimationTimeline,e:nexacro.AnimationEventInfo);

파라미터

onrun

애니메이션 효과가 실행중일 때 Tick 마다 발생하는 이벤트입니다.

지원 환경

문법

onrun(obj:nexacro.AnimationTimeline,e:nexacro.AnimationEventInfo);

파라미터

참고

- 첫번째 AnimationTimelineItem 의 offset 속성값 또는 delay 속성값에 의해 애니메이션 효과가 지연중일 때는 이벤트가 발생하지 않습니다.
   onbegin 이벤트가 발생된 후 부터 발생하는 이벤트입니다.

- Tick 은 일반적으로 초당 60 회 발생하지만 W3C 권장 사항에 따라 대부분의 웹 브라우저에서 표시 새로고침 빈도에 따라 발생합니다.
   Tick 발생은 다른 작업에 의해 일시 중지될 수 있으므로 항상 일정한 간격으로 발생하지 않습니다.

onupdate

play() 메소드가 실행되면 애니메이션 효과가 종료될 때까지 Tick 마다 발생하는 이벤트입니다.

지원 환경

문법

onupdate(obj:nexacro.AnimationTimeline,e:nexacro.AnimationEventInfo);

파라미터

참고

- 첫번째 AnimationTimelineItem 의 offset 속성값 또는 delay 속성값에 의해 애니메이션 효과가 지연중일 때도 이벤트가 발생합니다.
   play() 메소드가 실행되면 즉시 발생하는 이벤트입니다.

- Tick 은 일반적으로 초당 60 회 발생하지만 W3C 권장 사항에 따라 대부분의 웹 브라우저에서 표시 새로고침 빈도에 따라 발생합니다.
   Tick 발생은 다른 작업에 의해 일시 중지될 수 있으므로 항상 일정한 간격으로 발생하지 않습니다.