콘텐츠로 이동

# TweenOptions

Option `Time:number?`

> 트윈의 총 길이를 정합니다. 아무 값도 지정하지 않으면 `1`이 사용됩니다.

Option `Easing:string|(index:number)->number?`

> 트윈의 가감속 정도를 결정합니다. 문자열 그대로 사용하거나, `Tween.Easings.Linear`와 같이 열거형 방식으로 사용할 수 있습니다.
> 혹은 필요에 따라 함수를 지정할 수도 있습니다. 함수를 Easing 으로 사용하는 경우 첫번째 인자로 1차 진행도 (Linear, 0 에서 1 사이의 값) 값이 주어지며, 계산 결과로 실제 적용될 위치를 반환해야합니다. 반환값은 음수이거나 1 보다 클 수 있습니다.
> 아무 값도 지정하지 않으면 `Exp2`가 사용됩니다.

>      1
>      2
>      3
>      4
>      5
>      6
>      7
>      8
>      9
>     10
>     11
>     12
>     13
>     14
>     15
>     type Easing =
>         "Linear" // 아무런 가감속이 없는 1차형
>         |"Quint" // 5 제곱
>         |"Quart" // 네제곱
>         |"Cubic" // 세제곱
>         |"Quad" // 제곱
>         |"Sin" // 사인 파형
>         |"Circle" // 사분원
>         |"Expo" // 지수형
>         |"Elastic" // 탄성
>         |"Bounce" // 튀어오름
>         |"Back" // 뒤로 가감속
>         |"Exp2" // 덜 가파른 지수 i=exp(x)/max, x=-4 to 2
>         |"Exp4" // 더 가파른 지수 i=exp(x)/max, x=-4 ~ 4
>         |EasingFunction?;

> 함수에 관한 자세한 설명과 미리보기는 여기에서 확인하세요

Option `Direction:string?`

> 트윈이 진행되는 방향입니다. 문자열 그대로 사용하거나, `Tween.Directions.Out`과 같이 열거형 방식으로 사용할 수 있습니다.
> 아무 값도 지정하지 않으면 `Out`이 사용됩니다.

>     1
>     2
>     3
>     4
>     5
>     6
>     7
>     type Direction =
>         // 초반에 가속이 이루워지며, 후반에 느려집니다.
>         "Out"
>         // 초반에는 느리며, 점점 가속이 늘어납니다.
>         |"In"
>         //중간에서 가장 빠른 속도를 가지며, 후반 초반 모두 감속이 이루워집니다.
>         |"InOut"

> 방향에 관한 자세한 설명과 미리보기는 여기에서 확인하세요

Option `CallBack:{[number|"*"|string]:(Item:any, Alpha:number, AbsolutePercent:number)->()}?`

> 선택적인 필드이며, 트윈이 실행중인 도중에 함수를 실행시킬 수 있습니다. 트윈의 진행 정도에 따라서 한번 함수가 실행되거나 트윈 진행중 계속해서 실행되도록 만들 수 있습니다.
> 인덱스가 숫자인 경우 해당 지점을 넘을 때 함수가 실행되도록 만들 수 있으며, `"*"` 를 인덱스로 사용하면 모든 부분에서 함수가 실행됩니다.
> 함수에는 편의상 트윈을 하고있는 오브젝트, 위치값, 시간만을 고려한 1차 위치값이 제공됩니다.

Option `OnStepped:(Item:any, Alpha:number, AbsolutePercent:number)->()?`

> CallBack 에 `"*"` 를 넣은것과 동일한 효과를 가지는 별칭입니다

Option `Ended:(Item:any, Alpha:number, AbsolutePercent:number)->()?`

> CallBack 에 `1`을 넣은것과 동일한 효과를 가지는 별칭입니다

Option `Getter:(Item:any, Property:string)->any?`

> 선택적인 필드이며, 트윈이 값을 얻으려 할 때 사용할 함수입니다.
> 함수에 트윈하고 있는 오브젝트, 프로퍼티 이름이 제공됩니다.

> Warning

> `register:Tween()` 와 호환되지 않습니다.

Option `Getter:(Item:any, Property:string, Value:Lerpable)->any?`

> 선택적인 필드이며, 트윈이 값을 설정하려 할 때 사용할 함수입니다. 함수에 트윈하고 있는 오브젝트, 프로퍼티 이름, 설정할 값이 제공됩니다.

> Warning

> `register:Tween()` 와 호환되지 않습니다.

맨위로