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

# UIGradient

UIGradient : `UIComponent`

## Overview

부모 UI 요소의 배경에 색상 및 투명도 그라디언트를 적용하는 UI 컴포넌트입니다.

그라디언트는 부모 UI 요소의 영역을 기준으로 적용되며, Type으로 형태를, Rotation으로 방향을, Offset으로 위치를, Scale로 폭을 정하고, TileMode로 그라디언트 범위 밖을 채우는 방식을 지정합니다. 그라디언트는 부모 UI 요소 자신의 배경에만 적용되며, 자식 UI 요소에는 영향을 주지 않습니다.

UIGradient는 그라디언트를 적용할 UI 요소의 자식으로 배치하여 사용합니다. 하나의 UI 요소에 UIGradient가 여러 개 있는 경우 첫 번째 UIGradient만 적용됩니다.

## Properties

### Color

`ColorSequence`

그라디언트를 따라 부모 UI 요소의 배경색에 곱해지는 색상을 ColorSequence로 지정하는 속성입니다.

배경색에 곱해지는 방식이므로, ColorSequence의 색상을 그대로 표시하려면 부모 UI 요소의 배경색을 흰색으로 설정하는 것이 좋습니다. 기본값은 흰색 단색으로, 부모 UI 요소의 색상이 그대로 유지됩니다.

#### Code Samples

### Enabled

`boolean`

그라디언트의 적용 여부를 지정하는 속성입니다.

false로 설정하면 그라디언트가 해제되어 부모 UI 요소가 원래 색상으로 표시됩니다. 기본값은 true입니다.

#### Code Samples

### Offset

`Vector2`

그라디언트의 위치를 이동시키는 속성입니다.

부모 UI 요소의 크기를 1로 보는 정규화 좌표를 사용하며, 예를 들어 `Vector2.new(0.5, 0)`으로 지정하면 그라디언트가 부모 UI 요소 너비의 절반만큼 이동합니다. 기본값은 `Vector2.new(0, 0)`입니다.

#### Code Samples

### Rotation

`number`

그라디언트의 방향을 도(degree) 단위의 각도로 지정하는 속성입니다.

왼쪽에서 오른쪽으로 향하는 방향을 0도로 보며, 값이 커질수록 시계 방향으로 회전합니다. Type이 Conical인 경우에는 그라디언트가 시작되는 각도를 의미합니다. 기본값은 0입니다.

#### Code Samples

### Scale

`number`

그라디언트의 폭을 지정하는 속성입니다.

1보다 크면 그라디언트가 늘어나 일부 구간만 보이게 되고, 1보다 작으면 그라디언트가 좁아져 범위 밖의 영역이 생깁니다. 범위 밖의 영역은 TileMode에 따라 채워집니다. 최솟값은 0.01이며, 기본값은 1입니다.

#### Code Samples

### TileMode

`Enum.GradientTileMode`

그라디언트 범위 밖의 영역을 채우는 방식을 지정하는 속성입니다.

기본값은 Clamp입니다.

#### Code Samples

### Transparency

`NumberSequence`

그라디언트를 따라 부모 UI 요소에 더해지는 투명도를 NumberSequence로 지정하는 속성입니다.

값이 0이면 부모 UI 요소의 투명도가 그대로 유지되고, 1이면 완전히 투명해집니다. NumberSequenceKeypoint의 Envelope 값은 적용되지 않습니다. 기본값은 전 구간 0입니다.

#### Code Samples

### Type

`Enum.GradientType`

그라디언트의 형태를 지정하는 속성입니다.

기본값은 Linear입니다.

#### Code Samples

## Methods

## Events
