# 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 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.overdare.com/korean/development/api-reference/datatype/tweeninfo.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.