GhiVideo 소스 복제 — v4 작업 시작 기준

기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제.
(node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-09 14:32:51 +09:00
co-authored by Claude Fable 5
commit d38b842e8d
362 changed files with 46358 additions and 0 deletions
@@ -0,0 +1,35 @@
# 드론 흔들림 잡기 + 글자 붙이기 — 초등학생용 쉬운 설명 작성
## 작업 내용
기존 기술문서 [2026-06-29_1436_드론자세평활-오버레이렌더링-기술문서화.md](2026-06-29_1436_드론자세평활-오버레이렌더링-기술문서화.md)의 내용이 실제 코드에 적용되어 있는지 검증한 뒤, 그 기술을 **초등학생 눈높이 + SVG 그림**으로 쉽게 풀어쓴 문서를 신규 작성.
### 1. 기술문서 ↔ 실제 코드 적용 여부 검증
- [StationOverlay.tsx](../../client/src/components/overlay/StationOverlay.tsx)(1639줄)에서 문서가 인용한 함수/상수 위치를 grep으로 대조
- `smoothFrame`(L577), `poseAt`(L670), `smoothStep`(L48), `startLabelPrecompute`(L692), `buildLines`(L606), `coverRef`(L257), `VIDEO_FPS=30000/1001`(L25), `YAW_EDGE=8`(L580), `REJECT_DIST=0.12`, `MAX_REJECT_FRAMES=8`, `SMOOTH_VEL_BETA=0.25` 모두 실제 존재·일치 확인
- 결론: 기술문서는 가상이 아니라 실제 구현 코드를 정확히 기술한 것
### 2. 초등학생용 쉬운설명 문서 작성
- 신규 파일: [docs/쉬운설명_드론흔들림잡기와_글자붙이기.md](../쉬운설명_드론흔들림잡기와_글자붙이기.md)
- 기존 `쉬운설명_GhiVideo_기술이야기.md`의 SVG figure 스타일을 따름
- 8개 SVG 삽화 포함, 비유 중심 서술 (도시락/만화 사이그림/거북이토끼 등)
- 다룬 핵심 기술 4+1가지:
1. 에지보존 적응형 평활(smoothFrame) → "곧을 땐 많이, 돌 땐 멈춰서"
2. 연속프레임 보간(poseAt) → "30장을 60장처럼 사이 채우기"
3. 속도적응 EMA + 이상치거부(smoothStep) → "느리면 살살, 빠르면 빨리"
4. precompute + RAF 2단 분리 → "미리 정하기 vs 그때그때 그리기 (도시락 비유)"
5. 겹침 우선순위 + 상/하행 형제 라벨 + 나침반(보너스)
### 3. HTML/PDF 변환
- `scripts/md2docs.sh`로 변환 완료
- 산출물: `쉬운설명_드론흔들림잡기와_글자붙이기.{html,pdf}` (PDF 118KB)
## 산출물
- `docs/쉬운설명_드론흔들림잡기와_글자붙이기.md` (22KB)
- `docs/쉬운설명_드론흔들림잡기와_글자붙이기.html` (28KB)
- `docs/쉬운설명_드론흔들림잡기와_글자붙이기.pdf` (118KB)
---
**소요 시간**: 12분
**Context 사용량**: input 95k / output 11k tokens