Table of Contents

Block 데이터 컴포넌트

이 매뉴얼은 Unity 편집기에서 Block 데이터 컴포넌트가 제공하는 컨트롤 기능과 사용 방법을 상세히 설명합니다.

버전 설명

자체 구축 버전 9.4부터 Block Mesh 데이터 형식이 eme에서 gltfx로 업그레이드되었습니다.

문서 내 모든 새 형식만 지원하는 기능은 [>=9.4]로 표시됩니다. 데이터 버전이 9.4 미만인 경우 관련 UI 컨트롤은 작동하지 않습니다.

문서 내 모든 이전 형식만 지원하는 기능은 [<9.4]로 표시됩니다. 데이터 버전이 9.4 이상인 경우 관련 UI 컨트롤은 작동하지 않습니다.

초기 상태

컴포넌트 초기 상태는 도구가 막 생성되어 아무 서비스를 선택하지 않고 데이터도 로드되지 않은 상태에서의 Block 데이터 컴포넌트 상태를 의미합니다.

초기 상태1

어노테이션 툴 및 Unity 개발자를 위한 Block 뷰어의 Block 데이터 컴포넌트.

번호 컨트롤 이름 컨트롤 유형 기능 설명
1 전역 좌표계 옵션 드롭다운 메뉴 씬 좌표계와 Block이 가진 GNSS 데이터의 정렬 로직 설정:
GPS (기본값) : GNSS 데이터를 사용해 Block을 자동 정렬. 이때 Block은 Block 루트 노드에 상대적으로 이동 불가.
None : GNSS 데이터를 사용해 Block을 정렬하지 않음. 이때 Block은 Block 루트 노드에 상대적으로 이동 가능.
2 루트 노드 선택 선택기 씬 내 BlockRootController 컴포넌트가 있는 노드를 루트 노드로 선택.
3 새 루트 노드 버튼 새로운 Block 루트 노드를 생성하고 이를 루트 노드로 설정. 이미 로드된 Block은 자동 삭제됨.
4 캐시 파일 비우기 버튼 로컬에 캐시된 모든 Block 데이터를 비움.

초기 상태2

Block 뷰어의 Block 데이터 컴포넌트

번호 컨트롤 이름 컨트롤 유형 기능 설명
5 로컬 Block 로드 버튼 로컬의 .eme 또는 .gltfx 확장자를 가진 Block 로드.
6 초기화 버튼 현재 Block 컴포넌트를 초기 상태로 복원.

서비스 선택 상태

컴포넌트 서비스 선택 상태는 도구에서 서비스(Mega Block 위치 서비스, Mega Block 저장 서비스 등)를 하나 선택한 후의 Block 데이터 컴포넌트 상태입니다.

서비스 선택

번호 컨트롤 이름 컨트롤 유형 기능 설명
7 Block 목록 새로고침 버튼 현재 Block 도구의 정보를 새로고침하여 클라우드 서비스 데이터와 동기화.
8 레이캐스트 정확도 선택 드롭다운 메뉴 [>=9.4]Block의 Mesh가 레이캐스트에 사용될 때의 모델 정확도 설정. 정확도 낮춤으로 편집기 내 LOD 로드 속도 향상, 대신 편집 정확도 희생:
Min LOD (기본값) : 최소 모델로 레이캐스트 수행.
None : 충돌 모델을 로드하지 않고 레이캐스트 수행 안 함.
Match LOD : LOD에 따라 충돌 모델 로드.
9 Mesh 분할 표시 토글 [>=9.4]체크 시 씬에 Mesh 분할 표시가 나타남.
10 Block 노드 선택 버튼 씬 내 BlockController 컴포넌트가 있는 노드를 Block 노드로 선택.
11 버전 텍스트 해당 Block의 버전.
12 Block 내보내기 버튼 [>=9.4]내보내기 메뉴 팝업.
[<9.4]내보내기 디렉터리 선택 후 obj 형식 모델 파일로 내보냄.
13 Block 로드 버튼 씬에 Mesh 로드.

내보내기 메뉴[>=9.4]

새 버전의 내보내기 메뉴에서는 내보내기 계층, 텍스처 내보내기 여부, 파일 형식 등 내보내기 설정을 수정할 수 있습니다.

내보내기 메뉴

번호 컨트롤 이름 컨트롤 유형 기능 설명
20 계층 선택 체크박스 내보낼 모델 LOD 정확도 선택. 파일 병합 미체크 시 다중 선택 가능, 체크 시 단일 선택만 가능.
21 원본 파일 내보내기 토글 원본 gltfx 형식으로 내보냄.
22 텍스처 내보내기 토글 모델 텍스처 내보내기 여부.
23 파일 형식 라디오 버튼 내보낼 단일 파일 형식을 glb 또는 gltf로 전환.
24 파일 병합 토글 내보내기 시 해당 계층의 모든 분할 병합.
25 내보내기 버튼 내보내기 경로 선택 후 내보내기 시작.

내보내기 진행률

12 Block 내보내기[<9.4] 또는 25 내보내기 클릭 후 나타나는 진행률 표시줄로 현재 내보내기 상태를 확인합니다.

내보내기 진행률

번호 컨트롤 이름 컨트롤 유형 기능 설명
26 내보내기 진행률 진행률 표시줄 경로 선택 후 내보내기 시 표시되는 내보내기 진행률 표시줄, 100% 도달 시 완료.

로드 진행률[<9.4]

13 Block 로드 버튼 클릭 후 나타나는 진행률 표시줄로 현재 다운로드 및/또는 로드 상태를 확인합니다.

로드 진행률

번호 컨트롤 이름 컨트롤 유형 기능 설명
27 다운로드 진행률 진행률 표시줄 Block 데이터 다운로드 진행률 표시줄, 100% 도달 시 로드 트리거.
28 로드 진행률 진행률 표시줄 Block 데이터 로드 진행률 표시줄, 100% 도달 시 완료.

모델 로드 상태

컴포넌트 모델 로드 상태는 13 Block 로드를 클릭해 최소 하나의 Block Mesh를 로드한 후의 Block 데이터 컴포넌트 상태입니다.

번호 컨트롤 이름 컨트롤 유형 기능 설명
5 로컬 Block 로드 버튼 로컬의 .eme 또는 .gltfx 확장자를 가진 Block 로드.
6 초기화 버튼 현재 Block 컴포넌트를 초기 상태로 복원.

파노라마 마커 미로드 상태

최소 하나의 Block Mesh는 로드되었으나 파노라마 마커는 로드되지 않은 상태의 Block 데이터 컴포넌트 상태입니다.

파노라마 미로드

번호 컨트롤 이름 컨트롤 유형 기능 설명
14 숨기기/표시 버튼 씬의 Block Mesh 숨기기/표시.
15 Block 삭제 버튼 현재 로드된 Block 삭제.
16 해상도 마커 텍스트 HD는 고화질 파노라마; SD는 표준화질 파노라마.
17 파노라마 마커 로드 버튼 현재 씬에 파노라마 마커인 노란색 구체 표시를 로드.

파노라마 마커 로드 상태

최소 하나의 Block Mesh가 로드되고 17 파노라마 마커 로드를 클릭하여 파노라마 마커가 로드된 상태의 Block 데이터 컴포넌트 상태입니다.

이 상태에서는 해당 Block에 연결된 파노라마 표시를 표시, 숨기기, 삭제하고 파노라마 창을 로드할 수 있습니다.

파노라마 로드

번호 컨트롤 이름 컨트롤 유형 기능 설명
18 숨기기/표시 버튼 씬의 파노라마 마커 구체 숨기기/표시.
19 파노라마 마커 삭제 버튼 현재 로드된 파노라마 마커 삭제.

씬 내 컨트롤

Unity 편집기의 SceneView에는 Block 데이터 컴포넌트가 생성한 일부 컨트롤이 존재합니다.

LOD 분할 표시[>=9.4]

9.4 이상 버전 도구에서 9 Mesh 분할 표시를 켠 후 표시되는 식별자로 LOD 분할, 계층 및 상태를 표시합니다.

LOD 분할 표시

번호 컨트롤 이름 컨트롤 유형 기능 설명
29 분할 LOD 표시 Gizmo 분할 표시. LOD 로드 후 계층과 상태에 따라 다른 색상 표시:
파란색 : Min 계층, 최저 정확도.
하늘색 : Medium 계층, 중간 정확도.
초록색 : Max 계층, 최고 정확도.
빨간색 : 로드 중 오류 발생(재시도 중).
노란색 : 로드 중.

LOD 로드 표시[>=9.4]

LOD 로드 표시는 LOD 전환 시에만 나타나는 회전하는 UI 컨트롤입니다.

LOD 로드 표시

번호 컨트롤 이름 컨트롤 유형 기능 설명
30 LOD 로드 표시 UI 표시될 경우 LOD 로드 진행 중임을 의미.

파노라마 마커

파노라마 마커는 Block Mesh 로드 후 17 파노라마 마커 로드를 클릭하면 씬에 나타나는 마커로 파노라마 미리보기가 가능한 위치를 표시합니다.

파노라마 마커

번호 컨트롤 이름 컨트롤 유형 기능 설명
31 파노라마 마커 상호작용 가능 오브젝트 해당 위치에서 파노라마 미리보기가 가능함을 나타내는 노란색 구체 표시.

파노라마 창

파노라마 창은 Block Mesh와 파노라마 표시를 로드한 후 31 파노라마 마커를 클릭하면 나타나는 창으로, 파노라마 미리보기 및 콘텐츠 편집이 가능합니다.

파노라마 창

번호 컨트롤 이름 컨트롤 유형 기능 설명
32 파노라마 창 SceneView 파노라마 미리보기가 가능한 창.