Files
GhiVideo/docs/history/2026-06-30_1525_드론흔들림-글자붙이기_초등학생용_쉬운설명.md
b23042andClaude Opus 4.8 e0ff5dd6d0 feat: 지도 나침반(OSM/위성) 추가 + 측점 검색·마커 정확도 개선 + POI/영상 수정
- 지도 기반 나침반(노스업, 현재위치, 시야 역삼각형): 호버 확대·휠 줌·클릭 위성전환, OSM/Esri 타일 서버 프록시(/api/tile)
- 스테이션 검색: 실제 측점(chain) 기준 이동, 없으면 '측점 없음' 안내
- 역 마커: 직교 투영 측점 일치 시에만 표시, 미도착 종점은 추가 방식
- POI 팝업 겹침/재등장·라벨 정합 수정
- 영상 fps 데이터 기반 자동 산출
- 기술/발표/쉬운설명 문서 추가

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-02 18:03:30 +09:00

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가지:
    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