위젯 유형 레퍼런스

언리얼 모션 그래픽, UMG 에서 사용할 수 있는 위젯에 대한 레퍼런스입니다.

Windows
MacOS
Linux

위젯 블루프린트 에디터 안에서, 팔레트 창 아래에는 위젯 카테고리가 넷 있으며, 그 각각에는 다양한 위젯 유형 이 들어있어, 비주얼 디자이너 안에 끌어 놓을 수 있습니다. 이러한 위젯 유형을 섞어 맞춰 쓰는 방식으로 디자이너 탭에서 UI 모양을 배치하고, 그래프 탭을 통해 각 위젯의 디테일 패널 내 세팅을 통해 위젯에 함수 기능을 추가할 수 있습니다.

아래는 팔레트 창 아래 각 위젯 유형 에 대한 설명입니다.

위젯 유형을 클릭(가능)하면 사용 안내서와 더불어 위젯 자체에 대한 상세 정보가 나타납니다.

일반

Common.png

가장 자주 사용되는 위젯 이 보통 이 카테고리에 들어갑니다.

옵션

설명

Border

테두리 - 하나의 자손 위젯을 가질 수 있는 컨테이너 위젯으로, 테두리 이미지와 조절가능 여백을 두고 가장자리를 둘러싸는 기능을 제공합니다.

Button

버튼 - 단일 자손 클릭 가능 프리미티브 위젯으로, 기본적인 상호작용에 쓰입니다. 버튼 안에 다른 위젯을 배치하여 UI 에 좀 더 복잡하고 재미난 클릭가능 요소를 만들 수 있습니다.

Check Box

체크 박스 - 'unchecked' 체크해제 / 'checked' 체크됨 / 'indeterminable' 확인불가 세 가지 토글 상태를 표시할 수 있습니다. 체크 박스는 고전 체크 박스, 토글 버튼, 동글 버튼으로 사용할 수 있습니다.

Image

이미지 - 이미지 위젯으로 UI 에 슬레이트 브러시, 텍스처, 스프라이트, 머티리얼을 표시할 수 있습니다.

같은 텍스처 아틀라스에 들어있는 스프라이트는, 렌더링할 때 같은 레이어를 공유하는 경우 슬레이트에 일괄 배치시킬 수 있습니다. 즉 드로 콜 수 예산이 빠듯한 플랫폼에서는 Paper2D 스프라이트를 브러시 입력으로 사용하는 경우 UMG 와 슬레이트 위젯의 렌더링 효율이 크게 향상된다는 뜻입니다.

Named Slot

다른 위젯을 채울 수 있는 사용자 위젯에 대한 외부 슬롯을 노출시켜 주는 위젯으로, 커스텀 위젯 함수 기능을 만드는 데 좋습니다.

Progress Bar

진행상황 바 - 진행상황 바 위젯은 경험치, 생명력, 점수와 같은 여러가지 용도에 맞도록 스타일 조정이 가능한, 단순한 바 입니다.

Slider

슬라이더 - 0-1 사이 값 조절이 가능한 핸들이 있는 미닫이 바가 표시되는 단순 위젯입니다.

Text

텍스트 - 화면상에 텍스트를 표시하는 기본적인 방법으로, 옵션이나 기타 UI 요소에 대한 텍스트 설명에 사용할 수도 있습니다.

Text Box

텍스트 박스 - 사용자가 커스텀 입력을 할 수 있도록 합니다. 한 줄 텍스트만 입력 가능합니다.

여분

Extra.png

다른 위젯을 보조하는 위젯이 들어있습니다.

옵션

설명

Expandable Area

확장가능 영역 - 컨테이너 안의 자손 위젯을 펼치거나 접을 수 있도록 해줍니다.

입력

Input.png

사용자의 입력 을 받는 방법은 아래와 같습니다:

옵션

설명

Combo Box (String)

콤보 박스 (문자열) - 사용자에게 드롭다운 메뉴로 옵션 목록을 표시하고 그 중에서 선택할 수 있도록 합니다.

Spin Box

스핀 박스 - 숫자를 직접 입력하거나 슬라이더로 입력할 수도 있는 숫자 입력 박스입니다.

Text Box (Multi-Line)

텍스트 박스 (여러줄) - **Text Box** 와 비슷하지만 한 줄이 아닌 여러줄 입력이 가능합니다.

최적화

OptimizationWidgets.png

여기에 들어있는 위젯은 주로 UI 를 최적화시켜 퍼포먼스를 향상시키는 데 쓰입니다.

옵션

설명

Invalidation Box

인밸리데이션(무효화) 박스에 둘러싸인 위젯은 그 자손 위젯 지오메트리를 캐시에 담아 슬레이트 렌더링 속도를 올릴 수 있습니다. 인밸리데이션 박스로 인해 캐시에 담긴 위젯은 프리패스(Prepass), 틱, 페인트 처리되지 않습니다.

Retainer Box

리테이너 박스 - 렌더 타깃에 자손 위젯을 먼저 렌더링한 후 나중에 그 렌더 타깃을 화면에 렌더링합니다. 이를 통해 UI 가 메인 게임 렌더 빈도보다 실제로 적게 렌더할 수 있도록 빈도와 단계(phase) 모두 제어할 수 있습니다. 위젯을 그린 후 머티리얼을 렌더 타깃에 적용시켜 단순 포스트 프로세스를 적용하는 부가 효과도 있습니다.

패널

Panel.png

패널 카테고리에는 레이아웃 조절이나 다른 위젯 배치용 위젯이 들어있습니다.

옵션

설명

Canvas Panel

캔버스 패널 - 위젯을 임의 위치에 배치하고, 앵커 설정하며, 캔버스의 다른 자손과 Z 순서를 조정할 수 있도록 해 주는 디자이너 친화적 패널입니다. 참고로 Z 순서를 수동 변경할 수는 있어도 위젯은 목록 순서대로 렌더링되므로, Z 순서에 의존하기 보다는 목록의 순서를 변경하는 것이 낫습니다. 캔버스 패널은 위치가 절대적인 수동 배치에 좋은 위젯이지만, 위젯을 절차적 생성 방식으로 컨테이너에 넣고자 할 때는 그리 좋지 않습니다. 앵커 관련 상세 정보는 앵커 페이지를 참고하세요.

Grid Panel

그리드 패널 - 남은 공간을 모든 자손 위젯과 균등하게 나누는 패널입니다.

Horizontal Box

가로 박스 - 자손 위젯이 가로로 배치되도록 합니다.

Overlay

오버레이 - 위젯이 서로 쌓이도록 하며, 각 레이어의 콘텐츠에는 단순한 레이아웃을 사용합니다.

Safe Zone

안전지대 - 플랫폼의 안전지대 정보를 뽑아 패딩을 추가합니다.

Scale Box

스케일 박스 - 원하는 크기의 콘텐츠를 배치하고 이 박스의 할당 영역에 배치된 제한에 맞도록 스케일을 조절합니다. 배경 이미지가 일정 영역에 맞게끔 스케일 조절은 하지만 종횡비가 달라져 찌그러지지는 않도록 하거나, 특정 텍스트를 한 영역에 자동으로 맞도록 할 필요가 있는 경우에 좋습니다.

Scroll Box

스크롤 박스 - 임의의 스크롤가능 위젯 모음입니다. 목록에 10-100 개의 위젯을 넣을 때 좋습니다. 가상화는 지원하지 않습니다.

Size Box

사이즈 박스 - 보고하는 박스에 원하는 크기를 지정할 수 있습니다. 모든 위젯이 실제 원하는 크기의 박스로 보고하지는 않습니다. 위젯을 Size Box 로 감싸면 Size Box 가 특정 크기로 강제시킬 수 있습니다.

Uniform Grid Panel

균등 그리드 패널 - 자손 모두와 남은 공간을 균등하게 나누는 패널입니다.

Vertical Box

세로 박스 - 자손 위젯이 자동으로 세로로 배치되도록 하는 위젯입니다. 위젯끼리 세로 정렬을 유지하면서 서로 쌓이도록 하는 데 좋습니다.

Widget Switcher

위젯 전환기 - 자체적으로 만들 수 있는 탭은 없으나 탭처럼 제어되는 것으로, 이와 함께 하여 탭 효과를 낼 수 있습니다. 한 번에 최대 하나의 위젯만 보입니다.

Wrap Box

자손 위젯이 왼쪽에서 오른쪽으로 정렬됩니다. 위젯이 폭 제한을 넘은 경우, 위젯을 다음 줄에 배치합니다.

프리미티브

Primitive.png

프리미티브 카테고리에 들어있는 위젯은 사용자에게 정보를 주거나 무언가 선택할 수 있도록 해 주는 방식을 추가로 제공해 줍니다.

옵션

설명

Circular Throbber

원형 트로버 - 회전하는 원형 이미지로 (주로 로드중임을) 나타내는 트로버 위젯입니다.

Editable Text

편집가능 텍스트 - 박스 배경 없이 사용자 입력이 가능한 글상자입니다. 편집가능 텍스트 한 줄만 지원합니다.

Editable Text (Multi-Line)

편집가능 텍스트 (여러줄) - **Editable Text** 와 비슷하나 한 줄이 아닌 여러줄 텍스트를 지원합니다.

Menu Anchor

이 위젯은 팝업 메뉴의 기준이 되어 띄울 위치를 지정할 수 있습니다.

Native Widget Host

네이티브 위젯 호스트 - 하나의 자손 슬레이트 위젯을 포함할 수 있는 컨테이너 위젯입니다. UMG 위젯 안에 네이티브 위젯을 중첩시키기만 하면 되는 경우에 사용합니다.

Spacer

스페이서 - 다른 위젯 사이에 임의의 여백을 제공해 주는 위젯입니다. 스페이서는 시각적 표시가 없어 게임에서 보이지 않습니다.

Throbber

트로버 - 연속해서 여러개 확대되는 원으로 보이는 애니메이션 트로버 위젯입니다 (주로 로딩중임을 나타낼 때 사용됩니다).

특수 효과

SpecialEffects.png

이 위젯은 UI 기반 특수 효과를 만드는 데 사용됩니다.

옵션

설명

Background Blur

Background Blur (백그라운드 블러) 위젯은 하나의 자손 위젯을 가질 수 있는데, 거기에 조절 가능한 패딩을 붙여 포스트 프로세스 가우시안 블러를 적용하여 위젯 아래 모든 콘텐츠에 블러를 적용할(뿌옇게 만들) 수 있습니다.

미분류

Uncategorized.png

이 섹션의 위젯은 특수한 경우로 다른 카테고리에 속하지 않습니다.

옵션

설명

Input Key Selector

입력 키 선택기 - 단일 키 또는 다른 키와 같이 누른 키 선택을 하는 위젯입니다.

Window Title Bar Area

창 제목 줄 영역 - 사용자가 데스크톱 플랫폼에서 창을 끌 수 있도록 해주는 UI 영역을 정의하는 패널입니다.

사용자 생성

UserCreated.png

User Created Widget (사용자 생성 위젯)은 미리 생성해 둔 위젯 블루프린트 를 다른 위젯 블루프린트 안에 배치할 수 있는 것입니다. UI 요소의 "파트" 를 개별 위젯 블루프린트로 만든 다음, 조합해서 전체적인 UI 레이아웃을 만드는 데 좋습니다.

예를 들어 플레이어의 생명력 정보 표시를 담당하는 Player Health 위젯, 플레이어가 수집한 아이템 정보 기록을 담당하는 Inventory 위젯, 플레이어가 버튼을 누르면 여러가지 동작이나 다수의 다른 위젯을 실행하도록 하는 Action Bar 위젯, 그리고 이 모든 것을 GameHUD 위젯에서 합치면 그러한 개별 조각들을 필요에 따라 껐다 켰다 토글시킬 수 있습니다 (하나의 위젯 블루프린트에서 모두 만들었을 때는 힘들 것입니다).

실험단계

ExperimentalPalette.png

개발 초기 단계로 간주되는 위젯으로, 접근을 위해서는 플러그인 메뉴 Widgets 아래에서 활성화시켜야 합니다.

옵션

설명

Web Browser

이 위젯은 웹상의 콘텐츠를 표시할 수 있는 게임내 웹 브라우저를 표시하는 데 사용됩니다.

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback