위젯 유형 레퍼런스

언리얼 모션 그래픽, 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

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

새로운 언리얼 엔진 4 문서 사이트에 오신 것을 환영합니다!

문서 사이트에 대한 의견을 모을 수 있는 피드백 시스템을 포함해서 여러가지 새로운 기능을 준비하고 있습니다. 아래 Documentation Feedback 포럼(영문) 또는 언리얼 엔진 네이버 공식 카페(한글) 중 편하신 곳에 의견이나 문제점을 알려 주세요.

새 시스템이 준비되면 알려 드리겠습니다.

네이버 카페
공식 포럼