Tween

Tween : TweenBase

Overview

The Tween class is a fundamental part of animating properties in game objects, providing a way to interpolate values over time using customizable easing styles and directions. It is widely used for creating smooth transitions and animations in game elements.

Description

The Tween class allows for seamless animations by interpolating properties such as position, color, size, and more over a specified duration. By leveraging the EasingStyle and EasingDirection properties, Tween animations can achieve dynamic motion effects that enhance user experience and interaction in applications.

Properties

TweenInfo

TweenInfo

The TweenInfo property defines the duration, easing style, easing direction, repeat count, reverses, and delay time for the Tween animation. It is essential for customizing the characteristics of the animation.

Code Samples

local TweenService = game:GetService("TweenService")
local Part = workspace:WaitForChild("Part") -- 이동시킬 파트

-- Tween 정보 설정
local TweenInfoData = TweenInfo.new(
    5,                        -- 지속 시간 (초)
    Enum.EasingStyle.Linear,  -- 트윈 스타일
    Enum.EasingDirection.Out, -- 트윈 방향
    0,                        -- 반복 횟수
    false,                    -- 왕복 여부
    0                         -- 대기 시간
)

-- 트윈 위치 이동
local TweenGoals = 
{
    Position = Vector3.new(-400, 50, -350)
}

local Tween = TweenService:Create(Part, TweenInfoData, TweenGoals)
Tween:Play()

Methods

Play

The Play method starts or resumes the Tween animation, allowing the object’s properties to transition smoothly toward the defined goals.

Parameters

Return

void

Code Samples

Tween:Play()

Cancel

The Cancel method stops the Tween animation immediately and resets the properties to their initial state.

Parameters

Return

void

Code Samples

Tween:Cancel()

Pause

The Pause method temporarily halts the Tween animation, allowing it to be resumed later without resetting.

Parameters

Return

void

Code Samples

Tween:Pause() -- Pause
wait(2)

Tween:Play()  -- Resume

Events