# 드론 흔들림 잡기 + 글자 붙이기 — 초등학생용 쉬운 설명 작성 ## 작업 내용 기존 기술문서 [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