Files
GhiVideo_v4/docs/history/2026-07-03_1340_전체흐름도-다이어그램-작성.md
T
b23042andClaude Fable 5 d38b842e8d GhiVideo 소스 복제 — v4 작업 시작 기준
기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제.
(node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-09 14:32:51 +09:00

31 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 전체 흐름 다이어그램 작성 (보고서 삽입용)
**소요 시간**: 약 10분
**Context 사용량**: input ~180k / output ~6k tokens
## 요청
- 스테이션기반 플레이어의 **전체 흐름을 다이어그램**으로 표현 (사용자 보고서 삽입용).
## 산출물
- `docs/그림_전체흐름도.png` (2400×1100, 고해상도) / `docs/그림_전체흐름도.pdf` (압축)
- `scripts/fig_전체흐름도.py`**재생성 스크립트** (문구·색 수정 후 `python3 scripts/fig_전체흐름도.py` 재실행)
## 다이어그램 구성 (좌→우 4단)
1. **입력 — 데이터 폴더 1개** (회색 그룹): 영상(mp4) / 드론 비행로그(csv, 위치·자세각·초점) / 측점(csv, 실측 정표고) / POI·구조물(kmz) + 노선 보정(json·선택)
2. **① 자동 파싱** (파랑): 인코딩 자동감지 · KMZ 해제
3. **② 좌표·측점 계산** (초록 2박스): 시간↔측점 대응표 생성 / 좌표 투영 계산(드론 위치·자세각 → 화면 픽셀)
4. **③ 화면 출력** (황금 3박스): 측점 스테이션바 / 영상 AR 오버레이 / 대용량 영상 재생
- 하단 엘보 경로: "영상 원본은 계산 없이 곧바로 스트리밍 재생" (계산 우회 표현)
## 기술 방식
- 직전 확립한 **PIL 직접 드로잉** 파이프라인 (weasyprint SVG 디센더 잘림 회피). 폰트 자동 축소(fit) 헬퍼로 박스 폭 초과 방지.
- 용어는 최근 정정 사항 반영: "스테이션기반", "드론 촬영 철도시설물 영상", "자세각", "시간↔측점 대응표".
## 검증
- PNG 육안 검증: 글자 잘림 없음, 배치·화살표 정상 ✅