> 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/udim2.md).

# 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

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

TextLabel.Position = Position
```

## Properties

### X

`UDim`

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

#### Code Samples

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

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

### Y

`UDim`

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

#### Code Samples

```lua
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

```lua
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

{% content-ref url="/pages/mC9duPphkAklv8ZEUCpW" %}
[좌표계](/korean/manual/studio-manual/get-started/coordinate-system.md)
{% endcontent-ref %}