애니메이션효과를 설정하는 API이다.
| Parameters | Type | Description |
|---|---|---|
| objProperty | INSTANCE | 애니메이션 대상 CSS 속성 오브젝트 |
| nDuration | short | 애니메이션 지속시간(단위:ms) |
| strTiming | STRING | 애니메이션 시간 방식 |
| strCallbackFunc | STRING | 애니메이션이 완료된 후 호출될 함수명 |
| strProgressFunc | STRING | [옵션] 애니메이션이 진행중 호출될 함수명 |
| Type | Description |
|---|---|
| BOOL | 정상 처리 여부 |
objProperty 파라미터는 일반적인 자바스크트 오브젝트 형식이며, 단일 숫자값으로 지정가능한 CSS 속성만 지정가능하다.
nDuration 파라미터는 애니메이션인 진행될 시간을 지정하며, 단위는 밀리세컨드이다. 0값을 지정한 경우에는, 애니메이션 효과가 발생하지 않고, 바로 objProperty 속성값이 반영된 이후에, strCallbackFunc 파라미터에 해당하는 콜백함수가 호출된다.
strTiming 파라미터는 "swing", "linear" 두가지만을 지원한다. 공백 문자열로 지정한 경우에는 기본값으로 "swing"이 사용된다.
strCallbackFunc, strProgressFunc 파라미터 값에 공백문자열을 지정하면, 콜백함수가 사용되지 않는다. 유효한 함수의 이름을 지정한 경우, 함수 파라미터로 컴포넌트 인스턴스와 objProperty 파라미터, nDuration 파라미터, strTiming 파라미터가 순차적으로 전달된다.
이미 진행중인 애니메이션 효과가 있는 경우, 지정한 애니메이션 효과는 애니메이션 큐의 맨 뒤에 추가된다. 이미 진행중인 애니메이션 효과를 중지하기 위해서는 animatestop 함수를 사용한다.
탭 크기 변경 애니메니션 처리시 탭에 포틀릿 형태로 링크된 화면에 대해서는 화면의 on_size 이벤트가 발생하지 않기 때문에 strCallbackFunc 및 strProgressFunc 파라미터에 콜백 함수를 지정하고, 지정된 콜백 함수에서 factory.fireonsizeevent 또는 screen.fireonsizeevent API를 이용하여 크기 변경 이벤트를 발생시켜야 한다.
function screen_on_load()
{
// 이미지 위아래로 애니메이션 효과주기
baloonUp();
}
function baloonUp(objInst, objProperty, nDuration, strTiming) {
if(objInst !== undefined) {
factory.consoleprint("baloonUp> objInst = " + objInst.getname());
factory.consoleprint("baloonUp> nDuration = " + nDuration);
factory.consoleprint("baloonUp> strTiming = " + strTiming);
}
// top위치 40으로 이동한 후 baloonDown 함수 호출
var obj_property = { top: 40 };
img_logo_animate.animate(obj_property, 700, "swing", "baloonDown");
}
function baloonDown(objInst, objProperty, nDuration, strTiming) {
if(objInst !== undefined) {
factory.consoleprint("baloonDown> objInst = " + objInst.getname());
factory.consoleprint("baloonDown> nDuration = " + nDuration);
factory.consoleprint("baloonDown> strTiming = " + strTiming);
}
// top위치 30으로 이동한 후 baloonUp 함수 호출
var obj_property = { top: 30 };
img_logo_animate.animate(obj_property, 500, "swing", "baloonUp");
}