Files
GhiVideo/docs/history/2026-06-24_1043_히스토리파일명-시간추가-및-POI원근현상-분석.md
T
b23042andClaude Opus 4.8 78fc090360 초기 커밋: 스테이션(측점) 기반 주행영상 플레이어
- 클라이언트(React/Vite): Video.js 플레이어, 하단 스테이션바, POI/구조물 영상 오버레이, 카메라 파라미터 보정, 미니맵/RoutePanel
- 서버(Express): Range 스트리밍, HLS 변환, 프레임 추출, tus 업로드, 주석 API
- 최근 작업: 스테이션바 종점역 표출/양끝 정렬/미도착(재생불가) 표시, POI 라벨 '구분' 우선·컴팩트 팝업·겹침제외 토글·동일좌표 다중행, 진행방향(상/하) 우선 표출, 커서 배지 크기·픽셀 떨림 개선

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 16:37:57 +09:00

2.0 KiB

히스토리 파일명에 시간(HHMM) 추가 + POI 라벨 원근 현상 분석

날짜: 2026-06-24 수정 파일: CLAUDE.md, docs/history/* (파일명 변경)

1) 히스토리 파일명 규칙: 날짜 → 날짜+시간

요구: 각 작업 파일명에 날짜와 시간을 함께 기록.

  • 규칙 변경: docs/history/YYYY-MM-DD_{작업명}.mdYYYY-MM-DD_HHMM_{작업명}.md (CLAUDE.md 갱신).
  • 오늘 작성한 7개 파일을 작성 시각(mtime) 기준으로 일괄 리네임(0926~1026), 파일 간 상호 링크(선행/관련) 갱신.

2) "멀리선 뒤로 밀리고 가까이선 빨리 아래로 빠짐" — 원근 현상(버그 아님)

사용자 관찰: 라벨이 멀 땐 살짝씩 밀리고, 바로 밑을 지날 땐 드론 이동보다 빨리 아래로 빠져 사라짐.

결론(정정)

이는 정상적인 원근 투영 효과다. 수직간격 Δh 일정·드론고도 일정이어도 화면 각속도는 dβ/dt = v·Δh/(D²+Δh²) — 멀리(D 큼) 느리고, 천정점(D→0) 부근 v/Δh로 최대. 즉 머리 위를 지나가는 고정 지물은 원래 그렇게 보인다. (앞서 "far/near 부호 뒤집힘" 진단은 과했음 — 정정.)

진짜 잔차의 판별

라벨이 영상 속 실제 대상물에 붙어 있으면 정상(고치면 오히려 틀림). 대상에서 벗어나면 '드론 24m 아래 상수' 가정이 그 지점 실제 간격과 달라서 생기는 잔차:

  • 가까이서 라벨이 대상보다 먼저 빠짐 → 실제 간격 < 24(과대) → 이격거리↓ 또는 지형표고 사용.
  • 멀리서 라벨이 대상보다 떠 보임 → 24 과소 → 반대 조정.
  • 지형표고(측점 z/DEM)는 구간별로 변하므로 상수 가정의 잔차를 근본 제거(POI투영오차 문서 §18·§19).

조치

  • 사용자에게 "라벨이 실제 지물에 붙는지/벗어나는지" 확인 요청. 코드 변경은 보류(현상 정상).

검증

  • 코드 변경 없음(문서/파일명만). 빌드 불요.

소요 시간: 약 10분 Context 사용량: input ~255k / output ~6k tokens