Udim2

Overview

UDim2는 가로(X)와 세로(Y) 두 방향의 값을 함께 다루는 데이터 타입으로, 각 방향마다 전체 크기에 비례하는비율 값과 고정된 픽셀 단위의 보정 값을 함께 포함합니다. UI 요소의 크기나 화면 내 위치를 유연하게 지정할 때 가장 많이 활용됩니다.

Constructors

new

X축과 Y축에 대해 전달된 스케일 값과 오프셋 값을 기반으로 하나의 UDim2 객체를 생성하여 반환합니다. 생성된 UDim2는 UI의 위치나 크기를 직접 지정할 때 사용할 수 있습니다.

Parameters

number xScale	부모 요소의 크기를 기준으로 X축 방향에 적용되는 상대적인 비율 값입니다.
number xOffset	X축 방향에 픽셀 단위로 적용되는 절대 값입니다.
number yScale	부모 요소의 크기를 기준으로 Y축 방향에 적용되는 상대적인 비율 값입니다.
number yOffset	Y축 방향에 픽셀 단위로 적용되는 절대 값입니다.

Return

UDim2	지정된 스케일 및 오프셋 값으로 구성된 UDim2입니다.

Code Samples

local Position = UDim2.new(0.5, 10, 0.5, 20)

TextLabel.Position = Position

Properties

X

UDim

X축 방향에 적용되는 상대적인 스케일 값과 픽셀 기준의 오프셋 값을 함께 나타냅니다.

Code Samples

local Position = UDim2.new(0.5, 10, 0.5, 20)

print(Position.X.Scale, Position.X.Offset)

Y

UDim

Y축 방향에 적용되는 상대적인 스케일 값과 픽셀 기준의 오프셋 값을 함께 나타냅니다.

Code Samples

local Position = UDim2.new(0.5, 10, 0.5, 20)

print(Position.Y.Scale, Position.Y.Offset)

Methods

Lerp

현재 Dim2와 목표 Dim2 사이를 선형 보간 방식으로 alpha 비율에 따라 계산한 위치를 새로운 Dim2로 반환합니다.

Parameters

UDim2 GoalValue	보간의 대상이 되는 목표 Dim2입니다.
number Alpha	보간 비율을 나타내는 값입니다.

Return

UDim2	생성된 UDim2입니다.

Code Samples

local a = UDim2.new(0.0, 0, 0.1, 0)
local b = UDim2.new(0.1, 100, 0.1, 100)
print(a:Lerp(b, 0.3)) --> Output: {0.03, 30}, {0.1, 30}

Events

See also

좌표계