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

# CanvasGroup

CanvasGroup : `Frame`

## Overview

CanvasGroup은 자기 자신과 모든 하위 UI 요소를 하나의 이미지로 합성하여 렌더링한 뒤, 그 결과 전체에 색상과 투명도를 한 번에 적용하는 Frame 기반의 UI 컨테이너입니다.

하위 UI 요소들의 투명도를 각각 조정하면 요소가 겹치는 부분이 비쳐 보이지만, CanvasGroup의 GroupTransparency를 사용하면 하위 요소 전체를 하나의 이미지처럼 균일하게 페이드 인·아웃할 수 있습니다.

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

## Properties

### GroupColor3

`Color3`

CanvasGroup과 하위 UI 요소 전체를 합성한 결과에 곱해질 색상을 지정하는 속성입니다.

기본값은 흰색이며, 이 경우 별도의 색 보정 없이 원래 색상 그대로 표시됩니다. 각 색상 성분은 0\~1 범위로 제한됩니다.

#### Code Samples

### GroupTransparency

`number`

CanvasGroup과 하위 UI 요소 전체를 합성한 결과의 투명도를 지정하는 속성입니다.

0은 완전한 불투명 상태를 의미하고, 1은 전혀 보이지 않는 상태를 의미합니다. 기본값은 0이며, 0\~1 범위를 벗어난 값은 해당 범위로 보정됩니다.

#### Code Samples

## Methods

## Events
