AMapper Wiki

Welcome

AMapper 위키에 오신 것을 환영합니다.

Contact

dl_ar@naverlabs.com

1. 둘러보기

1.1 AMapper 란?

소개

AMapper는 NAVERLABS의 Vision 그룹 Augmented Reality 팀에서 개발한 지도/AR 통합 저작 툴입니다.

복잡한 사전 지식이 없어도 고품질의 저작이 가능한 가볍고 빠른 툴을 목표로 하고 있습니다.

AMapper로 할 수 있는 일

실내/실외 지도 작성

• AMapper는 복잡한 사전 지식이 없어도 쉽게 실내/실외의 지도를 작성할 수 있는 툴입니다.
• 직관적인 드로잉 인터페이스를 지원하며, 복잡한 형태도 손쉽게 그릴 수 있습니다.
• 포인트 클라우드/거리 뷰 등 다양한 레퍼런스를 이용하여 정확한 작도가 가능합니다.
• POI/루트 등의 지리 정보를 작도한 도형과 연결이 가능하며, 대규모 데이터 관리 툴을 제공합니다.

AR 저작

• 작성한 지도 위에 사용자 3D 모델을 손쉽게 배치할 수 있습니다.
• 바로 사용이 가능한 3D 템플릿 모델을 내장하고 있습니다.
• AR 앱 개발에 필요한 정제된 설정을 내장하고 있습니다.
• AMapper 프로젝트 포맷인 *.amproj는 ARCeyeVLSDK 와 연동하여 모바일 환경에서 손쉽게 AR 앱을 개발할 수 있습니다.

스크린샷

1.2 AMapper 살펴보기

화면 구성

1. 씬
2. 하이어라키, 테이블 뷰
3. 에디터블, 히스토리
4. 메세지
5. 에셋
6. 메뉴 바
7. 툴바
8. 상태 바

씬 Scene

• 화면 중앙에 위치하여 지도와 AR 객체가 렌더링되며, 저작할 수 있는 3D 공간입니다.

윈도우

공통 사항

• 윈도우는 도킹 패널이나 다른 윈도우에 drag and drop으로 도킹하거나 해제할 수 있습니다.
• AMapper의 좌측/우측/하단에 기본 도킹 패널을 제공합니다.
  • 도킹 패널의 가장자리를 드래그하여 크기를 조절할 수 있습니다.
• 데스크탑 버전의 경우 AMapper 전체 창 바깥으로 윈도우를 이동하면, 별도의 창이 생성됩니다.
  • 모니터를 여러 대 사용 할 때 편리합니다.
  • 자세한 내용은 하단의 윈도우 메뉴 항목을 참조하세요.

하이어라키 Hierarchy

• 화면 좌측에 위치하여 프로젝트의 계층 구조를 보여주는 윈도우입니다.

• 검색 창

• 스테이지 생성
• 스테이지
• 스테이지 삭제
• 레이어 생성
• 스테이지 보임/숨김
• 레이어
• 레이어 삭제
• 레이어 색상
• 레이어 보임/숨김
• 아이템
• 아이템 경고
• 아이템 보임/숨김

테이블 Table

• 대규모 프로젝트에서 아이템을 테이블 형태로 보면서 쉽게 데이터를 비교하고 고칠 수 있습니다.
  • 자세한 내용은 테이블 뷰 항목을 참조하세요.

에디터블 Editable

• 화면 우측에 위치하여 선택한 객체의 속성을 편집할 수 있는 윈도우입니다.
  • 개별 객체의 속성은 각각의 항목에서 따로 설명합니다.

히스토리 History

• 화면 우측에 위치하여 명령을 실행하기 전으로 돌아가거나 되돌릴 수 있습니다 (Undo/Redo).
• 실행하였던 명령이 순서대로 리스팅됩니다.
  • 명령을 클릭하면 실행하기 전 시점으로 돌아갑니다. 이후로 실행된 명령은 흐리게 나타납니다.
  • 흐리게 나타나는 명령을 클릭하여 원하는 시점으로 되돌릴 수도 있습니다.
  • 따로 윈도우에서 클릭하지 않아도 Undo/Redo단축키를 이용하여 쉽게 가능합니다.

에셋 Asset

• 화면 우측 하단에 위치하여 프로젝트 외부에서 가져온 에셋을 관리하는 윈도우입니다.
  • 자세한 내용은 에셋 항목을 참조하세요.

메세지 Message

• 각종 로그 메세지가 기록됩니다.

• 검색

• 클립보드로 복사
• 모두 비우기

메뉴 바 Menu bar

파일 File

• 새 프로젝트 New (Ctrl + N or CMD + N)
  • 실행하면, 즉시 새 프로젝트를 시작합니다.
• 열기 Open (Ctrl + O or CMD + O)
  • 실행하면, 파일 탐색기가 열립니다.
    • 원하는 프로젝트 파일 (*.amproj)를 선택하면 프로젝트가 열립니다.
• 최근 프로젝트 열기 Open Recent
  • 최근에 열었던 프로젝트가 리스팅 됩니다.
  • 클릭하면 프로젝트를 열 수 있습니다.
• 저장하기 Save (Ctrl + S or CMD + S)
  • 실행하면 프로젝트를 저장합니다.
    • 새 프로젝트일 경우 파일 탐색기가 열립니다.
      • 원하는 경로를 지정하면 프로젝트가 저장됩니다.
• 다른 이름으로 저장하기 Save as.. (Ctrl + Shift + S or CMD + Shift + S)
  • 실행하면 파일 탐색기가 열리고, 원하는 경로를 지정하면 프로젝트가 저장됩니다.
• 가져오기 Import
  • 프로젝트 Project
    • 자세한 내용은 다른 프로젝트 가져오기 항목을 참조하세요.
  • GeoJSON
    • 자세한 내용은 GeoJSON 가져오기 항목을 참조하세요.
• 내보내기 Export
  • GeoJSON
    • 자세한 내용은 GeoJSON으로 내보내기 항목을 참조하세요.
  • 3D Format
    • 자세한 내용은 GLTF로 내보내기 항목을 참조하세요.

편집 Edit

• 명령 취소 Undo (Ctrl + Z or Cmd + Z)
  • 최근 하나의 명령을 취소할 수 있습니다.
• 명령 재실행 Redo (Ctrl + Y or Cmd + Y)
  • 최근 하나의 명령을 재실행 할 수 있습니다.
• 복사하기 Copy (Ctrl + C or Cmd + C)
  • 선택한 객체를 클립보드로 복사합니다.
• 잘라내기 Cut (Ctrl + X or Cmd + X)
  • 선택한 객체를 클립보드로 복사하고 동시에 제거합니다.
• 붙여넣기 Paste (Ctrl + V or Cmd + V)
  • 클립보드에 있는 객체의 복사본을 붙여넣습니다.
    • 일부 객체는 복사가 불가능합니다.

뷰 View

• 스크린 Screen

  • 원근 Perspective, 직교 Top, 정면, 측면 Right 스크린을 각각 설정할 수 있습니다.
  • 배경 색 Skybox Color
    • 화면의 배경 색을 지정합니다.
  • 그리드 색상 Grid Color
    • 그리드 라인 색상을 지정합니다.
  • 그리드 숨기기 Hide Grid
    • 그리드를 숨길 수 있습니다.

• 모든 그리드 숨기기 Hide All Grids

  • 모든 그리드를 숨길 수 있습니다.

• 스테이지 Stage

  • 비활성화 스테이지 투명도 Off-screen Opacity
    • 비활성화 스테이지는 현재 편집중인 스테이지를 제외한 나머지를 의미하는데, 그 투명도를 조절하는 옵션입니다.
    • 대규모 프로젝트에서는 아주 많은 스테이지가 존재할 수 있으며, 각 스테이지가 포함하는 객체들 때문에 편집에 방해가 될 수 있습니다. 이런 경우에 옵션을 조절하여 시인성을 개선할 수 있습니다.
    • 직접 리스팅 된 수치를 클릭하거나 Increase, Decrease를 클릭하여 단계를 조절할 수 있습니다.

• 도형 Shape

  • 도형 채움 투명도 Shape Fill Opacity
    • 도형 객체를 생성하면, 면에 색상이 부여되는데, 그 색상의 투명도를 조절하는 옵션입니다.
    • 대규모 프로젝트에서는 도형 객체들이 너무 많이 겹쳐 구분이 어려울 수 있습니다. 또는, 구역의 특성에 따라 오히려 투명도가 적은 편이 구분이 쉬울 수도 있습니다. 이런 경우에 옵션을 조절하여 시인성을 개선할 수 있습니다.
    • 직접 리스팅 된 수치를 클릭하거나 Increase, Decrease를 클릭하여 단계를 조절할 수 있습니다.

• 라벨 Label

  • 사이즈 Size
    • POI의 글꼴 사이즈를 조절하는 옵션입니다.
    • 대규모 프로젝트에서 POI가 너무 많이 겹쳐 편집을 방해할 수 있습니다. 또는, 큰 사이즈의 모니터에서 작업 시에 글꼴이 너무 작아 보일 수 있습니다. 이런 경우에 옵션을 조절하여 시인성을 개선할 수 있습니다.
    • 직접 리스팅 된 수치를 클릭하거나 Increase, Decrease를 클릭하여 단계를 조절할 수 있습니다.

• 안티앨리어싱 Anti-aliasing

  • 계단 현상을 제거하여 씬의 렌더링 품질을 개선하는 옵션입니다.
  • FXAA
    • 활성화 시, FXAA(Fast Approximate Anti-Aliasing)을 적용합니다.
    • 성능 저하가 거의 없이 렌더링 품질을 향상시킬 수 있지만, 글꼴 등 일부 요소가 주위 픽셀에 오염되어 흐릿해지는 단점이 있습니다.
  • MSAA
    • 활성화 시, MSAA(Multi Sampling Anti-Aliasing)을 적용합니다.
    • 부작용이 없이 렌더링 품질을 향상시킬 수 있지만, 대규모 프로젝트에서 성능 저하가 일어날 수 있습니다.
    • 필요한 경우 시스템 사양과 타협하여 단계를 조절합니다.

에셋 Asset

• 하위에 다음의 항목이 있습니다.
  • 에셋 파일 가져오기 Import Asset File(s)
  • 에셋 폴더 가져오기 Import Asset Folder
  • 자세한 내용은 에셋 항목을 참조하세요.

툴 Tools

• WIP

윈도우 Window

• 윈도우를 토글 할 수 있습니다.
  • 하이어라키 Hierarchy
  • 테이블 Table
  • 히스토리 History
  • 메세지 Message
  • 에셋 Asset
  • 거리 뷰어 Street Viewer
  • Visual FSM

툴바 Toolbar

• 중앙 상단, 씬 바로 윗 부분에 존재하는 검은 바입니다. 뷰 관련 설정/저작 모드/편의 기능을 토글 할 수 있습니다.
  • 항목은 왼쪽부터 순서대로 입니다.

뷰 설정

1. 원근 뷰 1-View Layout (Persp)
   • 단축키는 Windows 에서 Ctrl + 1, macOS에서 Command + 1 입니다.
2. 직교 뷰 1-View Layout (Top)
   • 단축키는 Windows 에서 Ctrl + 2, macOS에서 Command + 2 입니다.
3. 2분할 원근/직교 뷰 2-View Layout (Persp/Top)
   • 단축키는 Windows 에서 Ctrl + 3, macOS에서 Command + 3 입니다.
4. 3분할 원근/직교/정면 뷰 3-View Layout (Persp/Top/Front)
   • 단축키는 Windows 에서 Ctrl + 4, macOS에서 Command + 4 입니다.
5. 4분할 원근/직교/정면/측면 뷰 4-View Layout (Persp/Top/Front/Side)
   • 단축키는 Windows 에서 Ctrl + 5, macOS에서 Command + 5 입니다.

모드 설정

6. 네비게이션 모드 Navigation Mode (A)
   • 기본 모드입니다.
   • 카메라를 자유롭게 조작하여 씬을 탐색할 수 있습니다.
   • 아이템을 선택하고 조작할 수 있습니다.
7. 링크 모드 Link Mode (C)
   • 객체끼리 연결하거나 해제할 수 있습니다.
     • 서로 연결이 가능한 객체의 종류는 정해져 있습니다.
     • 자세한 내용은 객체 간 연결 항목을 참조하세요.
8. 자유 다각형 그리기 모드 Polygon Drawing Mode (P)
   • 자유롭게 다각형을 그려 도형 객체를 생성합니다.
     • 자세한 내용은 도형 항목을 참조하세요.
9. 사각형 그리기 모드 Rectangle Drawing Mode (M)
   • 사각형을 그려 도형 객체를 생성합니다.
     • 자세한 내용은 도형 항목을 참조하세요.
10. 타원 그리기 모드 Ellipse Drawing Mode (O)
    • 타원을 그려 도형 객체를 생성합니다.
      • 자세한 내용은 도형 항목을 참조하세요.
11. 다각형 수정 모드 Polygon Editing Mode (V)
    • 이미 생성된 도형 객체를 수정합니다.
      • 정점을 생성하거나 삭제할 수 있고, 이동할 수도 있습니다.
      • 자세한 내용은 도형 항목을 참조하세요.
12. POI 스탬핑 모드 POI Stamping Mode (T)
    • 원하는 위치에 POI를 생성합니다.
      • 자세한 내용은 POI 항목을 참조하세요.
13. 그래프 그리기 모드 Graph Drawing Mode (N)
    • 그래프를 그려 그래프 노드와 그래프 엣지를 생성합니다.
      • 그래프 노드와 그래프 엣지는 길찾기 알고리즘에 사용됩니다.
      • 자세한 내용은 그래프 항목을 참조하세요.
14. 라벨링 모드 Labeling Mode (L)
    • WIP
15. 패널 스탬핑 모드 Labeling Mode (K)
    • WIP
16. 길찾기 모드 (I)
    • 시작점과 도착점을 지정하여 길찾기를 실행하고 결과를 시각화합니다.
    • 동작을 위해서는 바르게 연결된 그래프가 필요합니다.
      • 자세한 내용은 그래프 항목과 길찾기 모드 항목을 참조하세요.

도우미 옵션

17. 레이어 고정 선택 토글 Layer-Locked Selection Toggle (\)
    • 꺼진 상태에서 현재 레이어에 포함된 객체만 선택할 수 있습니다.
    • 켜진 상태에서 현재 레이어와 상관 없이 모든 객체를 선택할 수 있습니다.
      • 복잡한 씬을 탐색할 때 상황에 맞추어 이용할 수 있습니다.
18. 스테이지 고정 렌더링 토글 Stage-Locked Rendering Toggle (`)
    • 꺼진 상태에서 모든 스테이지를 렌더링 합니다.
    • 켜진 상태에서 현재 선택된 스테이지만 렌더링 합니다.
      • 복잡한 씬을 탐색할 때 상황에 맞추어 이용할 수 있습니다.
19. 측정 도우미 토글 Measuring Helper Toggle (')
    • 켜진 상태에서 마우스 커서에 위치가 표시됩니다.
    • 오른쪽의 편집 창에서 위치 양식을 설정할 수 있습니다.

상태 바 Status Bar

• 화면 우측 하단에 위치한 부분입니다.
• 전체 레이어를 대상으로 가시성을 설정할 수 있는 아이콘들이 있습니다.
  • 항목은 왼쪽부터 순서대로 다음과 같습니다.
    • 오브젝트 레이어 (1)
    • 레퍼런스 레이어 (2)
    • 셰이프 레이어 (3)
    • 심볼 레이어 (4)
    • 루트 레이어 (5)
    • 애로우 레이어 (6)
    • 어노테이션 레이어 (6)
    • 레이어 타입에 대한 자세한 정보는 레이어 항목을 참조하세요.
  • 아이콘을 클릭하거나 아이콘 순서와 동일한 숫자키를 누르면 토글됩니다.
    • 예를 들어, 숫자키 1을 누르면 오브젝트 레이어를 토글합니다.
  • 아이콘이 밝은 상태이면 해당 레이어가 보이는 상태이며, 흐린 상태이면 보이지 않는 상태입니다.
  • 프로젝트가 커질 수록 여러 종류의 객체가 겹쳐 혼란을 주고 저작이 어려워 질 수 있습니다.
    • 그럴 때, 특정 레이어의 가시성을 토글하여 원하는 종류의 객체만 잘 보이도록 할 수 있습니다.

1.3 데이터 계층 구조 살펴보기

*.amproj

AMapper는 데이터를 *.amproj (AMapper PROJect) 확장자의 파일로 저장합니다.

amproj 파일은 표준 JSON 포맷을 준수하여 외부 프로젝트에서는 이를 직접 파싱하여 사용하거나, ARCeyeVLSDK에 연동하여 사용이 가능합니다.

프로젝트 Project

• 프로젝트는 amproj 포맷의 최상단 레벨의 객체입니다.
• 프로젝트 단위 설정과 스테이지 그룹/스테이지/에셋을 포함합니다.

스테이지 Stage

• 스테이지는 특정 지역 단위를 구분하는 객체입니다.
  • 예를 들면, 층 단위를 구분하는 객체로 사용할 수 있습니다.
• 스테이지 단위 설정과 레이어를 포함합니다.

스테이지 그룹 StageGroup

• 스테이지 그룹은 다른 스테이지 그룹이나 스테이지를 포함할 수 있습니다.
  • 파일 탐색기의 폴더와 비슷한 개념입니다.
• 규모가 큰 프로젝트를 관리할 때 사용합니다.
  • 예를 들면, 여러 고층 건물들이 포함된 프로젝트에서 건물 별로 스테이지 그룹을 만들고, 하위에 층별로 스테이지를 생성할 수 있습니다.

레이어 Layer

• 레이어는 스테이지를 구성하는 요소를 의미있는 구분 기준으로 나누어 관리하는 객체입니다.
  • 예를 들면, 스테이지 하위에 건물 형상을 포함한 레이어와 루트를 포함한 레이어와, 그리고 POI 포함한 레이어가 따로 존재합니다.
  • 레이어는 여러가지 타입이 있으며, 타입 별로 포함할 수 있는 아이템의 종류가 다릅니다.
• 레이어 단위 설정과 아이템을 포함합니다.

아이템 Item

• 아이템은 씬에 포함되고 선택 될 수 있는 객체입니다.
  • 사실은, 스테이지 또는 스테이지 그룹, 레이어도 특수한 아이템의 일종입니다.
• 주요 아이템의 예시는 다음과 같습니다.
  • Stage
  • StageGroup
  • Layer
  • GeometryItem
  • POIItem
  • GraphNodeItem
  • GraphEdgeItem

에셋 Asset

• 에셋은 외부 파일을 프로젝트에 사용할 수 있도록 관리하는 객체입니다.
  • 예를 들면, 외부의 포인트클라우드 파일이나 3D 모델 파일을 에셋으로 프로젝트에 포함하여 사용할 수 있습니다.
    • 포인트클라우드 에셋을 씬으로 내보내면 아이템이 생성되어 렌더링 됩니다.
• 에셋은 스테이지 그룹 -> 스테이지 -> 레이어 -> 아이템 으로 이어지는 계층 구조에 포함되지 않고, 프로젝트 하위에 독립적으로 존재합니다.
• 주요 에셋의 예시는 다음과 같습니다.
  • 포인트클라우드 (*.h5, *.pcd, *.ply)
  • 거리뷰 (*.sv)
  • 이미지 (*.png, *.jpg)
  • 3D 모델 (*.glb, *.gltf, *.obj)

1.4 기본 조작법

기본 조작법에 관하여

• 기본 컨트롤에 대한 설명은 네비게이션 모드에서 수행되는 것으로 가정합니다.
  • 탐색 모드는 카메라 조작, 객체 관리/편집 등 일반적인 작업을 할 수 있는 모드입니다.
    • AMapper 구동 시 탐색 모드로 시작합니다.
  • 탐색 모드는
    • 상단 툴바에서 Navgation Mode (A)를 클릭하거나,
    • 단축키 A를 누르거나,
    • ESC키를 눌러 다른 모드를 취소하면서 복귀할 수 있습니다.

카메라 조작

위치

• 마우스를 드래그하여 이동
  • 왼쪽 마우스 버튼을 누른 채로 드래그하여 카메라의 위치를 이동합니다.
• 특정 위치로 점프
  • 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 열 수 있습니다.
    • Camera -> Jump To..를 클릭합니다.
      • 원하는 위치 값을 입력하고 Confirm을 눌러 점프합니다.

각도

• 마우스를 드래그하여 조정
  • Ctrl 또는 CMD + 왼쪽 마우스 버튼을 누른 채로 드래그하여 카메라의 각도를 조정합니다.
• 리셋
  • 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 열 수 있습니다.
    • Camera -> Reset Yaw 또는 Camera -> Reset Pitch 항목을 클릭합니다.
      • 각각 Yaw 또는 Pitch 를 기본값으로 리셋합니다 (0도, 90도).

아이템 객체 조작

• 다음 설명하는 조작법은 대부분의 객체 타입에서 통용되는 방법을 요약한 것입니다.
• 객체 타입별로 특별한 조작법이 필요할 수 있습니다.
  • 특별한 조작법은 개별 항목에서 따로 설명합니다.

선택

• 클릭하여 선택

  • 아이템 객체를 클릭하여 선택합니다.
    • Shift키를 누른 채로 클릭하여 여러 아이템을 선택할 수 있습니다.
      • 동일한 종류의 아이템만 복수 선택이 가능합니다.

• 영역 내의 객체 선택

  • Space 키를 누른 채로 드래그 하여 직사각형 영역을 지정합니다.
    • 영역 내의 동일 종류 아이템이 선택 됩니다.

이동

• 드래그하여 이동

  • 아이템 객체를 드래그하여 이동합니다.

• 기즈모 Gizmo 활용

  • 일부 3D 객체 타입의 경우 선택 시 기즈모가 나타납니다.
  • 기즈모를 세 가지 형태로 변형할 수 있습니다.
    • 위치 Translation
      • 단축키 W를 눌러 변경합니다.
    • 회전 Rotation
      • 단축키 E를 눌러 변경합니다.
    • 크기 Scaling
      • 단축키 R를 눌러 변경합니다.
    • 단축키 Q를 눌러 기즈모를 숨깁니다.
  • 기즈모의 기준 도메인을 D키를 눌러 순환합니다.
    • 로컬 Local
    • 월드 World
    • 뷰 View

복제

• Ctrl + C or CMD + C로 선택한 아이템을 클립보드로 복사합니다.
• Ctrl + V or Cmd + V로 클립보드를 복제하여 붙여넣습니다.
• Ctrl + Shift + V or Ctrl + Shift + V로 원본과 동일한 위치에 복제하여 붙여넣습니다.

삭제

• BACKSPACE나 DELETE키를 눌러 선택한 객체를 삭제할 수 있습니다.

2. 객체

2.1 프로젝트

프로젝트 관리

저장

• 상단 메뉴에서 File -> Save 를 선택합니다.
• 단축키는 Windows에서 Ctrl + S, macOS에서 Command + S 입니다.

다른 이름으로 저장

• 상단 메뉴에서 File -> Save as.. 를 선택합니다.
• 단축키는 Windows에서 Ctrl + Shift + S, macOS에서 Cmd + Shift + S 입니다.

불러오기

• 상단 메뉴에서 File -> Load 를 선택합니다.
• 단축키는 Windows에서 Ctrl + L, macOS에서 Command + S 입니다.

프로젝트 속성

로케일 Locale

• 다국어 지원을 위한 설정입니다.
• 주 언어 Primary
  • 기본으로 사용할 언어를 설정합니다. 기본값은 ko_kr 입니다.
• 편집 가능한 언어 Editable Locales
  • 다국어 문자열 편집창에 표시할 언어를 설정합니다.
    • 예를 들면, POI의 라벨 항목은 다국으 문자열을 지원합니다.
    • 편집 시 불필요한 언어 항목을 숨겨 입력을 용이하게 하기 위한 목적입니다.
    • 기본 값은 ko_kr만 설정되어 있습니다.

AR

• 자세한 내용은 AR 저작하기 항목을 참조하십시오.

2.2 스테이지

스테이지란?

• 스테이지는 특정 지역 단위를 구분하는 객체입니다.
  • 예를 들면, 층 단위를 구분하는 객체로 사용할 수 있습니다.

스테이지 관리

생성

• 하이어라키 창에서 최상단의 + 버튼을 누르세요.
  • 팝업 창이 뜨면, 스테이지 이름을 입력하고 스테이지 템플릿을 선택합니다.
    • 기본 템플릿과 투어 템플릿이 제공됩니다.
    • 투어 템플릿은 AR 투어 모드 저작에 사용되는 특수한 템플릿입니다. 자세한 내용은 AR 저작 항목을 참조하십시오.

삭제

• 하이어라키 창에서 스테이지 우측에 있는 쓰레기통 버튼을 누르세요.
• 또는 스테이지를 선택한 후, BACKSPACE나 DELETE를 누르세요.
• 최소 하나의 스테이지는 존재하여야 합니다.

순서 정렬

• 하이어라키 창에서, 스테이지를 drag 하여 다른 스테이지의 위나 아래쪽에 drop하면 순서를 변경할 수 있습니다.

그룹화

• 하이어라키 창에서, 스테이지를 다른 스테이지에 drag and drop하면 스테이지 그룹이 생성됩니다.
• 스테이지 그룹에 스테이지 또는 다른 스테이지 그룹을 drag and drop하여 하위에 추가할 수 있습니다.

스테이지 속성

클립 범위 Clip Range

• 클립 범위는 일부 레퍼런스 아이템들이 렌더링 될 수 있는 높이의 범위를 지정합니다.
  • 예를 들어, 클립 범위가 0.5에서 4.0이라면, 스테이지 하위의 포인트 클라우드에서는 0.5m에서 4.0m까지의 점만 렌더링 됩니다.
• 바닥/천장의 노이즈를 제거하거나 고층 건물의 내부를 작도할 때 활용할 수 있습니다.

가상 높이 Elevation (Virtual)

• 가상 높이는 렌더링되는 스테이지의 높이를 설정합니다.
• 층별로 적절한 높이를 지정하면 복잡한 지역도 입체적으로 파악할 수 있습니다.

실제 높이 Height (Physical)

• 실제 높이는 물리적인 높이를 의미하며 AR에 활용될 수 있는 데이터입니다.
• 렌더링 시에는 영향이 없습니다.

AR

• AR 구성과 에셋을 설정할 수 있습니다.
  • 자세한 내용은 AR 저작하기 항목을 참조하십시오.

2.3 레이어

레이어란?

• 레이어는 스테이지를 구성하는 요소를 의미있는 구분 기준으로 나누어 관리하는 객체입니다.
  • 예를 들면, 스테이지 하위에 건물 형상을 포함한 레이어와 루트를 포함한 레이어와, 그리고 POI 포함한 레이어가 따로 존재합니다.
  • 레이어는 여러가지 타입이 있으며, 타입 별로 포함할 수 있는 아이템의 종류가 다릅니다.

레이어 타입

오브젝트 레이어 Object Layer

• 포함할 수 있는 아이템은 다음과 같습니다.
  • ModelItem
  • VideoARItem
  • AudioARItem

레퍼런스 레이어 Reference Layer

• 포함할 수 있는 아이템은 다음과 같습니다.
  • PointCloudItem
  • VectorMapItem
  • ImageItem

셰이프 레이어 Shape Layer

• 포함할 수 있는 아이템은 다음과 같습니다.
  • GeometryItem

심볼 레이어 Symbol Layer

• 포함할 수 있는 아이템은 다음과 같습니다.
  • POIItem

루트 레이어 Route Layer

• 포함할 수 있는 아이템은 다음과 같습니다.
  • GraphNodeItem
  • GraphEdgeItem

애로우 레이어 Arrow Layer

• 포함할 수 있는 아이템은 다음과 같습니다.
  • StreetViewItem

레이어 조작

생성

• 하이어라키 창에서 레이어를 추가 생성할 스테이지에서 + 버튼을 클릭하세요.

삭제

• 레이어를 선택 한 후, BACKSPACE 또는 DELETE 키를 누르세요.
• 또는, 하이어라키 창에서 레이어 우측에 있는 쓰레기통 버튼을 누르세요.
• 일부 기본 레이어는 삭제가 불가능합니다.

순서 변경

• 하이어라키 창에서 레이어를 드래그해서 순서를 변경하세요.

레이어 속성

용도 Usage

• 레이어에 특수한 목적을 지정할 때 사용합니다.
  • 다만, 모든 레이어 타입이 용도를 가지는 것은 아닙니다.
• 현재 용도를 따로 지정할 수 있는 레이어 타입과 세부 내역은 다음과 같습니다.
  • 셰이프 레이어를 Semantic Area 용도로 지정할 수 있습니다.
    • 자세한 내용은 AR 저작하기 항목을 참조하십시오.

스냅 레이어

• 스냅은 일부 그리기 모드/편집 모드에서 발생하며, 대상 도형 객체의 변이나 정점 근처로 마우스 포인터를 이동하였을 때 자석처럼 정확히 붙는 것을 의미합니다.
• 스냅 레이어 이외의 레이어에 속한 객체에는 스냅이 발생하지 않습니다.
• 스냅이 발생하는 모드에서는 화면 오른쪽 편집 창에서 변경이 가능합니다.
  • 또는, ] 나 [ 키를 눌러 즉시 스냅 레이어를 변경할 수 있습니다.

연결 대상 레이어

• 일부 스탬핑 모드에서 작동하며, 대상 도형 객체의 중점 근처로 마우스 포인터를 이동하면 연결 대상이 표시되고 클릭 시 객체간 연결이 확정되는 것을 의미합니다.
• 연결 대상 레이어 이외의 레이어에 속한 객체에는 스냅이 발생하지 않습니다.
• 연결 대상이 존재하는 모드에서는 화면 오른쪽 편집 창에서 변경이 가능합니다.
  • 또는, ] 나 [ 키를 눌러 즉시 연결 대상 레이어를 변경할 수 있습니다.

2.4 도형

도형이란?

• 지도에 지형이나 구조물의 형태를 표현하는 핵심 객체입니다.

도형 생성

사각형 그리기 모드

• 툴 바에서 Rectangle Drawing Mode (M)를 선택하거나, 단축키 M을 누릅니다.
• 처음 두 번의 마우스 왼쪽 버튼 클릭으로 변을 설정하고, 세 번째 클릭으로 사각형을 생성합니다.
• 다른 도형의 변이나 정점 근처에 마우스 커서를 움직이면 스냅이 일어납니다.
  • 스냅을 이용하면 사각형을 틈새 없이 그릴 수 있습니다.
  • 현재 스냅 레이어에 포함된 아이템에만 반응합니다. 자세한 내용은 스냅 레이어를 참조하세요.
• Shift키를 누르면 수평/수직 가이드가 나타납니다.
• ESC키를 눌러 그리기를 취소할 수 있습니다.

타원 그리기 모드

• 툴 바에서 Ellipse Drawing Mode (O)를 선택하거나, 단축키 O를 누릅니다.
• 처음 두 번의 마우스 왼쪽 버튼 클릭으로 변을 설정하고, 세 번째 클릭으로 타원을 생성합니다.
• 다른 도형의 변이나 정점 근처에 마우스 커서를 움직이면 스냅이 일어납니다.
  • 현재 스냅 레이어에 포함된 아이템에만 반응합니다. 자세한 내용은 스냅 레이어를 참조하세요.
• Shift키를 누르면 수평/수직 가이드가 나타납니다.
• ESC키를 눌러 그리기를 취소할 수 있습니다.

자유 폴리곤 그리기 모드

• 툴 바에서 Polygon Drawing Mode (P)를 선택하거나, 단축키 P를 누릅니다.
• 자유롭게 마우스를 클릭하여 정점을 생성하세요.
• 세 번째 정점 생성 이후에는 시작 위치 정점의 모양이 변하며, 그 정점을 클릭하면 폴리곤을 닫고 객체를 생성합니다.
• 또는 Enter키를 눌러 객체를 생성하세요.
• 다른 도형의 변이나 정점 근처에 마우스 커서를 움직이면 스냅이 일어납니다.
  • 스냅을 이용하면 도형을 틈새 없이 그릴 수 있습니다.
  • 현재 스냅 레이어에 포함된 아이템에만 반응합니다. 자세한 내용은 스냅 레이어를 참조하세요.
• Shift키를 누르면 수평/수직/대각 가이드가 나타납니다.
• ESC키를 눌러 그리기를 취소할 수 있습니다.

폴리곤 편집 모드

• 툴 바에서 Polygon Editing Mode (V)를 선택하거나, 단축키 V를 누릅니다.
• 정점이나 변을 Drag 하여 이동할 수 있습니다.
• 정점을 Drag 할 때,
  • 다른 도형의 변이나 정점 근처에 마우스 커서를 움직이면 스냅이 일어납니다.
    • 현재 스냅 레이어에 포함된 아이템에만 반응합니다. 자세한 내용은 스냅 레이어를 참조하세요.
  • Shift키를 누르면 스마트 가이드가 나타납니다.
• 변을 Drag 할 때,
  • Shift키를 누르면 수평/수직 가이드가 나타납니다.
• Windows에서 Alt, macOS에서 Option 키를 누르고
  • 정점을 클릭하면 정점을 삭제할 수 있습니다.
  • 변을 클릭하면 정점을 생성할 수 있습니다.
• ESC키를 눌러 편집을 취소할 수 있습니다.

도형 조작

선택

• 도형의 면을 클릭하면 선택할 수 있습니다.
• 여러 도형이 겹쳐있어 선택이 어려울 경우 Windows에서 Alt, macOS에서 Option 키를 누른 채로 면 대신 변을 클릭하여 선택할 수 있습니다.

이동

• 도형을 선택하고 Drag하여 이동할 수 있습니다.
• Shift키를 누르면 수직/수평 가이드가 나타납니다.

삭제

• Backspace키 또는 Delete키를 눌러 선택한 도형 객체를 삭제할 수 있습니다.

복제

• Windows에서는 Ctrl, macOS에서는 Command를 누른 채로 도형 객체를 drag 하면
  • drop 하는 위치에 복사본을 생성할 수 있습니다.
  • Shift 키를 누르면 수직/수평 가이드가 나타납니다.
• Windows에서는 Ctrl + C, macOS에서는 Command + C로
  • 선택한 도형 객체를 클립보드로 복사할 수 있습니다.
• Windows에서는 Ctrl + V, macOS에서는 Command + V로
  • 클립보드에 복사한 도형 객체들의 복사본을 생성할 수 있습니다.
• Windows에서는 Ctrl + Option + V, macOS에서는 Command + Option + V로
  • 클립보드에 복사한 도형 객체들의 복사본을 동일한 위치에 생성할 수 있습니다.

오퍼레이션

• 불 연산 Boolean Operation
  • 선택된 도형들에 불 연산을 적용하여 새로운 도형을 생성합니다.
    • 기존 선택된 도형들은 제거됩니다.
  • 씬에서 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 열 수 있습니다.
    • Boolean Operation 항목에 접근하면, 다음과 같은 연산을 실행할 수 있습니다.
      • 합 Union
        • 선택된 도형들을 합쳐 새로운 도형을 생성합니다.
      • 교차 Intersection
        • 선택된 도형들 간에 겹치는 부분을 새로운 도형으로 생성합니다.
      • 차 Difference
        • 처음 선택된 도형에서 나머지 도형들이 겹치지 않는 부분을 새로운 도형으로 생성합니다.
      • 대칭차 Symmetric Difference
        • 선택된 도형들 간에 겹치지 않는 부분을 새로운 도형으로 생성합니다.
    • 불 연산으로 생성된 도형 객체는 완전히 분리된 도형들의 집합이 될 수 있습니다.
      • 예를 들어, 겹치는 부분이 없는 두 직사각형 도형 객체를 합 연산 하면 겉보기로는 변화가 없습니다.
        • 하지만 데이터 상으로는 하나의 도형 객체가 되고 도형 타입은 다중 폴리곤으로 변경됩니다.
        • 다중 폴리곤 객체는 분리 Collapse를 실행하여 개별 도형 객체로 만들 수 있습니다.
• 정렬 Align
  • 선택된 도형들을 정렬합니다.
  • 씬에서 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 열 수 있습니다.
    • Align 항목에 접근하면, 다음과 같은 정렬을 실행할 수 있습니다.
      • 왼쪽 정렬 Left
      • 중앙 정렬 Center
      • 오른쪽 정렬 Right
      • 상단 정렬 Top
      • 중단 정렬 Middle
      • 하단 정렬 Bottom
• 분할 연산 Division Operation
  • 도형 객체들 중, 변이 4개인 객체들에 한하여 마주보는 변의 중점을 기준으로 분할합니다.
    • 직각으로 구획화된 지역을 작도할 때 활용할 수 있는 기능입니다.
      • 예를 들어, 복합 건물 내의 상점가를 그릴 때 활용할 수 있습니다.
    • 여러 도형이 선택된 채로 분할 연산이 실행되면, 변이 4개가 아닌 도형은 변화하지 않습니다.
  • 씬에서 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 열 수 있습니다.
    • Division Operation 항목에 접근하면, 다음과 같은 연산을 실행할 수 있습니다.
      • 가로 분할 Divide Horizontally
      • 세로 분할 Divide Vertically
      • 4분할 Divide Into Quaters
• 버퍼 연산 Buffer Operation
  • 주어진 거리만큼 도형을 확장하거나 수축하는 연산입니다.
  • 확장하거나 수축할 때, 옵션을 조절하여 원하는 형태로 가공할 수 있습니다.
    • 예를 들어, 도형의 테두리만 남기거나 직사각형을 모서리가 둥근 사각형으로 만들 수도 있습니다.
  • 씬에서 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 열 수 있습니다.
    • Buffer Operation 항목을 실행하면, 화면 가운데에 팝업 창이 열립니다.
      • 거리 Distance
        • 연산이 적용되는 두께를 의미합니다.
        • 양수일 때 확장하고, 음수일 때 수축합니다.
      • 획 덮개 모양 End Cap Style
        • 연산으로 생성된 획 끝부분의 모양을 지정합니다.
        • 항목은 다음과 같습니다.
          • 평평 덮개 END_CAP_BUTT
          • 둥근 덮개 END_CAP_ROUND
          • 사각 덮개 END_CAP_SQUARE
            • 평평 덮개와 비슷하지만, 두께만큼 획의 길이를 확장합니다.
      • 관절 모양 Joint Style
        • 연산으로 생성된 관절의 모양을 지정합니다.
        • 항목은 다음과 같습니다.
          • 연귀 관절 JOINT_MITER
          • 빗각 관절 JOINT_BEVEL
          • 둥근 관절 JOINT_ROUND
      • 세분화 품질 Segmentation Quality
        • 연산으로 생성된 획의 세분화 품질을 결정합니다.
          • 둥근 덮개나 둥근 관절이 영향을 받으며, 품질이 높을 수록 곡선을 많은 변으로 세분화합니다.
        • 항목은 다음과 같습니다.
          • 낮은 품질 SEGMENT_QUALITY_LOW
          • 중간 품질 SEGMENT_QUALITY_MEDIUM
          • 높은 품질 SEGMENT_QUALITY_HIGH
      • 테두리 Outline
        • 체크되면, 도형의 변을 확장하여 테두리만을 생성합니다.
      • 한쪽 방향으로 확장 Single-sided
        • 체크되면, 바깥 방향 (양수 방향) 으로만 변을 확장합니다.
          • 테두리 옵션이 체크되었을 때나 내부에 구멍이 있는 도형만 영향을 받습니다.
• 반전 Flip
  • 도형을 좌우나 상하로 반전합니다.
  • 씬에서 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 열 수 있습니다.
    • Flip 항목에 접근하면, 상하 반전Flip Vertically 이나 좌우 반전Flip Horizontal 항목을 실행할 수 있습니다.

2.5 POI

POI란?

• POI (Point of Interest)는 명확히 지정할 수 있는 특징을 가진 지명, 시설물 등을 말합니다.
  • AMapper에서는 POIItem으로 대응됩니다.

POI 생성

POI 스탬핑 모드

• 툴 바에서 POI Stamping Mode (T)를 선택하거나, 단축키 T를 누릅니다.
• 클릭 할 때마다 POI가 생성됩니다.
  • 생성되는 POI의 기본 설정은 오른쪽 편집 창에서 변경이 가능합니다.
• 도형 객체 위에 커서를 움직이면, 객체간 연결이 가시화됩니다.
  • 연결 대상 레이어에 포함된 도형에만 기능이 활성화됩니다. 자세한 내용은 연결 대상 레이어 항목을 참조하세요.
  • 도형과 POI 객체간 연결에 대한 자세한 내용은 객체간 연결 항목을 참조하세요.

도형 팝업 컨텍스트 메뉴

• Navigation Mode(A) 에서 도형을 선택한 후 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 엽니다.
• 도형 객체를 선택한 후 마우스 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 엽니다.
• 컨텍스트 메뉴의 POI -> Link To.. -> POI 를 선택합니다.
• 선택된 도형에 연결된 POI가 생성됩니다.
  • 도형과 POI 객체간 연결에 대한 자세한 내용은 객체간 연결 항목을 참조하세요.

POI 조작하기

선택

• POI의 텍스트 영역을 클릭하면 선택할 수 있습니다.

이동

• POI를 선택하고 drag하여 이동할 수 있습니다.
• Shift키를 누르면 수직/수평 가이드가 나타납니다.

삭제

• Backspace키 또는 Delete키를 눌러 선택한 POI 객체를 삭제할 수 있습니다.

복제

• Windows에서는 Ctrl, macOS에서는 Command를 누른 채로 도형 객체를 drag 하면
  • drop 하는 위치에 복사본을 생성할 수 있습니다.
  • Shift 키를 누르면 수직/수평 가이드가 나타납니다.
• Windows에서는 Ctrl + C, macOS에서는 Command + C로
  • 선택한 POI 객체를 클립보드로 복사할 수 있습니다.
• Windows에서는 Ctrl + V, macOS에서는 Command + V로
  • 클립보드에 복사한 POI 객체들의 복사본을 생성할 수 있습니다.
• Windows에서는 Ctrl + Option + V, macOS에서는 Command + Option + V로
  • 클립보드에 복사한 POI 객체들의 복사본을 동일한 위치에 생성할 수 있습니다.

POI 속성 입력하기

라벨 Label

• 표시용 라벨Label (Display)과 데이터용 라벨Label (Full)의 두 가지 속성이 있습니다.
  • 표시용 라벨은 렌더링에 사용되는 되는 축약된 명칭입니다.
  • 데이터용 라벨은 길이에 구애받지 않는 온전한 명칭입니다.
    • 명칭이 길지 않아 축약될 필요가 없는 경우, 표시용 라벨만 입력하는 것으로 충분합니다.
  • 각각의 라벨은 다국어 지원 문자열입니다.
    • 자세한 내용은 다국어 입력 문자열 항목을 참조하세요.

가시성 Visibility

• 가시성은 ARCeyeVLSDK 와 연동하여 POI가 보이는 컨텍스트를 지정합니다.
  • 세부 항목은 다음과 같습니다.
    • 숨김 Hidden
    • 지도에만 표시 Map
    • AR에만 표시 AR
    • 지도와 AR에 모두 표시 Map and AR

표시 Display

• 표시는 ARCeyeVLSDK 와 연동하여 POI를 표시하는 방법을 지정합니다.
  • 세부 항목은 다음과 같습니다.
    • 표시하지 않음 None
    • 아이콘만 표시 Icon
    • 텍스트만 표시 Text
    • 아이콘과 텍스트 모두 표시 Icon and Text

카테고리 Category

• 카테고리는 POI의 용도나 업종, 특징을 파악할 수 있도록 제공되는 분류입니다.
  • AMapper 내에 내장되어 있는 항목 중 선택할 수 있습니다.
• 오른쪽 편집 창의 Category 항목에서,
  • Bookmark 또는 Recent 리스트 중 선택하거나,
  • 검색 창에 키워드를 입력하여 적절한 항목을 검색/선택할 수 있습니다.
• 자주 사용하는 항목의 경우, 각 항목 왼쪽에 있는 별 모양 아이콘을 클릭하여 Bookmark 리스트에 추가할 수 있습니다.

2.6 그래프

그래프란?

• 노드와 그 사이를 연결하는 엣지의 집합입니다.
  • 노드는 GraphNodeItem, 엣지는 GraphEdgeItem에 대응됩니다.
• 실내외 도보 네비게이션을 위한 길찾기 알고리즘 및 스테이지와 스테이지 사이의 연결점 역할을 합니다.

그래프 생성하기

그래프 그리기 모드

• 툴 바에서 Graph Drawing Mode (N)을 선택하거나 단축키 N을 누릅니다.
• 왼쪽 마우스 버튼을 클릭하면 현재 선택된 레이어에 노드가 생성됩니다.
• 또 다시 왼쪽 마우스 버튼 클릭하면 노드가 생성되고, 이전 생성된 노드와 연결된 엣지도 생성됩니다.
  • 엣지 없이 노드만 생성하고 싶다면 Windows에서는 Ctrl + 왼쪽 마우스 버튼, macOS에서는 Command + 왼쪽 마우스 버튼을 클릭하세요.
• 다른 노드나 엣지, 도형에 마우스 커서를 올려놓으면 스냅이 일어납니다.
  • 현재 스냅 레이어에 포함된 아이템에만 반응합니다.
    • 자세한 내용은 스냅 레이어를 참조하세요.
  • 노드나 엣지에 스냅하였을 경우 적절한 병합/분할이 자동으로 일어납니다.
  • 도형에 스냅하였을 경우 생성된 노드는 도형과 연결됩니다.
    • 자세한 내용은 객체간 연결 항목을 참조하세요.
• ENTER 키를 눌러 생성한 그래프를 확정하거나 ESC를 눌러서 취소할 수 있습니다.

그래프 조작하기

그래프 노드

• 이동
  • Navigation (A) 모드에서 선택한 그래프 노드를 drag 하여 이동할 수 있습니다.
  • Shift 키를 누른 채 이동하면 수직 방향으로만 이동할 수 있습니다.
  • 그래프 그리기 모드에서와 마찬가지로, 스냅이 가능합니다.
• 삭제
  • 그래프 노드를 선택 한 후, BACKSPACE 또는 DELETE 키를 누르세요.
  • 그래프 노드를 포함하는 엣지도 같이 삭제됩니다.
• 분기 Branching
  • Navigation (A) 모드에서 Windows에서는 Ctrl, macOS에서는 Command를 누른 채로 drag 하면, 점선으로 이어진 가이드가 나타납니다.
  • Shift 키를 누른 채 이동하면 수직 방향으로만 이동할 수 있습니다.
  • 이를 Drop한 위치에 새로운 노드가 생성되며, 분기를 시작한 노드와 연결된 엣지도 생성됩니다.
  • 그래프 그리기 모드에서와 마찬가지로, 스냅이 가능합니다.

그래프 엣지

• 이동
  • Navigation (A) 모드에서 선택한 그래프 엣지를 drag 하여 이동할 수 있습니다.
  • Shift 키를 누른 채 이동하면 수직 방향으로만 이동할 수 있습니다.
• 삭제
  • 그래프 엣지를 선택 한 후, BACKSPACE 또는 DELETE 키를 누르세요.

그래프 속성 입력하기

그래프 노드

• 연결 타입 Transit Type
  • 그래프 노드가 단순한 노드가 아닌 공간 사이를 연결하는 구조물이라면, 그 종류를 지정합니다.
  • 연결 타입의 종류는 다음과 같습니다.
    • 입구 Entrance
    • 게이트 Gate
    • 스피드 게이트 Speed Gate e.g) 개찰구
    • 횡단보도 Crosswalk
    • 에스컬레이터 Escalator
    • 엘리베이터 Elevator
    • 계단 Stairway
    • 무빙 워크 Moving Walk
    • 지하도 Underpass
    • 터널 Tunnel
    • 다리 Bridge
    • 비탈 Slope
  • 연결 타입이 지정된 노드만이 스테이지 간 연결이 가능합니다.
    • 자세한 내용은 스테이지 간 그래프 노드 연결하기 항목을 참조하세요.
• 가중치 Weight
  • 길찾기 알고리즘에서 사용 할 수 있는 가중치 입니다.
  • 기본값은 1이며, 일반적인 경우 변경할 필요는 없습니다.
• 조인트 Joint
  • 스테이지 간 연결을 관리할 수 있습니다.
    • 자세한 내용은 스테이지 간 그래프 노드 연결하기 항목을 참조하세요.
• 커스텀 레인지 Custom Range
  • AR 저작 시, 사용자가 조인트에 접근 하였을 때 특수한 이벤트를 발생하기 위해 지정합니다.
    • 자세한 내용은 AR 저작하기 항목을 참조하세요.

그래프 엣지

• 방향성 Direction
  • 길찾기 알고리즘에서 사용할 수 있는 방향성입니다.
  • 순방향/역방향/양방향을 설정합니다. 일반적인 경우 변경할 필요는 없습니다.
• 가중치 Weight
  • 길찾기 알고리즘에서 사용 할 수 있는 가중치 입니다.
  • 기본값은 1이며, 일반적인 경우 변경할 필요는 없습니다.

2.7 객체 간 연결

객체간 연결이란?

• AMapper는 POI 검색/길찾기/AR 네비 등의 고급 활용이 가능한 데이터를 생성하기 위해 객체간 연결을 지원합니다.

• 다음은 연결이 가능한 객체의 예시입니다.

  • 도형과 POI
  • 도형과 그래프 노드
  • 그래프 노드와 그래프 노드

POI와 도형 연결하기

활용

• POI와 도형을 연결하여 도형이 POI의 영역을 대표하도록 할 수 있습니다.
  • 예를 들어, 복합 건물 내부 상가의 형상을 작도하여 도형 객체를 만들고, 상호를 입력한 POI를 연결합니다.

연결 방법

1.

- POI Stamping mode(T) 에서 커서를 도형 객체 위로 올립니다.
- 생성될 POI와 도형간의 연결이 미리 표현됩니다.
    - 현재 스냅 레이어에 포함된 도형 객체만 반응합니다. 자세한 내용은 [스냅 레이어](2_3_layer#스냅-레이어)를 참조하십시오.
- 그 상태에서 클릭하면 도형과 연결된 POI가 생성됩니다

2.

- 도형을 선택한 후 마우스 오른쪽 버튼을 눌러 컨텍스트 메뉴를 엽니다.
- 컨텍스트 메뉴의 POI -> Link To.. -> POI 를 선택합니다.
- 선택된 도형에 연결된 POI가 생성됩니다.

그래프 노드와 도형 연결하기

활용

• POI와 연결된 도형에 그래프 노드를 연결하면, 도형을 매개로 그래프 노드와 POI도 연결됩니다.
  • 이렇게 연결된 그래프 노드는 POI의 입구점으로 사용할 수 있습니다.

연결 방법

1.

- Graph Drawing Node (N) 에서 커서를 도형 객체의 변 위로 올립니다.
- 도형 객체의 변이 하이라이트 됩니다.
    - 현재 스냅 레이어에 포함된 도형 객체만 반응합니다. 자세한 내용은 [스냅 레이어](2_3_layer#스냅-레이어)를 참조하십시오.
- 이어서 그래프를 그리고, 완료 (ENTER) 하면 도형에 연결된 그래프 노드가 생성됩니다.

2.

- Navigation Mode (A) 에서 그래프 노드를 선택합니다.
- 그래프 노드를 도형의 변 위로 드래그합니다.
- 도형 객체의 변이 하이라이트 됩니다.
    - 현재 스냅 레이어에 포함된 도형 객체만 반응합니다. 자세한 내용은 [스냅 레이어](2_3_layer#스냅-레이어)를 참조하십시오.
- 드래그를 종료하면 도형에 연결된 그래프 노드가 생성됩니다.

스테이지 간 그래프 노드 연결하기

활용

• 스테이지 간 연결을 데이터화 할 수 있으며, 다중 스테이지 대상의 길찾기 알고리즘을 사용할 수 있습니다.
  • 예를 들어, 1F의 어떤 그래프 노드를 계단 타입으로 설정하고, 2F에서 같은 위치의 그래프 노드 역시 계단 타입으로 설정합니다.
  • 이 두 그래프 노드를 연결하면, 1F와 2F가 계단으로 연결되어 있다는 의미입니다.
• 스테이지 간 연결된 그래프 노드를 조인트Joint 라고 부릅니다.

연결 방법

1.

- Navigation Mode (A) 에서 그래프 노드를 선택합니다.
- 오른쪽의 Editable 창에서 Transit Type을 설정합니다.
- Jointable Graph Nodes에 다른 스테이지의 동일한 Transit Type을 가진 그래프 노드들이 설정됩니다. 클릭 시, 연결됩니다.
    - Transit Type이 None일 경우 Jointable Graph Nodes는 보이지 않습니다.
- Joints에 연결한 노드가 리스팅 됩니다.
    - 단방향/양방향 설정이나 연결 해제가 가능합니다.

2. • Navigation Mode (A) 에서 그래프 노드를 선택 후, Link Mode (C) 를 토글합니다.
   • 연결가능한 그래프 노드들에 클립 아이콘이 표기됩니다.
     • 클릭시 닫힌 클립 아이콘으로 토글되고, 한 번 더 누르면 연결이 해제됩니다.
       • 양쪽에서 모두 연결하면 양방향 그래프가 됩니다.

2.8 포인트 클라우드

포인트클라우드 란?

• 공간을 표현하는 수 많은 포인트들의 집합입니다.
  • AMapper에서는 PointCloudItem에 대응됩니다.
• 지도를 저작할 때 가장 중요한 참조자료 중 하나입니다.
  • 포인트 클라우드를 씬으로 불러와서 깔아놓고 베끼는 방식으로 도형 객체를 그리게 됩니다.

포인트클라우드 생성

에셋을 내보내어 생성

• 포인트클라우드 파일 (*.h5, *.ply) 기반의 에셋을 씬으로 내보내어 생성할 수 있습니다.
  • 자세한 내용은 에셋 항목을 참조하세요.

포인트클라우드 조작

선택

• 포인트클라우드의 바운딩 박스 영역을 클릭하면 선택할 수 있습니다.

이동/확대/축소/회전

• 포인트클라우드는 기본적으로 기즈모가 활성화 되어있지 않습니다.
  • 오른쪽의 편집 창에서 Transform 섹션을 확장하면, 기즈모가 나타납니다.
• 기즈모를 조작하여 이동/확대/축소/회전 할 수 있습니다.
  • 자세한 내용은 기즈모 항목을 참조하세요.

삭제

• 포인트클라우드를 선택 한 후, BACKSPACE 또는 DELETE 키를 누르세요.

포인트클라우드 속성

좌표계 Coodinate System

• 포인트클라우드가 생성된 좌표계를 지정하면 AMapper 좌표계 (Right-handed, Y-up) 으로 변환합니다.
  • 항목은 다음과 같습니다.
    • Left-handed, Y-Up (Unity)
    • Left-handed, Y-Down
    • Left-handed, Z-Up (Unreal)
    • Left-handed, Z-Down
    • Right-handed, Y-Up (AMapper/Maya)
      • AMapper 좌표계로, 변환이 일어나지 않습니다.
    • Right-handed, Y-Down (OpenCV)
    • Right-handed, Z Up (3DS Max/blender)
    • Right-handed, Z Down

중점을 원점으로 Origin as Center

• 포인트클라우드 바운딩 박스의 중점을 원점으로 이동합니다.

설정 Preference

• 설정 섹션은 main과 blueprint 두가지로 나누어져 있습니다.

  • 원근 카메라와 직교 카메라에서 선호되는 설정이 달라 따로 설정합니다.
    • main의 설정은 원근 카메라에만 적용됩니다.
    • blueprint의 설정은 나머지 카메라들에 설정됩니다.
  • 최적의 설정은 포인트클라우드의 특성에 따라 상이할 수 있습니다.
    • 아래의 속성값을 바꿔보면서 지도를 작도하기 좋은 설정을 찾는 것이 좋습니다.

• 점 크기 배율 Point Size

  • 점 크기 배율을 조절합니다.
• 투명도 Opacity
  • 점의 투명도를 조절합니다.
• 클립 범위 설정 덮어쓰기 Override ClipRangeY
  • 스테이지에 설정된 클립 범위 설정을 무시하고 입력 값을 사용합니다.
    • 개별 포인트클라우드별로 세세하게 클립범위를 조절할 때 유용합니다.
• 품질 Quality
  • 포인트클라우드의 렌더링 품질을 지정합니다.
    • 품질이 높을 수록 많은 점을 렌더링하지만, 성능이 떨어질 수 있습니다.
• 색상 포맷 ColorFormat
  • 포인트클라우드에 색상이 있을 경우, 색상 순서를 지정합니다.
    • 포인트클라우드의 색상이 실제와 다르다고 느껴지는 경우, 색상 포맷을 변경해 보는 것도 방법입니다.
    • 항목은 RGBA와 BGRA입니다.
• 색상 Color
  • 포인트클라우드에 색상이 없거나 색상 덮어쓰기 옵션을 체크한 경우에 사용할 색상을 지정합니다.
• 색상 덮어쓰기 Override Color
  • 체크 시, 포인트클라우드의 색상과 관계 없이 특정 색상으로 렌더링합니다.
• 둥근 점 Rounded Point
  • 체크 시, 점을 정사각형 대신 원형으로 렌더링합니다.
    • Depth Test와 같이 사용할 시, 가장자리에 계단 현상이 나타날 수 있습니다.
• 색상 맵 사용 Color Map
  • 체크 시, 점의 높이(Y축 성분)을 바탕으로 색상을 입힙니다.
    • 체크 시, 높이 범위 설정 UI가 나타납니다.
    • 높이가 낮을 수록 파란색에 가깝고, 높을 수록 붉은 색에 가까운 색상을 가집니다
      • 넓은 지역의 고저차를 한 눈에 파악할 수 있습니다.
• 깊이 테스트 사용 Depth Test
  • 체크 시, 점을 렌더링 할 때 깊이 테스트를 합니다.
    • 투명도가 없는 상태에서는 필수적으로 사용하는 것이 좋습니다.
      • 렌더링 순서가 올바르고 렌더링 성능 향상을 기대할 수 있습니다.
    • 투명도가 있는 상태에서는 품질이 크게 떨어져 사용을 추천하지 않습니다.
• 구획 별 바운딩 박스 Division Bounding Box
  • 체크 시, 구획 별 바운딩 박스를 렌더링 합니다.
    • 디버깅 목적입니다.

변환 Transform

• 변환은 이동/크기/회전의 세가지 요소로 표현할 수 있습니다.
• 요소 필드에 값을 입력하고 ENTER키를 눌러 변경할 수 있습니다.
• 요소 필드를 좌우로 drag 하여 값을 변경할 수 있습니다.
• 항목은 다음과 같습니다.
  • 이동 Translation
  • 크기 Scaling
  • 회전 Rotation

2.9 거리 뷰

거리 뷰 란?

• 특정 위치/방향 에서 도보 레벨의 사진을 볼 수 있는 객체입니다.
  • AMapper에서는 StreetViewItem에 대응됩니다.
• 지도를 저작할 때 가장 중요한 참조자료 중 하나입니다.
  • 포인트클라우드에서 파악할 수 없는 상점의 간판이나 표지판, 지형의 디테일을 확인할 수 있습니다.

거리 뷰 생성

에셋을 내보내어 생성

• 거리 뷰 파일 (*.sv) 기반의 에셋을 씬으로 내보내어 생성할 수 있습니다.
  • 자세한 내용은 에셋 항목을 참조하세요.

거리 뷰 조작

선택

• 오른쪽의 하이어라키 윈도우에서 거리 뷰 아이템을 클릭하여 선택합니다.
  • 또는, 단축키 S를 누르면 가장 최근 선택되었던 거리 뷰 아이템을 다시 선택합니다.

거리 뷰 보기

• 거리 뷰를 선택한 상태에서 화살표에 마우스 커서를 이동합니다.
  • 거리 뷰 미리보기가 나타납니다.
• 화살표를 클릭합니다.
  • 거리 뷰 윈도우가 열리며, 큰 사진으로 볼 수 있습니다.
    • 거리 뷰 윈도우를 도킹하거나 독립 윈도우로 분리하여 더 편하게 보실 수 있습니다.
  • 키보드 방향키를 좌우로 움직여 다른 방향의 사진을 볼 수 있습니다.

삭제

• 거리 뷰를 선택 한 후, BACKSPACE 또는 DELETE 키를 누르세요.

거리 뷰 속성

좌표계 Coodinate System

• 거리 뷰가 생성된 좌표계를 지정하면 AMapper 좌표계 (Right-handed, Y-up) 으로 변환합니다.
  • 항목은 다음과 같습니다.
    • Left-handed, Y-Up (Unity)
    • Left-handed, Y-Down
    • Left-handed, Z-Up (Unreal)
    • Left-handed, Z-Down
    • Right-handed, Y-Up (AMapper/Maya)
      • AMapper 좌표계로, 변환이 일어나지 않습니다.
    • Right-handed, Y-Down (OpenCV)
    • Right-handed, Z Up (3DS Max/blender)
    • Right-handed, Z Down

중점을 원점으로 Origin as Center

• 거리 뷰 바운딩 박스의 중점을 원점으로 이동합니다.

화살표 크기 Arrow Size

• 거리 뷰 화살표의 크기를 조절합니다.

변환 Transform

• 변환은 이동/크기/회전의 세가지 요소로 표현할 수 있습니다.
• 요소 필드에 값을 입력하고 ENTER키를 눌러 변경할 수 있습니다.
• 요소 필드를 좌우로 drag 하여 값을 변경할 수 있습니다.
• 항목은 다음과 같습니다.
  • 이동 Translation
  • 크기 Scaling
  • 회전 Rotation

3. 에셋

에셋이란?

• 에셋은 외부 파일을 프로젝트에 사용할 수 있도록 관리하는 객체입니다.
• 외부 파일을 에셋으로 불러온 후에 에셋을 씬으로 내보내어 대응하는 아이템을 생성합니다.

불러오기 가능한 에셋 타입 목록

• 포인트 클라우드
  • 씬으로 내보내면 PointCloudItem을 생성합니다.
    • PointCloudItem은 Reference 레이어로 내보낼 수 있습니다.
  • 지원 포맷
    • Hierarchical Data Format (*.h5)
      • AMapper와 호환되는 특수한 구조를 가진 h5 파일만 정상 동작합니다.
    • Polygon File Format (*.ply)
      • 점 데이터로 이루어진 표준을 준수하는 ply 파일만 정상 동작합니다.
• 거리 뷰
  • 씬으로 내보내면 StreetViewItem을 생성합니다.
    • StreetViewItem은 Street View 레이어로 내보낼 수 있습니다.
  • 지원 포맷
    • Street View Format (*.sv)
      • AMapper 전용 거리뷰 포맷입니다.
• 벡터 맵
  • 씬으로 내보내면 VectorMapItem을 생성합니다.
    • VectorMapItem은 Reference 레이어로 내보낼 수 있습니다.
  • 지원 포맷
    • Shapefile (*.shp)
    • SQLite (*.sqlite)
      • AMapper와 호환되는 특수한 데이터 구조를 가진 sqlite 파일만 정상 동작합니다.
    • Hierarchical Shapefile (*.h5shp)
      • AMapper 전용 벡터 맵 포맷입니다.
• 3D 모델
  • 씬으로 내보내면 ModelItem을 생성합니다.
    • ModelItem은 3D Model 레이어로 내보낼 수 있습니다.
  • 지원 포맷
    • GL Transmission Format (*.glb, *.gltf)
    • Wavefront OBJ (*.obj)
      • 표준을 준수하는 obj 파일만 정상 동작합니다.
• 이미지
  • 씬으로 내보내면 ImageItem을 생성합니다.
    • ImageItem은 Reference 레이어로 내보낼 수 있습니다.
  • 지원 포맷
    • Portable Network Graphic (*.png)
    • JPEG (*.jpg, *.jpg)
• IBL (Image-based Lighting)
  • 씬으로 내보낼 수 없고, AR 에서 Physically-based rendering 구현을 위한 환경맵으로 사용됩니다.
  • 지원 포맷
    • Khronos Texture (*.ktx)
      • AMapper와 호환되는 특수한 구조를 가진 ktx 파일만 정상 동작합니다.
• 비디오
  • 씬으로 내보내면 VideoARItem을 생성합니다.
    • VideoARItem은 3D Model 레이어로 내보낼 수 있습니다.
  • 지원 포맷
    • MPEG-4 (*.mp4)
• 오디오
  • 씬으로 내보내면 AudioARItem을 생성합니다.
    • AudioARItem은 3D Model 레이어로 내보낼 수 있습니다.
  • 지원 포맷
    • MPEG-3 (*.mp3)

외부에서 불러오기

• 에셋 불러오면 하단의 Asset 창에 에셋이 추가됩니다.

파일 메뉴로 불러오기

• Asset -> Import Asset File(s)로 파일을 선택합니다.
• Asset -> Import Asset Folder로 폴더를 선택합니다.
  • 원하는 포맷을 선택해서 가져올 수 있습니다.
  • 모든 하위 폴더의 파일도 포함입니다.

Drag and drop 으로 불러오기

• 외부 파일 탐색기에서 AMapper가 지원가능한 파일 포맷을 선택합니다.
• 실행 중인 AMapper 창으로 Drag and drop 합니다.

에셋 창에서 불러오기

• 에셋 창을 파일 탐색 모드로 전환합니다.
• 폴더 별로 불러오기가 가능한 파일만 출력됩니다.
• 불러올 파일에 마우스 오른쪽 버튼을 클릭합니다.
• 팝업 메뉴가 열리면, Import Asset을 선택합니다.

씬으로 내보내기

Drag and drop으로 내보내기

• 에셋을 씬으로 drag and drop 합니다.
• Drop 한 자리에 에셋이 로드됩니다.

에셋 창에서 내보내기

• 불러올 에셋에 마우스 오른쪽 버튼을 클릭합니다.
• 팝업 메뉴가 열립니다.
  • Export를 선택하면, 현재 선택 된 스테이지로 내보냅니다.
    • 내보낼 수 있는 레이어가 여러개 있으면, 자동으로 하나를 선택합니다.
  • Export To..에서 레이어를 선택하여 내보낼 수도 있습니다.
• 이 방법으로 내보낸 에셋은 원점 (0,0,0)에 위치합니다.

4. AR 저작

AR 저작에 관하여

• AMapper는 앞서 작성한 지도 위에 손쉽게 통합할 수 있는 AR 저작 기능을 제공합니다.
• 모든 AR 저작 데이터는 *.amproj 포맷에 저장됩니다.
  • *.amproj 포맷은 ARCeyeVLSDK와 연동할 수 있고, 내부의 데이터를 바탕으로 복잡한 설정이 없이 AR 앱을 개발할 수 있도록 돕습니다.

지도 저작과의 차이

• 지도 저작시에는 도형의 높낮이가 중요하지 않았습니다.
• AR 환경에서는 카메라에 증강 될 객체의 위치, 높이, 각도, 크기가 몰입에 중요한 요소입니다.

AR 객체

AR 객체란?

• AR 객체는 AR 환경에서 증강 될 수 있는 객체들입니다.

종류

• AR 객체의 종류는 다음과 같습니다.
  • 모델 ModelItem
  • 비디오 VideoARItem
  • 오디오 AudioARItem
  • 인포패널 InfoPanelARItem

4.1 AR 설정

표지판 설정 IndicatorConfig

• WIP

POI 설정 POIConfig

• WIP

POI 스타일 POIStyle

• WIP

길찾기 설정 PathFinderConfig

• WIP

4.2 모델

모델이란?

• 모델은 AR 애플리케이션에서 증강할 수 있는 3D 객체입니다.
  • AMapper에서는 ModelItem에 대응합니다.

모델 생성

에셋을 내보내어 생성

• 3D 모델 파일 (*.glb, *.gltf, *.obj) 기반의 에셋을 씬으로 내보내어 생성할 수 있습니다.
  • 자세한 내용은 에셋 항목을 참조하세요.

모델 조작

선택

• 모델의 바운딩 박스 영역을 클릭하면 선택할 수 있습니다.

이동/확대/축소/회전

• 모델을 선택하면 기즈모가 나타납니다.
• 기즈모를 조작하여 이동/확대/축소/회전 할 수 있습니다.
  • 자세한 내용은 기즈모 항목을 참조하세요.

모델 속성

변환 Transform

• 변환은 이동/크기/회전의 세가지 요소로 표현할 수 있습니다.
• 요소 필드에 값을 입력하고 ENTER키를 눌러 변경할 수 있습니다.
• 요소 필드를 좌우로 drag 하여 값을 변경할 수 있습니다.
• 항목은 다음과 같습니다.
  • 이동 Translation
  • 크기 Scaling
  • 회전 Rotation

자동 회전 Auto Rotate

• AR 객체가 카메라의 위치에 따라 회전하도록 지정할 수 있습니다.
  • 빌보드 Billboard 라고 부르기도 하며, 객체가 카메라의 움직임에 반응하여 카메라를 바라보도록 할 수 있습니다.
• 항목은 다음과 같습니다.
  • 자동 회전 없음 None
  • Y축만 회전 Y Axis
  • Z축만 회전 Z Axis
  • 카메라 회전 (Y/Z) Camera

그림자 캐스터 IsShadowCaster

• 체크 시, 모델은 빛의 방향에 따라 그림자를 드리웁니다.

그림자 리시버 IsShadowReceiver

• 체크 시, 모델에 스스로 또는 다른 모델의 그림자가 드리울 수 있습니다.

AR 가시성 AR Visibility

• 모델을 특정 AR 탐색 모드에서 보이거나 보이지 않도록 지정합니다.
• 항목은 다음과 같습니다.
  • 주변 탐색 모드에서만 Around
  • 길찾기 모드에서만 Navigation
  • 항상 Always

렌더링 범위 Rendering Range

• 렌더링을 시작할 최소 거리를 지정합니다.

동작 범위 Action Range

• 객체 별로 사전 정의된 동작을 실행할 최소 거리를 지정합니다.
  • 예를 들어, 사용자가 모델의 동작 범위 이내로 들어갔을 때 fade-in 될 수 있습니다.
  • 자세한 내용은 Visual FSM 항목을 참조하세요.

커스텀 범위 Custom Range

• 커스텀 범위는 도형 객체를 범위로 지정할 수 있어 단순 거리만 가진 액션 범위보다 세밀한 조정이 가능합니다.
• VisualFSM과 연동하여 사전 정의된 동작 외에 새로운 동작을 트리거 할 때 사용할 수 있습니다.
  • 자세한 내용은 Visual FSM 항목을 참조하세요.

FSM

• VisualFSM에서 작성한 FSM을 적용합니다.
• 사전 정의된 동작 외에 새로운 동작을 지정할 수 있습니다.
  • 자세한 내용은 Visual FSM 항목을 참조하세요.

4.3 비디오

비디오란?

• AR 환경에 얇은 스크린 형태로 증강되어 동영상을 재생하는 객체입니다.
  • AMapper에서는 VideoARItem에 대응됩니다.

비디오 생성

에셋을 내보내어 생성

• 동영상 기반 (*.mp4)의 에셋을 씬으로 내보내어 생성할 수 있습니다.
  • 자세한 내용은 에셋 항목을 참조하세요.

비디오 조작

선택

• 비디오의 바운딩 박스 영역을 클릭하면 선택할 수 있습니다.

이동/확대/축소/회전

• 비디오를 선택하면 기즈모가 나타납니다.
• 기즈모를 조작하여 이동/확대/축소/회전 할 수 있습니다.
  • 자세한 내용은 기즈모 항목을 참조하세요.

삭제

• 비디오를 선택 한 후, BACKSPACE 또는 DELETE 키를 누르세요.

비디오 속성

변환 Transform

• 변환은 이동/크기/회전의 세가지 요소로 표현할 수 있습니다.
• 요소 필드에 값을 입력하고 ENTER키를 눌러 변경할 수 있습니다.
• 요소 필드를 좌우로 drag 하여 값을 변경할 수 있습니다.
• 항목은 다음과 같습니다.
  • 이동 Translation
  • 크기 Scaling
  • 회전 Rotation

자동 회전 Auto Rotate

• AR 객체가 카메라의 위치에 따라 회전하도록 지정할 수 있습니다.
  • 빌보드 Billboard 라고 부르기도 하며, 객체가 카메라의 움직임에 반응하여 카메라를 바라보도록 할 수 있습니다.
• 항목은 다음과 같습니다.
  • 자동 회전 없음 None
  • Y축만 회전 Y Axis
  • Z축만 회전 Z Axis
  • 카메라 회전 (Y/Z) Camera

너비 Widgh, 높이 Height

• 비디오 패널의 너비와 높이를 지정합니다.
  • AMapper는 비디오를 생성 할 때 동영상 파일의 정보를 읽어 동일한 너비와 높이를 자동으로 입력합니다.
    • 너비와 높이 정보를 읽지 못한 경우, 패널은 1:1 비율로 가정합니다.

종횡비 고정 Lock Aspect Ratio

• 체크 시, 높이는 너비에 맞추어 자동 변경되며 입력창은 비활성화 됩니다.

화면 맞춤 Display Fit

• 비디오 패널의 종횡비와 동영상의 종횡비가 맞지 않을 때 정책을 지정합니다.
• 항목은 다음과 같습니다.
  • 채우기 Fill
    • 종횡비에 관계없이 동영상을 패널에 채웁니다.
    • 동영상이 지나치게 늘어나거나 수축된 것처럼 보일 수 있습니다.
  • 포함하기 Contain
    • 동영상의 종횡비를 유지하면서 동영상을 패널 안쪽에 맞춥니다.
    • 레터박스가 보일 수 있습니다.
  • 덮기 Cover
    • 동영상의 종횡비를 유지하면서 동영상으로 패널 전체를 덮습니다.
    • 동영상의 일부분이 보이지 않을 수 있습니다.

알파 마스크 포함 비디오 Video Contains Alpha Mask

• 동영상에 알파 마스크가 포함되었는지 여부를 지정합니다.
• AMapper에서 사용하는 알파 마스크 포함 동영상은 세로로 2배 길어진 특수한 형태이며, 내부적으로 조합하여 투명한 동영상을 구현하게 됩니다.

뒷면 사용하기 Use Backface

• 체크 시, 비디오의 뒷면을 검은 패널로 처리합니다. 아닌 경우는 투명하게 처리됩니다.

볼륨 Volume

• 동영상의 사운드 볼륨을 조절합니다.

페이드 인 Fade In

• 동영상의 음향 재생을 시작 할 때, 서서히 볼륨을 높입니다.
  • 값은 초 단위 입니다.

페이드 아웃 Fade Out

• 동영상의 음향 재생을 종료 할 때, 서서히 볼륨을 낮춥니다.
  • 값은 초 단위 입니다.

공간 음향 Spatial

• 체크 시, 공간 음향을 사용합니다.
  • 사용자와 거리가 멀 수록 볼륨이 작아집니다.

공간 음향 감쇄 함수 Spatial Curve Type

• 공간 음향 사용 시, 거리에 비례한 음향의 감쇄를 구하는 곡선 함수를 지정합니다.
• 항목은 다음과 같습니다.
  • 부드러운 곡선 Smoothstep
    • 거리에 비례한 볼륨 변화가 비교적 부드럽게 일어납니다.
  • 지수 곡선 Logarithm
    • 어느정도 거리까지는 볼륨이 빠르게 증가하다, 이후로 완만하게 증가하는 경향이 있습니다.
    • 집중도를 높일 때 사용할 수 있습니다.
  • 역 Inverse
    • 가까워질 수록 볼륨이 줄어들고, 멀 수록 볼륨이 커집니다.

반복 재생 Looping

• 동영상의 반복 재생 여부를 체크합니다.

AR 가시성 AR Visibility

• 비디오를 특정 AR 탐색 모드에서 보이거나 보이지 않도록 지정합니다.
• 항목은 다음과 같습니다.
  • 주변 탐색 모드에서만 Around
  • 길찾기 모드에서만 Navigation
  • 항상 Always

렌더링 범위 Rendering Range

• 렌더링을 시작할 최소 거리를 지정합니다.

동작 범위 Action Range

• 사전 정의된 동작을 실행할 최소 거리를 지정합니다.
  • 사용자가 비디오의 동작 범위 안으로 들어올 때 재생을 시작합니다.
  • 사용자가 비디오의 동작 범위 밖으로 나갔을 때 재생을 멈춥니다.

커스텀 범위 Custom Range

• 커스텀 범위는 도형 객체를 범위로 지정할 수 있어 단순 거리만 가진 렌더링 범위보다 세밀한 조정이 가능합니다
  • 비디오의 경우, 커스텀 범위가 지정되면 렌더링 범위의 역할을 대신합니다.

4.4 오디오

오디오란?

• AR 환경에서 음향을 재생하는 객체입니다.
  • AMapper에서는 AudioARItem에 대응됩니다.

오디오 생성

에셋을 내보내어 생성

• 음향 기반 (*.mp3)의 에셋을 씬으로 내보내어 생성할 수 있습니다.
  • 자세한 내용은 에셋 항목을 참조하세요.

오디오 조작

선택

• 오디오의 아이콘 영역을 클릭하면 선택할 수 있습니다.

이동/확대/축소/회전

• 아이콘을 선택하면 기즈모가 나타납니다.
• 기즈모를 조작하여 이동/확대/축소/회전 할 수 있습니다.
  • 사운드는 확대/축소의 영향을 받지 않습니다.
  • 자세한 내용은 기즈모 항목을 참조하세요.

삭제

• 오디오를 선택 한 후, BACKSPACE 또는 DELETE 키를 눌러 삭제합니다.

비디오 속성

변환 Transform

• 변환은 이동/크기/회전의 세가지 요소로 표현할 수 있습니다.
• 요소 필드에 값을 입력하고 ENTER키를 눌러 변경할 수 있습니다.
• 요소 필드를 좌우로 drag 하여 값을 변경할 수 있습니다.
• 항목은 다음과 같습니다.
  • 이동 Translation
  • 크기 Scaling
  • 회전 Rotation

볼륨

• 오디오의 음향 볼륨 크기를 조절합니다.

Fade In

• 오디오의 음향 재생을 시작 할 때, 서서히 볼륨을 높입니다.
  • 값은 초 단위 입니다.

Fade Out

• 오디오의 음향 재생을 종료 할 때, 서서히 볼륨을 낮춥니다.
  • 값은 초 단위 입니다.

공간 음향 Spatial

• 체크 시, 공간 음향을 사용합니다.
  • 사용자와 거리가 멀 수록 음향의 크기가 작아집니다.

공간 음향 감쇄 함수 Spatial Curve Type

• 공간 음향 사용 시, 거리에 비례한 음향의 감쇄를 구하는 곡선 함수를 지정합니다.
• 항목은 다음과 같습니다.
  • 부드러운 곡선 Smoothstep
    • 거리에 비례한 볼륨 변화가 비교적 부드럽게 일어납니다.
  • 지수 곡선 Logarithm
    • 어느정도 거리까지는 볼륨이 빠르게 증가하다, 이후로 완만하게 증가하는 경향이 있습니다.
    • 집중도를 높일 때 사용할 수 있습니다.
  • 역 Inverse
    • 가까워질 수록 볼륨이 줄어들고, 멀 수록 볼륨이 커집니다.

반복 재생 Looping

• 오디오의 반복 재생 여부를 체크합니다.

AR 가시성 AR Visibility

• 오디오를 특정 AR 탐색 모드에서 들리거나 들리지 않도록 지정합니다.
• 항목은 다음과 같습니다.
  • 주변 탐색 모드에서만 Around
  • 길찾기 모드에서만 Navigation
  • 항상 Always

렌더링 범위 Rendering Range

• 오디오의 경우, 화면 상에 렌더링 할 요소는 없습니다.
  • 렌더링 범위는 오디오의 로딩을 시작하는 범위를 의미합니다.

동작 범위 Action Range

• 사전 정의된 동작을 실행할 최소 거리를 지정합니다.
  • 사용자가 오디오의 동작 범위 안으로 들어올 때 재생을 시작합니다.
  • 사용자가 오디오의 동작 범위 밖으로 나갔을 때 재생을 멈춥니다.

커스텀 범위 Custom Range

• 커스텀 범위는 도형 객체를 범위로 지정할 수 있어 단순 거리만 가진 렌더링 범위보다 세밀한 조정이 가능합니다
  • 오디오의 경우, 커스텀 범위가 지정되면 렌더링 범위의 역할을 대신합니다.

4.5 투어

투어 란?

• AR 앱에서 여러 코스를 정해진 순서에 따라 안내하도록 구성할 수 있는 객체입니다.
  • 박물관, 작품전/전시회/박람회 등의 도슨트 프로그램 등에 사용할 수 있습니다.

투어 생성

하이어라키 창에서 생성

• 하이어라키 창 상단의 스테이지 생성 버튼을 누르면 스테이지 생성 팝업 창이 열립니다.
  • 템플릿Template 속성에서 Stage (Tour) 항목을 선택합니다.
  • 확인Confirm 버튼을 누르면 투어 스테이지가 생성 됩니다.
• 투어 스테이지 당 하나의 투어를 가질 수 있습니다.
  • 투어 스테이지를 생성 할 때, 투어 객체와 투어 레이어는 미리 생성됩니다.
  • 투어 객체나 투어 레이어를 추가하는 것은 불가능합니다.

코스 란?

• 투어의 전체 과정을 단계별로 나누어 표현하는 객체입니다.
• 투어 레이어 하위에 생성 됩니다.
  • AMapper에서는 CourseARItem에 대응됩니다.

코스 생성

그래프로부터 생성

• 투어 스테이지의 루트 레이어에 그래프를 작성합니다.
• Shift키를 누른 상태에서 코스의 시작 노드부터 종료 노드까지를 차례대로 선택합니다.
• 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 엽니다.
• Generate Course in.. -> Tour -> New 를 선택하면 코스가 생성됩니다.
  • 이미 생성된 코스를 선택하면 경로를 덮어씁니다.

코스 조작

선택

• 코스의 바운딩 박스 영역을 클릭하면 선택할 수 있습니다.

경로 편집

• 경로를 구성하는 그래프 노드를 이동하면 코스의 경로도 자동으로 업데이트 됩니다.

삭제

• 코스를 선택 한 후, BACKSPACE 또는 DELETE 키를 누르세요.

투어 속성

스테이지

• AR 앱에서 투어를 활용하기 위해서는 각 투어가 진행되는 스테이지와 투어 간 연결이 필요합니다.
  • 예를 들면, 다음과 같은 스테이지 구조를 가정합니다.
    • 미술관 1F
    • 미술관 2F
    • 중세 미술 투어 (Tour)
    • 근대 미술 투어 (Tour)
  • 미술관 1층에는 중세 미술 작품이 전시되어 있고, 미술관 2F에는 근대 미술 작품이 전시되어 있습니다. 그에 맞추어 투어 스테이지를 생성, 편집하였습니다.
  • 하지만 데이터 상으로는 중세 미술 투어가 1F에서 진행되는 투어인지, 2F에서 진행되는 투어인지 추측할 수 없습니다.
  • 따라서 중세 미술 투어를 미술관 1F와 연결하고, 근대 미술 투어를 미술관 2F와 연결합니다.

프리뷰 Preview

• 투어를 대표하는 썸네일 이미지를 지정합니다.
  • 이미지 기반의 에셋 중에서 선택할 수 있습니다.

커스텀 범위 Custom Range

• 커스텀 범위는 도형 객체를 투어가 시작되는 진입 범위로 지정할 수 있습니다.
  • 투어 스테이지 내에 존재하는 도형 객체만 가능합니다.

코스 속성

색상

• 씬에서 코스의 색상을 지정합니다.
  • 다른 코스와 쉽게 구분하기 위한 용도입니다.

진행 범위 Next Range

• 다음 코스의 시작 지점으로부터 진행 범위 이내의 거리로 접근하면 코스를 전환합니다.

실내 Indoor

• 체크 시, 실내 코스로 간주합니다.

방향 꺾는 위치 안내 Turn Spot

• 체크 시, 방향을 꺾어야 할 때 회전 신호를 증강하여 알려줍니다.

다음 단계 안내 Next Step

• 체크 시, 다음 코스 시작점을 향한 안내가 나타납니다.

바닥 화살표 안내 Ground

• 체크 시, 바닥면에 화살표를 증강하여 진행 방향을 표시합니다.

AR 객체

• 왜 코스와 AR 객체를 연결해야 하나요?

  • AR 앱에서 효과적으로 사용할 수 있습니다.
  • 예를 들면, 진행 중인 코스의 AR 객체는 활성화하고, 다른 코스의 AR 객체는 비활성화 할 수 있습니다.

• 코스와 AR 객체를 연결하는 방법

  • Link Mode (C) 사용
    • 코스를 선택 하고 Link Mode (C) 를 토글합니다.
    • 연결가능한 AR 객체들에 클립 아이콘이 표기됩니다.
      • 클릭시 닫힌 클립 아이콘으로 토글되고, 한 번 더 누르면 연결이 해제됩니다.
  • 팝업 컨텍스트 메뉴 사용
    • 모델을 선택하고 오른쪽 버튼을 눌러 팝업 컨텍스트 메뉴를 엽니다.
    • Link Course.. -> Tour 에 접근하여 원하는 코스를 선택합니다.

4.6 길찾기 모드

길찾기 모드란?

• 목적지와 도착지를 지정 후 실행하면 결과를 표시합니다.
• 그래프 노드와 그래프 엣지, 그리고 길찾기 설정을 알고리즘에 사용합니다.
• 결과를 얻기 위해 AMapper에 내장된 알고리즘을 실행하거나 서버에 요청할 수 있습니다.

길찾기 모드

실행

• 화면 상단의 툴바에서 Path Finding Mode (I) 를 클릭하거나 단축키 I를 누릅니다.
• 반투명한 파란 시작점 심볼이 커서에 표시됩니다. 시작 스테이지를 선택하고 원하는 위치를 클릭하면 시작점이 지정됩니다.
• 반투명한 빨간 도착점 심볼이 커서에 표시됩니다. 도착 스테이지를 선택하고 원하는 위치를 클릭하면 도착점이 지정됩니다.
• Find Path 버튼을 클릭하면, 알고리즘을 실행하여 결과를 렌더링합니다.
  • 결과가 없거나 문제가 생겼을 경우, 메세지 창에 로그를 출력합니다.
• Space키를 눌러 시작점/도착점/카메라 이동 모드를 순환할 수 있습니다.

길찾기 속성

클라이언트 Client

• 길찾기 요청을 보낼 클라이언트를 지정합니다.
  • 항목은 다음과 같습니다.
    • Local
      • AMapper에 내장된 클라이언트를 사용합니다.
    • Remote
      • 원격 클라이언트를 사용하여, 외부 API 서버에 요청합니다.
      • URL 속성이 나타나고, API 서버의 주소를 정확하게 입력해야 합니다.

연결 타입 Connection Type

• 스테이지간 이동 시 혀용할 연결 타입을 지정합니다.
  • 제한 없음 Any
  • 에스컬레이터만 Escalator only
  • 엘리베이터만 Elevator only
  • 계단만 Stair only

4.7 Visual FSM

What is VisualFSM?

• Visual FSM is a node-based editor tool purposed in the creation and management of finite state machines (FSMs).
• An FSM assigned to an AR model determines the rendered behavior of that model.

Opening the VisualFSM Editor

• Select 'Window -> VisualFSM Editor' from the top menu.

VisualFSM Editor Interface

• The Properties Bar facilitates the viewing and editing of the selected element's general properties.
• The FSM Editor provides a space to visually build FSMs through creating states and controlling the flow between states using transitions.
  • The FSM Selector is located at the top-left of the FSM Editor and allows users to select which FSM to display in the FSM Editor.

Managing FSMs

• Creating a new FSM
  • Hover the mouse over the FSM Selector and select 'Create New FSM...'
• Methods for Importing FSMs
  • 1. Importing from the current .amproj
       • Select 'Create New FSM...' from the FSM Selector and select an FSM from the Import menu.
  • 2. Importing from a different .amproj
       • Select 'File -> Import -> JSON' from the Visual FSM Editor top menu.
• Removing an FSM
  • If not already displayed, click on any blank space in the FSM Editor to display the current FSM in the Properties Bar.
  • Select 'Remove FSM' from the Properties Bar.

Editing FSMs

State

• Press the 'Z' key within the graph window to create a new state.
• Select a state and press the 'X' key to delete the state.
• Initial State
  • An initial state is required for every FSM.
  • To set an initial state, select the state in the FSM Editor and check 'Set as initial state' in the Properties Bar.
  • The initial state's title bar appears green in the FSM Editor.

Runnable

• Runnables are functions that control rendering behavior. They are as follows:
  • Set Active
  • Play Animation
  • Fade
  • Set Opacity
  • Set Auto Rotate
• Runnables can be added to states and transitions from the Property Bar.

Transition

• Drag from one state's 'Out' node and connect the link to another state's 'In' node to create a transition between states. The transition will appear red until it is correctly configured.
• There are two ways to configure a transition:
  • 1. Event Trigger (colored green):
       • This type of transition will progress from the previous state to the next when a selected Event Trigger is invoked during runtime.
       • Select an Event Trigger from the Properties Bar:
         • Beginning
           • Invoked when the FSM first begins
         • Entered Rendering Range
           • Invoked when the user enters the AR model's rendering range
         • Entered Action Range
           • Invoked when the user enters the AR model's action range
         • Entered Custom Range
           • Invoked when the user enters the AR model's custom range
         • Exited Rendering Range
           • Invoked when the user exits the AR model's rendering range
         • Exited Action Range
           • Invoked when the user exits the AR model's action range
         • Exited Custom Range
           • Invoked when the user exits the AR model's custom range
         • On Tapped
           • Invoked when the user taps the AR model
         • On Untapped
           • Invoked when the user untaps the AR model's tap selection
  • 2. Automatic Event (colored yellow)
       • This type of transition will progress from the previous state to the next after a certain period of time.
       • Check 'Automatic Event' from the Properties Bar.
       • If the transition's previous state contains a 'Play Animation' or 'Fade' runnable, the duration of the automatic event will be automatically set based on these runnable durations.
       • Check 'Manually Set Event Duration' from the Properties Bar to override the automatic duration setting.

Assigning FSMs

• Select a Model from the AMapper Hierarchy window. Under the AR section of a Model's Editable window, select an FSM from the FSM drop-down menu.

5. 데이터 관리

5.1 테이블 뷰

테이블 뷰란?

• 대규모 프로젝트에서 아이템을 테이블 형태로 보면서 쉽게 데이터를 비교하고 고칠 수 있습니다.
• 타입별 맞춤 필터링 기능을 제공하여 원하는 데이터를 쉽게 추려볼 수 있습니다.

테이블 필터

타입

• 테이블을 표시 할 타입을 선택합니다.
  • 현재 AMapper에서 테이블 뷰를 지원하는 타입은 다음과 같습니다.
    • GraphNodeItem
    • POIItem

요약 Comprehensive

• 체크 시, 타입 별 주요 컬럼만 나타납니다. 해제 시, 표시 가능한 모든 컬럼이 나타납니다.

경고 Warning

• 체크 시, 경고 사항이 있는 아이템만 필터링 해서 리스팅합니다.

이름 Name

• 문자열을 입력하면 이름에 문자열 포함 여부를 검사하여 필터링합니다.

타입 별 추가 필터

• GraphNodeItem

  • 스테이지 Stage
    • 특정 스테이지에 포함된 GraphNodeItem만 노출합니다.
  • 연결 타입 Transit Type
    • 연결 타입이 일치하는 GraphNodeItem만 노출합니다.

• POIItem

  • 카테고리 Category
    • 문자열을 입력하면 카테고리에 문자열 포함 여부를 검사하여 필터링합니다.
  • 스테이지 Stage
    • 특정 스테이지에 있는 POIItem만 노출합니다.
  • 가시성 Visibility
    • 가시성 타입이 일치하는 POIItem만 노출합니다.

테이블 컬럼

전체 선택

• 클릭 시, 현재 테이블에 리스팅 된 아이템을 모두 선택합니다.

정렬

• 컬럼 헤드를 클릭 시, 특정 필드의 값을 기준으로 정렬 할 수 있습니다.
  • 클릭할 때 마다 오름차순과 내림차순이 변경됩니다.
  • Shift키를 누르고 컬럼을 클릭하면, 우선 순위가 낮은 정렬 기준을 추가 할 수 있습니다.

줄 이동

• 키보드의 위쪽 방향키와 아래쪽 방향키 키를 누르면 커서가 이동합니다.

개별 선택

• 원하는 아이템을 클릭하면 선택할 수 있습니다.
• Shift를 누른 채 아이템을 클릭하면 추가로 선택/해제 할 수 있습니다.
• Shift를 누른 채 위쪽/아래쪽 방향키로 이동하면 원래 있던 자리 부터 현재 커서의 위치까지 아이템이 선택됩니다.

5.2 GeoJSON으로 내보내기

GeoJSON 이란?

• GeoJSON은 지리 정보를 표현하는 포맷 중 가장 널리 사용되는 것 중 하나이며, 사실상 업계 표준입니다.
• AMapper에서는 스테이지 별로 GeoJSON 파일을 내보낼 수 있습니다.
  • GeoJSON에 다음의 아이템을 가공하여 내보낼 수 있습니다.
    • POIItem
    • GeometryItem
    • GraphNodeItem
    • GraphEdgeItem
    • AnnotationItem

GeoJSON으로 내보내는 방법

• 상단 메뉴에서 File -> Export -> GeoJSON을 선택하면, Export GeoJSON 팝업 창이 열립니다.
• Stage 속성에서 원하는 스테이지를 선택합니다.
• Layers 속성에서 원하는 레이어를 체크합니다.
• Identifier Type은 각 아이템을 구분할 수 있는 식별자의 종류를 지정합니다.
  • 항목은 다음과 같습니다.
    • ID
      • 프로젝트 내에 내부적으로 부여된 번호를 식별자로 사용합니다.
        • 1부터 시작하는 양의 정수입니다.
      • 프로젝트 내에서도 유일하지 않을 수 있고, 사용을 추천하지 않습니다.
    • UUID
      • 아이템이 생성 될 때 함께 생성 된 UUID를 식별자로 사용합니다.
      • 항상 유일성이 보장됩니다.
      • GeoJSON 파일에서는 Base64 형태로 저장되며, 파일의 용량이 다소 증가할 수 있습니다.
    • Serial Number
      • 프로젝트의 모든 식별자를 내보내기 시점에서 재생성하여 부여합니다.
        • 1부터 시작하는 양의 정수입니다.
      • 프로젝트 내에서 유일성이 보장되지만, 동일한 아이템이라도 프로젝트에 변경 사항이 있을 시 기존과 다른 식별자로 변경될 수 있는 위험성이 있습니다.
• Confirm을 클릭하고 파일 탐색기에서 내보낼 GeoJSON 파일의 경로를 지정하여 저장합니다.

GeoJSON 확장 속성

{
    "type": "FeatureCollection",
    "features": [
        // GeometryItem
        {
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    // ...
                ]
            },
            "properties": {
                "type"  : 0, // type == 0은 GeometryItem 입니다.

                "order" : 0, // order는 레이어 내부에서 아이템의 순서입니다.
                "layer" : 0, // layer는 스테이지 내부에서 레이어의 순서입니다.

                "mid"   : 0, // Identifier Type 항목에서 ID 또는 Serial Number를 선택하였을 때 식별자가 입력됩니다. 양의 정수 형태입니다.
                "uuid"  : "" // Identifier Type 항목에서 UUID를 선택하였을 때 식별자가 입력됩니다. Base64 로 인코딩된 문자열 형태입니다.
            }
        },
        // POIItem
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    // ...
                ]
            },
            "properties": {
                "type"       : 1 , // type == 1은 POIItem 입니다.
                "stage"      : "", // POIItem이 속한 스테이지의 이름입니다.

                "layer"      : 0 ,
                "order"      : 0 ,

                "name_dp"    : "", // POI의 표시용 명칭입니다.
                "name_full"  : "", // POI의 전체 명칭입니다.

                "dp_code"    : 0 , // POI의 분류별로 지정된 스타일 용도의 식별자입니다. 정수 형태입니다 (음수가 가능합니다.)
                "visibility" : 3 ,

                "mid"        : 0 ,
                "uuid"       : "",

                "geometry"   : "" // 연결된 GeometryItem의 식별자 입니다.
            }
        },
        // GraphNodeItem
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    // ...
                ]
            },
            "properties": {
                "type" : 2 , // type == 2는 GraphNodeItem입니다.

                /*
                    // 연결 타입 입니다.
                    0  : 입구 Entrance,
                    1  : 게이트 Gate,
                    2  : 스피드 게이트 Speed Gate e.g) 개찰구,
                    3  : 횡단보도 Crosswalk,
                    4  : 에스컬레이터 Escalator,
                    5  : 엘리베이터 Elevator,
                    6  : 계단 Stairway,
                    7  : 무빙 워크 Moving Walk,
                    8  : 지하도 Underpass,
                    9  : 터널 Tunnel,
                    10 : 다리 Bridge,
                    11 : 경사로 Slope
                */
                "transitType"  : 0 ,
                "weight"       : 1 , // GraphNodeItem의 weight 항목과 동일합니다.
                "joints"       : [], // GraphNodeItem의 joint  항목과 동일합니다. { (식별자), (가중치) } 형태로 조인트가 입력됩니다.

                "mid"          : 0 ,
                "uuid"         : "",

                "geometry"     : "" // 연결된 GeometryItem의 식별자 입니다.
            }
        },
        // GraphEdgeItem
        {
            "type": "Feature",
            "geometry": {
                "type": "LineString",
                "coordinates": [
                    // ...
                ]
            },
            "properties": {
                "type": 3, // type == 3는 GraphEdgeItem입니다.

                /*
                    GraphEdgeItem의 direction을 표현합니다.

                    { 1.0, 1.0 } -> 양방향
                    { 1.0, 0.0 } -> 순방향
                    { 0.0, 1.0 } -> 역방향
                */
                "weights": [ 
                    1.0,
                    1.0
                ],

                "mid" : 0 ,
                "uuid": "",

                "from": "", // 시작 GraphNodeItem의 식별자 입니다.
                "to"  : ""  // 종료 GraphNodeItem의 식별자 입니다.
            }
        }
    ],

    "version"  : 0, // AMapper에서 내보낸 GeoJSON 확장 속성 포맷의 버전입니다.

    "layerName": [ // layer 속성을 index로 사용하여 이름을 찾을 수 있습니다.
        "LAYER_1",
        "LAYER_2",

        // ...

        "LAYER_N"
    ]
}

5.3 GLTF로 내보내기

GLTF 란?

• GLTF는 크로노스 그룹에서 공개한 스펙으로, 효과적인 3D 씬과 모델을 전송/로드에 중점을 두었습니다. 대부분의 3D 환경에서 안정적으로 활용할 수 있는 포맷입니다.
• AMapper에서는 스테이지의 형상을 GLTF 파일로 생성할 수 있습니다.

GLTF로 내보내는 방법

• File -> Export -> 3D Format를 선택하면, Export Stage As 3D Format 팝업 창이 열립니다.
• Stage 속성에서 원하는 스테이지를 선택합니다.
• TODO : Style configuration
• Confirm을 클릭하고 파일 탐색기에서 내보낼 GLTF 파일의 경로를 지정하여 저장합니다.

5.4 다른 프로젝트 가져오기

다른 프로젝트에서 무엇을 가져올 수 있나요?

• 다른 프로젝트에서 가져올 수 있는 객체는 다음과 같습니다.
  • 스테이지 Stage
  • 레이어 Layer
  • 도형 GeometryItem
  • 그래프노드 GraphNodeItem
  • 그래프엣지 GraphEdgeItem
• 이외의 다른 모든 객체/설정 등은 가져오지 않습니다.
  • 특히, AR 객체/설정을 가져올 수 없는 것에 주의하세요.
  • AR 저작이 포함된 프로젝트는 가져오기를 사용하는 것을 추천하지 않습니다.
• 다른 프로젝트 가져오기 기능은 주로 지도 저작 시의 협업을 위해 활용할 수 있습니다.
  • 예를 들어, 넓은 지역의 지도를 저작할 때 구역을 나누어 작성한 후, 가져오기를 통해 하나의 프로젝트로 합칠 수 있습니다.

가져오기 정책

INSERT

• 가져오는 모든 객체의 UUID를 새로이 생성하여 추가합니다.
  • 동일한 객체(UUID가 일치)가 존재하는 상황은 없습니다.

UPSERT

• 가져오는 프로젝트에 동일한 객체(UUID가 일치)가 존재하는 경우,
  • 기존 객체 속성을 가져오는 객체 속성으로 덮어씌웁니다.
• 일치하는 객체가 없다면,
  • 단순히 추가합니다.

다른 프로젝트를 가져오는 방법

• 상단 메뉴에서 File -> Import -> Project를 선택하면, 파일 탐색기 창이 열립니다. 가져올 프로젝트를 선택합니다.
• *.amproj 파일을 선택하면, Import A Project 팝업 창이 열립니다.
  • INSERT나 UPSERT 옵션을 선택합니다.
  • Confirm 버튼을 클릭하여 프로젝트를 가져옵니다.

5.5 GeoJSON 가져오기

GeoJSON에서 무엇을 가져올 수 있나요?

• GeoJSON에서 가져올 수 있는 객체는 다음과 같습니다.
  • GeometryItem
    • AMapper에서 UUID 식별자 타입으로 내보낸 GeoJSON일 경우, UUID를 복원하여 가져옵니다.
    • AMapper에서 내보낸 GeoJSON 파일이라고 해도 레이어를 구분해서 가져오지는 않습니다.
  • POIItem
    • AMapper에서 UUID 식별자 타입으로 내보낸 GeoJSON에 한하여 가져올 수 있습니다.
• GeoJSON을 가져올 대상은 레이어입니다.
  • 레이어에 포함할 수 없는 객체는 무시됩니다.
    • 예를 들어, 셰이프 레이어를 대상으로 하였다면 GeoJSON에 포함된 POIItem은 무시하고 GeometryItem 만을 가져옵니다.
    • POIItem을 가져오고 싶다면 심볼 레이어를 대상으로 다시 한 번 가져오기를 실행합니다.

다른 프로젝트를 가져오는 방법

• 상단 메뉴에서 File -> Import -> GeoJSON에 접근하여 스테이지/레이어 리스트를 통해
• *.geojson 파일을 선택하여 GeoJSON 내에서 객체를 가져옵니다.

6. 부록

6.1 단축키 일람

용어 정의

• MOD는 Windows에서 Ctrl, macOS에서 Cmd를 의미합니다.
• ALT는 Window에서 Alt, macOS에서 Opt를 의미합니다.

파일

• MOD + N 새 프로젝트
• MOD + O 불러오기
• MOD + S 저장하기
• MOD + Shift + S 다른 이름으로 저장
• MOD + Q 종료

편집

• MOD + C 복사하기
• MOD + X 잘라내기
• MOD + V 붙여넣기
• MOD + Shift + V 제자리에 붙여넣기
• MOD + Z 취소하기
• MOD + Y 다시하기
• DELETE 선택한 객체 삭제하기
• BACKSPACE 선택한 객체 삭제하기

에셋

• MOD + SHIFT + I 에셋 파일 불러오기
• MOD + SHIFT + ALT + I 에셋 폴더 불러오기

뷰

• MOD + SHIFT + ' 격자 토글
• MOD + 1 원근 뷰
• MOD + 2 직교 뷰
• MOD + 3 원근/직교 2분할 뷰
• MOD + 4 원근/직교/정면 3분할 뷰
• MOD + 5 원근/직교/정면/측면 3분할 뷰
• MOD + - POI 라벨 사이즈 축소
• MOD + = POI 라벨 사이즈 확대
• 1 오브젝트 레이어 토글
• 2 레퍼런스 레이어 토글
• 3 셰이프 레이어 토글
• 4 심볼 레이어 토글
• 5 루트 레이어 토글
• 6 애로우 레이어 토글
• 7 라벨링 레이어 토글

기즈모

• Q 기즈모 숨김
• W 기즈모 이동 모드
• E 기즈모 회전 모드
• R 기즈모 크기 모드
• D 기즈모 기준 도메인 순환

모드

• A 탐색 모드 Navigation Mode
• C 연결 모드 Link Mode
• P 자유 도형 그리기 모드 Polygon Drawing Mode
• M 사각형 그리기 모드 Rectangle Drawing Mode
• O 타원 그리기 모드 Ellipse Drawing Mode
• V 도형 편집 모드 Polygin Editing Mode
• T POI 스탬핑 모드 POI Stamping Mode
• N 그래프 그리기 모드 Graph Drawing Mode
• L 라벨링 모드 Labeling Mode
• \ 레이어 고정 선택 토글 Layer-Locked Selection Toggle
• ` 스테이지 고정 렌더링 토글 Stage-Locked Rendering Toggle
• ' 측정 도우미 토글 Measuring Helper Toggle

확정/취소

• ENTER 그리기 확정
• ESC 그리기 취소

하이어라키

• , 스테이지 내 다음 레이어를 선택
• . 스테이지 내 이전 레이어를 선택
• [ 이전 스냅/연결 대상 레이어로 변경
• ] 다음 스냅/연결 대상 레이어로 변경

아이템

• F 포커스

거리 뷰

• S 거리 뷰 모드 토글
• LEFT 이전 미리보기 선택
• RIGHT 다음 미리보기 선택