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

# GuiBase2d

GuiBase2d : `Instance`

## Overview

2D GuiObject들의 기반이 되는 추상 클래스입니다.

## Properties

### AbsolutePosition

`Vector2`

UI 요소가 실제 화면상에 렌더링되는 위치를 픽셀 단위로 나타내는 속성입니다.

이 값은 부모 UI 요소들의 위치와 크기를 모두 반영한 최종 계산 결과이며, 항상 요소의 좌측 상단을 기준으로 합니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local TextLabel = ScreenGui.TextLabel

print("AbsolutePosition : ", TextLabel.AbsolutePosition)
```

### AbsoluteRotation

`number`

UI 요소와 모든 조상 UI 요소의 Rotation을 합산한 최종 회전 각도를 나타내는 읽기 전용 속성입니다.

부모 Frame이 회전되어 있으면 자식 요소의 Rotation 값이 0이어도 이 값에는 부모의 회전이 반영됩니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local TextLabel = ScreenGui:WaitForChild("TextLabel")

print("AbsoluteRotation : ", TextLabel.AbsoluteRotation)
```

### AbsoluteSize

`Vector2`

UI 요소가 화면에 렌더링될 때 적용되는 실제 크기를 픽셀 단위로 나타내는 속성입니다.

이 값은 부모의 크기, AnchorPoint, Scale 등의 설정이 모두 반영된 결과값으로, 화면에서 해당 요소가 차지하는 최종 크기를 정확하게 확인할 수 있습니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local TextLabel = ScreenGui.TextLabel

print("AbsoluteSize : ", TextLabel.AbsoluteSize)
```

### AutoLocalize

`boolean`

이 GuiBase2d와 그 자손에 자동 로컬라이제이션(Auto Translation)을 적용할지 여부를 지정하는 속성으로, AutoLocalize가 true이면 자동 텍스트 수집(ATC) 대상에도 포함됩니다.

기본값은 true이며, false로 설정하면 해당 객체와 자식 트리전체에서 자동 번역이 비활성화됩니다.

상속 규칙은 다음과 같습니다.

* 자식의 AutoLocalize가 false이면 해당 객체에는 번역이 적용되지 않습니다.
* 부모의 AutoLocalize가 false이면 자식의 값과 무관하게 번역이 적용되지 않습니다.
* 자식의 AutoLocalize가 true이면 부모의 AutoLocalize 설정을 따릅니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local TextLabel = ScreenGui:WaitForChild("TextLabel")

TextLabel.AutoLocalize = false
```

### ClippedRect

`Rect`

조상 UI 요소의 클리핑(ClipsDescendants)을 적용한 뒤 실제로 화면에 보이는 영역을 픽셀 단위 사각형으로 나타내는 읽기 전용 속성입니다.

클리핑하는 조상이 없으면 RawRect2D와 같은 값을 가집니다. 조상 영역 밖으로 완전히 벗어나 보이는 부분이 없으면 크기가 0인 사각형이 됩니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local Frame = ScreenGui:WaitForChild("Frame")
local TextLabel = Frame:WaitForChild("TextLabel")

print("ClippedRect : ", TextLabel.ClippedRect)
```

### IsNotOccluded

`boolean`

UI 요소가 화면에 표시될 수 있는 상태인지를 나타내는 읽기 전용 속성입니다.

자신과 모든 조상의 Visible(또는 Enabled)이 true이고 ClippedRect가 비어 있지 않으면 true입니다. 다른 UI 요소에 가려졌는지는 판단하지 않으므로, 앞쪽 요소에 덮여 있어도 true일 수 있습니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local TextLabel = ScreenGui:WaitForChild("TextLabel")

print("IsNotOccluded : ", TextLabel.IsNotOccluded)
```

### RawRect2D

`Rect`

클리핑을 적용하기 전 UI 요소가 화면에서 차지하는 영역을 픽셀 단위 사각형으로 나타내는 읽기 전용 속성입니다.

Min은 AbsolutePosition, Max는 AbsolutePosition에 AbsoluteSize를 더한 위치와 같습니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local TextLabel = ScreenGui:WaitForChild("TextLabel")

print("RawRect2D : ", TextLabel.RawRect2D)
```

### TotalGroupScale

`number`

조상 UI 요소에 적용된 UIScale 배율을 모두 곱한 누적 배율을 나타내는 읽기 전용 속성입니다.

UIScale이 없으면 1입니다. 예를 들어 0.92 배율 안에 0.85 배율이 중첩되어 있으면 0.782가 됩니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local TextLabel = ScreenGui:WaitForChild("TextLabel")

print("TotalGroupScale : ", TextLabel.TotalGroupScale)
```

## Methods

## Events