4.8 노드 데이터 편집 (Annotation)
노드 데이터 편집 기능은 지도 위에 Goal / Route 노드를 배치하고, 노드 간 링크를 정의하여 로봇의 주행 경로를 설계하는 도구입니다.
헬퍼 위치 지정 → 노드 생성 → 링크 연결 → 검증·수정 의 네 단계로 진행되며, 언제든 재편집이 가능합니다.
화면 구성
| 번호 | 요소 | 설명 |
|---|---|---|
| ① | 타이틀 | 노드 데이터 편집 — 현재 모드(Annotation)를 명확히 표기하는 중앙 헤드라인 |
| ② | 가이드 문구 | Annotation 절차·버튼 용도를 요약 안내 |
| ③ | 액션 패널 | Preview Helper 토글 노드 추가(로봇) 노드 추가(헬퍼) 링크 (→) 링크 (⇆) 링크 삭제 노드 삭제 닫기 |
| ④ | 메인 캔버스 | 현재 지도·로봇·헬퍼·노드·링크가 렌더링되는 3D 뷰 |
액션 패널(③)은 ① 타이틀과 ② 가이드 하단, 화면 중앙에 고정되어
노드·링크 작업 중에도 시야를 가리지 않으면서 즉시 접근 가능합니다.
사용 절차
- Annotation 아이콘 ✏️ (우측 하단) 클릭 → Annotation 인터페이스 활성화
- Preview Helper 토글 ON
- 헬퍼(투명 회색 로봇 + XYZ 축)가 나타나면, 마우스 클릭 / 터치로 정확한 위치·방향을 설정합니다.
- 노드 생성
- 노드 추가(로봇) : 로봇 현재 위치에 Goal 노드 1개 생성
- 노드 추가(헬퍼) : 헬퍼 위치에 Goal 노드 1개 생성
- 링크 연결
- 시작 노드 선택 → 2) 도착 노드 선택 → 3) 링크 (→ or ⇆) 버튼 클릭
- 단방향(→) / 양방향(⇆) 화살표로 표시됩니다.
- 검증 & 수정
- 잘못 연결된 링크: 해당 노드들 선택 → 링크 삭제
- 필요 없는 노드: 노드 선택 → 노드 삭제
- [닫기] 버튼 클릭 → 기본 레이아웃으로 복귀
주요 버튼 설명
| 버튼 / 토글 | 동작 |
|---|---|
| 🛰️ Preview Helper | 헬퍼 표시 On/Off 및 위치 지정 |
| 🟧 노드 추가(로봇) | 로봇 위치에 Goal 노드 1개 생성 |
| 🟧 노드 추가(헬퍼) | 헬퍼 위치에 Goal 노드 1개 생성 |
| ➡️ 링크 (→) | 선택 → 대상 순서로 단방향 링크 생성 |
| ⇆ 링크 (⇆) | 선택 → 대상 순서로 양방향 링크 생성 |
| 🔗 링크 삭제 | 선택한 노드 쌍 사이의 링크 제거 |
| 🗑️ 노드 삭제 | 선택한 노드와 연결된 링크 전체 삭제 |
| ❌ 닫기 | Annotation 모드 종료 |
팁 & 주의 사항
- Preview Helper를 사용하면 로봇이 접근하기 어려운 위치에도 노드를 정밀하게 배치할 수 있습니다.
- 연결 방향(단방향 / 양방향)을 명확히 설정하여 로봇 주행 시 혼선을 방지하세요.