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

# Font

## Overview

Font는 텍스트에 적용할 폰트를 폰트 패밀리와 굵기, 기울임 여부까지 하나로 묶어 표현하는 데이터 타입입니다.

TextLabel과 TextButton의 FontFace 속성, GetTextBoundsParams의 Font 속성에서 사용됩니다.

사용할 수 있는 폰트 패밀리는 다음과 같습니다. Asset Id는 new()와 fromId()에 전달하는 값이며, fromName()에는 폰트 이름에서 공백을 제외한 값을 전달합니다. 예를 들어 Press Start 2P는 PressStart2P로 전달합니다.

| 폰트               | Asset Id                | Weight                                                             | Italic |  영어 | 포르투갈어 | 힌디어 |
| ---------------- | ----------------------- | ------------------------------------------------------------------ | :----: | :-: | :---: | :-: |
| Anton            | ovdrassetid://900000166 | Regular                                                            |    -   |  O  |   O   |  -  |
| Archivo Black    | ovdrassetid://900000366 | Regular                                                            |    -   |  O  |   O   |  -  |
| Baloo 2          | ovdrassetid://900000566 | Regular·Medium·SemiBold·Bold·ExtraBold                             |    -   |  O  |   O   |  O  |
| Creepster        | ovdrassetid://900001166 | Regular                                                            |    -   |  O  |   O   |  -  |
| Eater            | ovdrassetid://900001366 | Regular                                                            |    -   |  O  |   O   |  -  |
| Fredoka          | ovdrassetid://900001566 | Light·Regular·Medium·SemiBold·Bold                                 |    -   |  O  |   O   |  -  |
| Great Vibes      | ovdrassetid://900002166 | Regular                                                            |    -   |  O  |   O   |  -  |
| Grenze Gotisch   | ovdrassetid://900002366 | Thin·ExtraLight·Light·Regular·Medium·SemiBold·Bold·ExtraBold·Black |    -   |  O  |   O   |  -  |
| Kalam            | ovdrassetid://900003366 | Light·Regular·Bold                                                 |    -   |  O  |   O   |  O  |
| Michroma         | ovdrassetid://900003766 | Regular                                                            |    -   |  O  |   O   |  -  |
| Nosifer          | ovdrassetid://900003966 | Regular                                                            |    -   |  O  |   O   |  -  |
| Noto Sans        | ovdrassetid://900004166 | Thin·ExtraLight·Light·Regular·Medium·SemiBold·Bold·ExtraBold·Black |    O   |  O  |   O   |  O  |
| Nunito           | ovdrassetid://900006066 | ExtraLight·Light·Regular·Medium·SemiBold·Bold·ExtraBold·Black      |    O   |  O  |   O   |  -  |
| Orbitron         | ovdrassetid://900007766 | Regular·Medium·SemiBold·Bold·ExtraBold·Black                       |    -   |  O  |   O   |  -  |
| OverWacky        | ovdrassetid://900008466 | Black                                                              |    O   |  O  |   O   |  -  |
| Patrick Hand     | ovdrassetid://900008766 | Regular                                                            |    -   |  O  |   O   |  -  |
| Permanent Marker | ovdrassetid://900008966 | Regular                                                            |    -   |  O  |   O   |  -  |
| Playfair Display | ovdrassetid://900009166 | Regular·Medium·SemiBold·Bold·ExtraBold·Black                       |    O   |  O  |   O   |  -  |
| Press Start 2P   | ovdrassetid://900010466 | Regular                                                            |    -   |  O  |   O   |  -  |
| Roboto           | ovdrassetid://900010666 | Thin·ExtraLight·Light·Regular·Medium·SemiBold·Bold·ExtraBold·Black |    O   |  O  |   O   |  -  |
| Sono             | ovdrassetid://900012566 | ExtraLight·Light·Regular·Medium·SemiBold·Bold·ExtraBold            |    -   |  O  |   O   |  -  |
| Tomorrow         | ovdrassetid://900013366 | Thin·ExtraLight·Light·Regular·Medium·SemiBold·Bold·ExtraBold·Black |    O   |  O  |   O   |  -  |
| Varela Round     | ovdrassetid://900015466 | Regular                                                            |    -   |  O  |   O   |  -  |
| VT323            | ovdrassetid://900015266 | Regular                                                            |    -   |  O  |   O   |  -  |

## Constructors

### fromId

Asset Id 숫자 값으로 새로운 Font를 생성하여 반환합니다.

#### Parameters

| `number` id              | 폰트 패밀리의 Asset Id입니다.                        |
| ------------------------ | ------------------------------------------- |
| `Enum.FontWeight` weight | 텍스트의 굵기입니다. 생략할 경우 기본값으로 Regular가 사용됩니다.    |
| `Enum.FontStyle` style   | 텍스트의 기울임 여부입니다. 생략할 경우 기본값으로 Normal이 사용됩니다. |

#### Return

| `Font` | 생성된 Font입니다. |
| ------ | ------------ |

#### Code Samples

```lua
local NewFont = Font.fromId(900000166, Enum.FontWeight.Regular, Enum.FontStyle.Normal)
```

### fromName

폰트 패밀리의 이름으로 새로운 Font를 생성하여 반환합니다.

전달한 이름은 내부에서 폰트 패밀리의 Asset Id로 변환됩니다.

**Parameters**

| `string` name            | 폰트 패밀리의 이름입니다.                              |
| ------------------------ | ------------------------------------------- |
| `Enum.FontWeight` weight | 텍스트의 굵기입니다. 생략할 경우 기본값으로 Regular가 사용됩니다.    |
| `Enum.FontStyle` style   | 텍스트의 기울임 여부입니다. 생략할 경우 기본값으로 Normal이 사용됩니다. |

**Return**

| `Font` | 생성된 Font입니다. |
| ------ | ------------ |

#### Parameters

| `string` name            | 폰트 패밀리의 이름입니다.                              |
| ------------------------ | ------------------------------------------- |
| `Enum.FontWeight` weight | 텍스트의 굵기입니다. 생략할 경우 기본값으로 Regular가 사용됩니다.    |
| `Enum.FontStyle` style   | 텍스트의 기울임 여부입니다. 생략할 경우 기본값으로 Normal이 사용됩니다. |

#### Return

| `Font` | 생성된 Font입니다. |
| ------ | ------------ |

#### Code Samples

```lua
local NewFont = Font.fromName("Fredoka", Enum.FontWeight.Bold, Enum.FontStyle.Normal)
```

### new

폰트 패밀리의 Asset Id로 새로운 Font를 생성하여 반환합니다.

#### Parameters

| `string` family          | 폰트 패밀리의 Asset Id입니다.                        |
| ------------------------ | ------------------------------------------- |
| `Enum.FontWeight` weight | 텍스트의 굵기입니다. 생략할 경우 기본값으로 Regular가 사용됩니다.    |
| `Enum.FontStyle` style   | 텍스트의 기울임 여부입니다. 생략할 경우 기본값으로 Normal이 사용됩니다. |

#### Return

| `Font` | 생성된 Font입니다. |
| ------ | ------------ |

#### Code Samples

```lua
local NewFont = Font.new("ovdrassetid://900000166", Enum.FontWeight.Bold, Enum.FontStyle.Italic)
```

## Properties

### Family

`string`

폰트 패밀리의 Asset Id입니다.

값은 ovdrassetid:// 형식으로 표시됩니다.

#### Code Samples

```lua
local NewFont = Font.fromName("Fredoka")
print(NewFont.Family)
```

### Style

`Enum.FontStyle`

텍스트를 기울여 표시할지 지정합니다.

기본값은 Normal입니다. 선택한 폰트 패밀리가 기울임을 가지고 있지 않으면 Italic을 지정해도 기울지 않은 상태로 표시됩니다.

#### Code Samples

```lua
local NewFont = Font.fromName("Tomorrow")
NewFont.Style = Enum.FontStyle.Italic
```

### Weight

`Enum.FontWeight`

텍스트의 굵기를 지정합니다.

기본값은 Regular이며, 선택한 폰트 패밀리에 없는 굵기를 지정하면 가장 가까운 굵기로 대체됩니다.

이 값이 SemiBold 이상이면 Bold 속성이 true로 함께 갱신됩니다.

#### Code Samples

```lua
local NewFont = Font.fromName("NotoSans")
NewFont.Weight = Enum.FontWeight.SemiBold
```

## Methods

## Events

## See also

{% content-ref url="/pages/TCVRv0pNSKmoRlYtDnNq" %}
[TextLabel](/korean/development/api-reference/classes/textlabel.md)
{% endcontent-ref %}

{% content-ref url="/pages/EgWxUIbUDIALVPZH7qN0" %}
[TextButton](/korean/development/api-reference/classes/textbutton.md)
{% endcontent-ref %}
