> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/korean/development/api-reference/datatype/tweeninfo.md). # 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 ```lua local TweenInfoData = TweenInfo.new( 2, -- 시간 Enum.EasingStyle.Linear, -- 속도 변화 스타일 Enum.EasingDirection.Out, -- 속도 적용 방향 0, -- 트윈이 반복되는 횟수(-1이면 무한) false, -- 왕복 여부 0 -- 시작전 지연 시간 ) ``` ## Properties ### DelayTime `number` 트윈 실행 시작 전 대기 시간을 나타내는 속성입니다. #### Code Samples ```lua local TweenInfoData = TweenInfo.new( 2, -- 시간 Enum.EasingStyle.Linear, -- 속도 변화 스타일 Enum.EasingDirection.Out, -- 속도 적용 방향 0, -- 트윈이 반복되는 횟수(-1이면 무한) false, -- 왕복 여부 0 -- 시작전 지연 시간 ) print(TweenInfoData.DelayTime) ``` ### EasingDirection `Enum.EasingDirection` 트윈이 시작 지점과 종료 지점 중 어느 쪽에 가속이나 감속을 둘지를 나타내는 속성입니다. #### Code Samples ```lua local TweenInfoData = TweenInfo.new( 2, -- 시간 Enum.EasingStyle.Linear, -- 속도 변화 스타일 Enum.EasingDirection.Out, -- 속도 적용 방향 0, -- 트윈이 반복되는 횟수(-1이면 무한) false, -- 왕복 여부 0 -- 시작전 지연 시간 ) print(TweenInfoData.EasingDirection) ``` ### EasingStyle `Enum.EasingStyle` 트윈이 시간에 따라 어떤 곡선 형태로 변화할지를 나타내는 속성입니다. #### Code Samples ```lua local TweenInfoData = TweenInfo.new( 2, -- 시간 Enum.EasingStyle.Linear, -- 속도 변화 스타일 Enum.EasingDirection.Out, -- 속도 적용 방향 0, -- 트윈이 반복되는 횟수(-1이면 무한) false, -- 왕복 여부 0 -- 시작전 지연 시간 ) print(TweenInfoData.EasingStyle) ``` ### RepeatCount `number` 트윈 애니메이션의 반복 실행 횟수를 나타내는 속성으로, -1은 무한 반복을 의미합니다. #### Code Samples ```lua local TweenInfoData = TweenInfo.new( 2, -- 시간 Enum.EasingStyle.Linear, -- 속도 변화 스타일 Enum.EasingDirection.Out, -- 속도 적용 방향 0, -- 트윈이 반복되는 횟수(-1이면 무한) false, -- 왕복 여부 0 -- 시작전 지연 시간 ) print(TweenInfoData.RepeatCount) ``` ### Reverses `boolean` 트윈이 목표 값에 도달한 이후, 시작 값 방향으로 다시 재생되어 왕복 동작을 수행할지 여부를 나타내는 속성입니다. #### Code Samples ```lua local TweenInfoData = TweenInfo.new( 2, -- 시간 Enum.EasingStyle.Linear, -- 속도 변화 스타일 Enum.EasingDirection.Out, -- 속도 적용 방향 0, -- 트윈이 반복되는 횟수(-1이면 무한) false, -- 왕복 여부 0 -- 시작전 지연 시간 ) print(TweenInfoData.Reverses) ``` ### Time `number` 트윈 애니메이션이 시작부터 종료까지 진행되는 데 걸리는 초 단위 시간입니다. #### Code Samples ```lua local TweenInfoData = TweenInfo.new( 2, -- 시간 Enum.EasingStyle.Linear, -- 속도 변화 스타일 Enum.EasingDirection.Out, -- 속도 적용 방향 0, -- 트윈이 반복되는 횟수(-1이면 무한) false, -- 왕복 여부 0 -- 시작전 지연 시간 ) print(TweenInfoData.Time) ``` ## Methods ## Events ## See also