Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

편집기 실행하기

이 문서에서는 Godot 편집기와 테마 편집기 도구를 사용하여 UI 테마를 만들고 관리하는 방법을 설명합니다. 시작하기 전에 :ref:`doc_gui_skinning`를 읽어 GUI 스키닝/테마 설정의 기본 사항을 익히는 것이 좋습니다.

테마 편집기는 편집을 위해 Theme 리소스를 선택할 때 자동으로 활성화되는 하단 패널 도구입니다. 테마 유형과 테마 항목을 추가, 제거, 조정하는 데 필요한 UI가 포함되어 있습니다. 변경 사항을 실시간으로 테스트하기 위한 미리보기 섹션과 테마 항목의 대량 작업을 수행하기 위한 창 대화 상자가 있습니다.

테마 만들기

다른 리소스와 마찬가지로 마우스 오른쪽 버튼을 클릭하고 **새 리소스...**를 선택한 다음 **테마**를 선택하고 **만들기**를 클릭하여 파일 시스템 도크에서 직접 테마를 만들 수 있습니다. 이는 프로젝트 전체 테마를 만드는 데 특히 유용합니다.

테마는 노드 컨트롤에서도 생성할 수 있습니다. 씬 계층 구조에서 컨트롤 노드를 선택한 다음 검사기에서 theme 속성으로 이동합니다. 여기에서 **새 테마**를 선택할 수 있습니다.

그러면 빈 테마가 생성되고 테마 편집기가 열립니다. 이런 방식으로 생성된 리소스는 기본적으로 씬와 함께 번들로 제공됩니다. 대신 상황에 맞는 메뉴를 사용하여 새 테마를 파일에 저장하세요.

테마 편집기는 테마 유형 및 항목을 관리하는 도구를 제공하지만 테마에는 인스펙터 독를 사용해서만 편집할 수 있는 기본 대체 글꼴도 포함되어 있습니다. StyleBoxes 및 아이콘과 같은 복잡한 리소스 유형의 콘텐츠에도 동일하게 적용되며 편집을 위해 인스펙터에서 열립니다.

편집기

테마 편집기에는 두 가지 주요 부분이 있습니다. Godot 편집기 하단에 위치한 메인 테마 편집기는 사용자에게 테마 항목과 유형을 빠르게 생성, 편집, 삭제할 수 있는 도구를 제공하는 것을 목표로 합니다. 컨트롤을 선택하고 변경하고 기본 테마 개념을 추상화하기 위한 시각적 도구를 제공합니다. 반면에 테마 항목 관리 대화 상자는 테마를 수동으로 변경하려는 사용자의 요구 사항을 해결하려고 합니다. 새로운 편집기 테마를 만드는 데에도 유용합니다.

테마 미리보기

메인 편집기의 왼쪽에는 미리보기 탭 세트가 있습니다. 기본 미리보기 탭은 기본적으로 표시되며 다양한 상태에서 자주 사용되는 대부분의 컨트롤을 포함합니다. 미리보기는 대화형이므로 중간 상태(예: 호버)도 미리볼 수 있습니다.

프로젝트의 임의 장면에서 추가 탭을 만들 수 있습니다. 미리보기로 작동하려면 씬에 컨트롤 노드가 루트로 있어야 합니다. 새 탭을 추가하려면 미리보기 추가 버튼을 클릭하고 파일 시스템에서 저장된 씬을 선택하세요.

씬을 변경하면 미리보기에 자동으로 반영되지 않습니다. 미리보기를 업데이트하려면 도구 모음에서 다시 로드 버튼을 클릭하세요.

미리보기를 사용하여 편집할 테마 유형을 빠르게 선택할 수도 있습니다. 도구 모음에서 선택 도구를 선택하고 미리보기 영역 위에 마우스를 올려 노드 컨트롤을 강조 표시합니다. 강조 표시된 컨트롤 노드는 클래스 이름 또는 가능한 경우 유형 변형을 표시합니다. 강조 표시된 컨트롤을 클릭하면 편집할 수 있도록 오른쪽에 컨트롤이 열립니다.

테마 유형 및 항목

테마 편집기의 오른쪽에는 편집된 테마 리소스에서 사용할 수 있는 테마 유형 목록과 선택한 유형의 콘텐츠가 제공됩니다. 유형의 항목 목록은 테마에서 사용할 수 있는 각 데이터 유형(색상, 상수, 스타일 등)에 해당하는 여러 탭으로 나뉩니다. 기본값 표시 옵션이 활성화된 경우 각 내장 유형에 대해 기본 테마 값이 회색으로 표시됩니다. 해당 옵션이 비활성화된 경우 편집된 테마 자체에서 사용 가능한 항목만 표시됩니다.

항목 옆에 있는 재정의 버튼을 클릭하면 기본 테마의 개별 항목을 현재 테마에 추가할 수 있습니다. 모두 재정의 버튼을 클릭하여 선택한 테마 유형의 모든 기본 항목을 재정의할 수도 있습니다. 그런 다음 항목 제거 버튼을 사용하여 재정의된 속성을 제거할 수 있습니다. 항목 이름 바꾸기 버튼을 사용하여 속성 이름을 바꿀 수도 있으며, 아래 텍스트 필드를 사용하여 완전히 사용자 지정 속성을 목록에 추가할 수도 있습니다.

재정의된 테마 항목은 리소스가 아닌 이상 오른쪽 패널에서 직접 편집할 수 있습니다. 리소스에는 사용할 수 있는 기본적인 제어 기능이 있지만 대신 인스펙터 독에서 편집해야 합니다.

스타일 상자에는 목록에서 개별 스타일 상자를 고정할 수 있는 고유한 기능이 있습니다. 고정된 스타일박스는 팩의 리더 역할을 하며, 속성을 변경할 때 동일한 유형의 모든 스타일박스가 함께 업데이트됩니다. 이를 통해 여러 스타일 상자의 속성을 동시에 편집할 수 있습니다.

테마 유형은 미리보기에서 선택할 수 있지만 수동으로 추가할 수도 있습니다. 유형 목록 옆에 있는 더하기 버튼을 클릭하면 항목 유형 추가 메뉴가 열립니다. 해당 메뉴의 목록에서 유형을 선택하거나 임의의 이름을 입력하여 사용자 정의 유형을 만들 수 있습니다. 텍스트 필드는 컨트롤 노드 목록도 필터링합니다.

항목 관리와 가져오기

항목 관리 버튼을 클릭하면 테마 항목 관리 대화 상자가 나타납니다.

항목 편집 탭에서는 테마 유형을 보고 추가할 수 있을 뿐만 아니라 선택한 유형의 테마 항목을 보고 편집할 수도 있습니다.

여기에서 해당 **X 항목 추가**를 클릭하고 이름을 지정하여 개별 테마 항목을 생성, 이름 변경 및 제거할 수 있습니다. 데이터 유형(목록의 브러시 아이콘 사용) 또는 품질별로 테마 항목을 대량 삭제할 수도 있습니다. **클래스 항목 제거**는 컨트롤 노드 유형에 대해 사용자 정의한 모든 내장 테마 항목을 제거합니다. **사용자 정의 항목 제거**는 선택한 유형에 대한 모든 사용자 정의 테마 항목을 제거합니다. 마지막으로 **Remove All Items**는 유형에서 모든 항목을 제거합니다.

항목 가져오기 탭에서 다른 테마의 테마 항목을 가져올 수 있습니다. 기본 Godot 테마, Godot 편집기 테마 또는 다른 사용자 정의 테마에서 항목을 가져올 수 있습니다. 개별 항목 또는 여러 항목을 가져올 수 있으며 해당 데이터를 복사할지 또는 생략할지 결정할 수도 있습니다. 수동, 계층 구조, 데이터 유형 등 모든 항목을 포함하여 항목을 선택하고 선택 취소할 수 있는 여러 가지 방법이 있습니다. 데이터를 포함하도록 선택하면 모든 테마 항목이 테마에 그대로 복사됩니다. 데이터를 생략하면 해당 데이터 유형과 이름의 항목이 생성되지만 비워 두어 일종의 테마 템플릿이 생성됩니다.