TweenInfo

Overview

트윈 애니메이션의 동작 방식을 정의하기 위한 설정 객체입니다. TweenService:Create() 호출 시 사용되며, 속성 변화의 지속 시간, 보간 방식, 반복 설정 등 트윈의 세부 동작을 제어합니다.

TweenInfo는 생성 이후 속성 값을 변경할 수 없으며, 다른 설정이 필요할 경우 새로운 TweenInfo를 생성해야 합니다.

Constructors

new

전달된 인자들을 사용하여 트윈 동작에 필요한 설정 값을 포함한 TweenInfo 객체를 새로 만듭니다.

생성된 TweenInfo는 이후 TweenService에서 트윈을 구성할 때 사용됩니다.

Parameters

number InTime	트윈 애니메이션이 시작부터 종료까지 진행되는 데 걸리는 초 단위 시간입니다. 값이 클수록 변화가 더 천천히 이루어집니다.
Enum.EasingStyle InEasingStyle	트윈이 시간에 따라 어떤 곡선 형태로 변화할지를 결정합니다. 이를 통해 부드럽거나 강조된 움직임을 연출할 수 있습니다.
Enum.EasingDirection InEasingDirection	트윈이 시작 지점과 종료 지점 중 어느 쪽에 가속이나 감속을 둘지를 설정합니다.
number InRepeatCount	트윈을 여러 번 다시 실행하도록 설정하는 반복 실행 횟수입니다. -1 값은 무한 반복을 의미합니다.
boolean InReverses	트윈의 왕복 재생 여부를 지정합니다. 활성화할 경우 트윈이 목표 값에 도달한 뒤 시작 값 방향으로 다시 재생되어 왕복 동작을 수행합니다.
number InDelayTime	트윈 시작 전에 대기할 초 단위 시간입니다. 여러 애니메이션을 순차적으로 연출할 때 유용합니다.

Return

TweenInfo	생성된 TweenInfo 객체입니다.

Code Samples

local TweenInfoData = TweenInfo.new(
    2,                         -- 시간             
    Enum.EasingStyle.Linear,   -- 속도 변화 스타일
    Enum.EasingDirection.Out,  -- 속도 적용 방향
    0,                         -- 트윈이 반복되는 횟수(-1이면 무한)      
    false,                     -- 왕복 여부
    0                          -- 시작전 지연 시간
)

Properties

Time

number

트윈 애니메이션이 시작부터 종료까지 진행되는 데 걸리는 초 단위 시간입니다.

Code Samples

local TweenInfoData = TweenInfo.new(
    2,                         -- 시간             
    Enum.EasingStyle.Linear,   -- 속도 변화 스타일
    Enum.EasingDirection.Out,  -- 속도 적용 방향
    0,                         -- 트윈이 반복되는 횟수(-1이면 무한)      
    false,                     -- 왕복 여부
    0                          -- 시작전 지연 시간
)

print(TweenInfoData.Time)

EasingStyle

EasingStyle

트윈이 시간에 따라 어떤 곡선 형태로 변화할지를 나타내는 속성입니다.

Code Samples

local TweenInfoData = TweenInfo.new(
    2,                         -- 시간             
    Enum.EasingStyle.Linear,   -- 속도 변화 스타일
    Enum.EasingDirection.Out,  -- 속도 적용 방향
    0,                         -- 트윈이 반복되는 횟수(-1이면 무한)      
    false,                     -- 왕복 여부
    0                          -- 시작전 지연 시간
)

print(TweenInfoData.EasingStyle)

EasingDirection

EasingDirection

트윈이 시작 지점과 종료 지점 중 어느 쪽에 가속이나 감속을 둘지를 나타내는 속성입니다.

Code Samples

local TweenInfoData = TweenInfo.new(
    2,                         -- 시간             
    Enum.EasingStyle.Linear,   -- 속도 변화 스타일
    Enum.EasingDirection.Out,  -- 속도 적용 방향
    0,                         -- 트윈이 반복되는 횟수(-1이면 무한)      
    false,                     -- 왕복 여부
    0                          -- 시작전 지연 시간
)

print(TweenInfoData.EasingDirection)

RepeatCount

number

트윈 애니메이션의 반복 실행 횟수를 나타내는 속성으로, -1은 무한 반복을 의미합니다.

Code Samples

local TweenInfoData = TweenInfo.new(
    2,                         -- 시간             
    Enum.EasingStyle.Linear,   -- 속도 변화 스타일
    Enum.EasingDirection.Out,  -- 속도 적용 방향
    0,                         -- 트윈이 반복되는 횟수(-1이면 무한)      
    false,                     -- 왕복 여부
    0                          -- 시작전 지연 시간
)

print(TweenInfoData.RepeatCount)

Reverses

boolean

트윈이 목표 값에 도달한 이후, 시작 값 방향으로 다시 재생되어 왕복 동작을 수행할지 여부를 나타내는 속성입니다.

Code Samples

local TweenInfoData = TweenInfo.new(
    2,                         -- 시간             
    Enum.EasingStyle.Linear,   -- 속도 변화 스타일
    Enum.EasingDirection.Out,  -- 속도 적용 방향
    0,                         -- 트윈이 반복되는 횟수(-1이면 무한)      
    false,                     -- 왕복 여부
    0                          -- 시작전 지연 시간
)

print(TweenInfoData.Reverses)

DelayTime

number

트윈 실행 시작 전 대기 시간을 나타내는 속성입니다.

Code Samples

local TweenInfoData = TweenInfo.new(
    2,                         -- 시간             
    Enum.EasingStyle.Linear,   -- 속도 변화 스타일
    Enum.EasingDirection.Out,  -- 속도 적용 방향
    0,                         -- 트윈이 반복되는 횟수(-1이면 무한)      
    false,                     -- 왕복 여부
    0                          -- 시작전 지연 시간
)

print(TweenInfoData.DelayTime)

Methods