Files
GhiVideo_v4/docs/DEMO.md
T
b23042andClaude Fable 5 7d51ba9945 표고 체계 정비·설정 파일 단순화·선형 클리핑·시연 준비
- 타원체고 기준 자동 변환: route.json ellipsoidal_height 선언 시 드론 고도(CSV 정표고)를
  영상 메타(djmd 6.6 타원체고)와의 차(지오이드고 자동 산출)만큼 보정, 세그먼트 전환에도 유지
- KML 표고 파이프라인: 좌표 고도(z) 사용(POI/측점), *_byDem.kml 자동 생성(DEM 조회·높이 속성 포함)
  + 로더의 _byDem 우선 규칙, 선형중심선(LineString) 로딩·경로표고 앵커
- 설정 파일: camera.json/display.json/route.json 단순 이름 인식, 화면표시 옵션 PC 저장/자동 적용,
  초기화 버튼을 환경설정 파일 기준 복원으로 변경, 저장 파일명 단순화
- 선형 표시: 표출된 마지막 측점까지 클립(경계 세그먼트 절단 + 관통 현 처리 — 구간 실종 수정)
- 스테이션바: 시점(0k000) 마크(실통과 위치), 노선밖 프레임 통과 오인 방지, 커서 배지 1m 단위,
  배너 연장/소요 실측값(측점 체이니지·영상 길이 합) 우선
- 세그먼트 전환 라벨 깜빡임 구조 수정(캐시 초기화·최근접 키 조회·이중 재계산 제거) +
  사전계산 프레임 불변값 호이스팅(재생 지연 해소)
- UI: 슬라이더/값 입력칸 휠 조절, 패널 버튼 위치 정렬, 저장 버튼 중복 제거, dev_mode(route.json)로
  영상제어 UI 표시 제어, 지오이드 최대 200, 이격거리 측점 동반 적용
- 시연: start-demo.bat + docs/DEMO.md
- docs/history: 작업 이력 30건

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-13 20:37:46 +09:00

40 lines
2.1 KiB
Markdown

# 노트북 시연 가이드
폴더 선택 기반 재생(드론 영상 + 측점/지장물 오버레이) 시연은 **Node.js만 있으면** 동작한다.
WSL/PM2/FFmpeg 불필요 (FFmpeg 은 HLS 변환·서버 프레임추출용 — 시연 흐름에서 안 씀).
## 1. 사전 준비 (사무실, 인터넷 필요)
1. 노트북에 **Node.js 20 LTS** 설치 — https://nodejs.org (Windows 인스톨러)
2. 소스 받기 (둘 중 하나)
- `git clone https://gitea.hmac.kr/b23042/GhiVideo_v4.git`
- 또는 현재 PC 의 저장소 폴더를 통째로 복사 (node_modules 제외)
3. 저장소 루트에서:
```bat
npm install
npm run build
```
4. **시연 데이터 폴더 복사** — `경로 1-1` 폴더 전체(약 12GB)를 노트북 아무 곳에나:
- 영상 4개(DJI_*.MP4), 비행로그 CSV, 측점/지장물 KML, route.json
- **`*.camera.json` / `*.display.json`(환경설정 파일) 포함** — 캘리브레이션 자동 적용됨
## 2. 시연 실행
- 저장소 루트의 **`start-demo.bat` 더블클릭** → 브라우저가 http://localhost:54000 자동 오픈
- 화면 가운데 **[폴더 선택]** → 복사해 둔 `경로 1-1` 폴더 선택
- 자동으로: 첫 영상 재생 + 측점/지장물/궤적/선형 오버레이 + 카메라 보정 적용 + 이름순 연속재생
## 3. 주의사항
- **사전 리허설 필수**: 시연 전 노트북에서 위 흐름 1회 확인
- **오프라인 시연**: 나침반 '지도(street/sat)' 스타일은 외부 타일 프록시라 인터넷 필요 →
오프라인이면 나침반을 '눈금(analog)'으로 (display.json 기본이 analog 라 문제 없음)
- 브라우저는 Chrome/Edge 권장 (폴더 선택 webkitdirectory)
- 영상이 고사양(4K60, 150Mbps)이라 저사양 노트북에서는 1x 재생 위주로 시연 권장
- 서버 종료: bat 창에서 Ctrl+C (또는 창 닫기)
## 4. (선택) FFmpeg
서버 업로드·HLS 변환·정밀 프레임 추출까지 시연하려면 FFmpeg 설치 후 PATH 등록:
https://www.gyan.dev/ffmpeg/builds/ → 미설치 시 해당 기능만 비활성(경고 로그), 나머지 정상.