기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제. (node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1.8 KiB
1.8 KiB
영상 fps 데이터 기반 자동 산출 (고정 29.97 → 가변)
소요 시간: 약 20분 Context 사용량: input ~150k / output ~6k tokens
배경
프레임번호↔시간 변환이 VIDEO_FPS = 30000/1001(29.97)로 하드코딩 → 30fps 영상 전용.
24/60fps 등 다른 영상은 이름표가 어긋남. 어떤 fps 영상이 로드될지 미리 알 수 없음.
문제 데이터
드론 CSV(frame_cnt,latitude,...)엔 시간이 없고 frame_cnt(프레임 번호)만 있음.
→ fps 를 CSV 단독으로 못 구함. 영상 길이(duration) 와 결합 필요.
해결
effectiveFps = maxFrameCnt / duration → 표준 fps(23.976/24/25/29.97/30/50/59.94/60) 중
±10% 이내면 스냅, 아니면 원시값. 데이터/길이 미확보 시 29.97 폴백.
변경 파일 (2개, 소규모)
- VideoPlayer.tsx
effectiveFpsuseMemo 신설(storeFrames+duration).VIDEO_FPS하드코딩 4곳 제거 (frame 계산 / HUD 표시 / 프레임입력 이동 / StationOverlay prop).- useFrameStep 의 fps(VFC 감지, 31 오감지)는 미사용 → destructure 제거.
- StationOverlay.tsx
fpsRef(prop fps 기반) 추가. 프레임↔시간 변환 VIDEO_FPS 사용처(최근접 프레임 탐색, estFrame)를 fpsRef.current 로 교체. VIDEO_FPS 상수는 폴백 기본값으로만 유지.
주의/전제
- 드론 CSV 가 영상 전체 구간을 덮는다는 전제(마지막 frame_cnt ≈ 영상 끝). 부분만 덮으면 fps 과소 → 스냅 실패 시 원시값 사용. 필요 시 메타데이터/FFprobe 로 보강 가능.
- 표준 목록 밖 fps 는 스냅 없이 원시값 사용.
검증
tsc --noEmit통과npm run build성공 → 새 해시index-BbUe4Gr4.js:55000 서빙 확인