Files
GhiVideo/docs/history/2026-06-24_1043_히스토리파일명-시간추가-및-POI원근현상-분석.md
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

34 lines
2.0 KiB
Markdown

# 히스토리 파일명에 시간(HHMM) 추가 + POI 라벨 원근 현상 분석
**날짜**: 2026-06-24
**수정 파일**: `CLAUDE.md`, `docs/history/*` (파일명 변경)
## 1) 히스토리 파일명 규칙: 날짜 → 날짜+시간
요구: 각 작업 파일명에 날짜와 **시간**을 함께 기록.
- 규칙 변경: `docs/history/YYYY-MM-DD_{작업명}.md`**`YYYY-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