기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제. (node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
드론 흔들림 잡기 + 글자 붙이기 — 초등학생용 쉬운 설명 작성
작업 내용
기존 기술문서 2026-06-29_1436_드론자세평활-오버레이렌더링-기술문서화.md의 내용이 실제 코드에 적용되어 있는지 검증한 뒤, 그 기술을 초등학생 눈높이 + SVG 그림으로 쉽게 풀어쓴 문서를 신규 작성.
1. 기술문서 ↔ 실제 코드 적용 여부 검증
- 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
- 기존
쉬운설명_GhiVideo_기술이야기.md의 SVG figure 스타일을 따름 - 8개 SVG 삽화 포함, 비유 중심 서술 (도시락/만화 사이그림/거북이토끼 등)
- 다룬 핵심 기술 4+1가지:
- 에지보존 적응형 평활(smoothFrame) → "곧을 땐 많이, 돌 땐 멈춰서"
- 연속프레임 보간(poseAt) → "30장을 60장처럼 사이 채우기"
- 속도적응 EMA + 이상치거부(smoothStep) → "느리면 살살, 빠르면 빨리"
- precompute + RAF 2단 분리 → "미리 정하기 vs 그때그때 그리기 (도시락 비유)"
- 겹침 우선순위 + 상/하행 형제 라벨 + 나침반(보너스)
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