# UIAspectRatioConstraint

UIAspectRatioConstraint : `Instance`

## Overview

UI 요소가 화면 크기 변화나 부모 요소 비율에 영향을 받더라도 항상 지정된 가로세로 비율을 유지하도록 강제로 조정해 주는 인스턴스입니다. 예를 들어, 2:1 비율을 지정하면 높이가 변화하더라도 너비는 자동으로 그 두 배가 되며, 1:1을 지정하면 어떤 환경에서도 정사각형 형태를 유지하게 됩니다.

특히 정사각형 이미지처럼 비율이 흐트러지면 품질이 저하되는 UI 요소를 다룰 때 매우 효과적입니다. 또한 다른 UIGridLayout, UIListLayout 등  UI 레이아웃이 요소 크기를 조정하려는 상황에서도, 가로세로 비율 제약이 최우선으로 적용되어 UI 객체의 크기를 결정하게 됩니다.

UIAspectRatioConstraint은 **클라이언트 환경**에서만 제어할 수 있습니다.

## Properties

### AspectRatio

`number`

UI 요소가 어떤 가로세로 비율을 유지해야 하는지를 지정합니다.

예를 들어 2를 입력하면 너비가 높이의 두 배가 되며, 반대로 세로 기준의 비율을 유지하고 싶다면 해당 숫자의 역수를 사용하시면 됩니다.

값은 0보다 커야 정상적으로 적용되며, 잘못된 비율 값은 제약 조건이 올바르게 작동하지 않게 만들 수 있습니다.

```lua
local UIAspectRatioConstraint = script.Parent

UIAspectRatioConstraint.AspectRatio = 2
```

#### Code Samples

### AspectType

`Enum.AspectType`

UI 요소가 얼마나 크게 확장될 수 있는지를 제어하는 방식입니다.

FitWithinMaxSize를 선택하면 객체는 실제 크기(AbsoluteSize)를 넘지 않는 선에서 가장 크게 그려지며, ScaleWithParentSize를 선택하면 부모 UI의 크기를 기준으로 가능한 한 크게 조정됩니다.

#### Code Samples

```lua
local UIAspectRatioConstraint = script.Parent

UIAspectRatioConstraint.AspectType = Enum.AspectType.FitWithinMaxSize
```

### DominantAxis

`Enum.DominantAxis`

UI 요소가 부모보다 커지려고 할 때, 어떤 방향(가로 또는 세로)을 기준으로 크기 조정을 진행할지를 결정합니다. 즉, UI 요소가 부모의 제한을 넘지 않도록 할 때, 먼저 어떤 축을 기준 삼아 비율 조정이 이루어질지를 정의하는 역할을 합니다.

#### Code Samples

```lua
local UIAspectRatioConstraint = script.Parent

UIAspectRatioConstraint.DominantAxis = Enum.DominantAxis.Width
```

## Methods

## Events

## See also

{% content-ref url="../../../manual/studio-manual/gui" %}
[gui](https://docs.overdare.com/korean/manual/studio-manual/gui)
{% endcontent-ref %}