b23042andClaude Fable 5
d38b842e8d
기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제. (node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
34 lines
1.7 KiB
Markdown
34 lines
1.7 KiB
Markdown
# 1배속에서 POI 라벨·팝업 떨림 제거 — 속도 적응형 평활(One Euro 방식)
|
||
|
||
**날짜**: 2026-06-24
|
||
**수정 파일**: `client/src/components/overlay/StationOverlay.tsx`
|
||
|
||
## 증상
|
||
빠른 배속에선 POI 라벨/팝업이 부드러운데, **1배속(느린 이동)에선 흔들려 보임**.
|
||
|
||
## 원인
|
||
라벨 화면좌표에 **일정 진폭의 떨림(GPS/투영 잔여 노이즈)**이 있음. 빠른 배속은 프레임당 이동량이
|
||
커서 떨림이 묻히고, 1배속은 이동이 작아 떨림이 도드라짐. 화면 EMA(`emaAlpha`)가 1.0(평활 거의 없음)
|
||
이라 그대로 노출됨.
|
||
|
||
## 조치 — `smoothStep` 을 속도 적응형으로(One Euro 필터 방식)
|
||
고정 alpha → **속도에 따라 가변**:
|
||
- 속도 벡터를 평활(`vx,vy` EMA, β=0.25). 떨림은 매 프레임 방향이 번갈아 → 평활속도≈0,
|
||
실제 이동은 방향 일관 → 평활속도 큼. (떨림과 실제 이동을 속도로 구분)
|
||
- `alpha = min(maxAlpha, MIN(0.12) + (maxAlpha−0.12)·min(1, speed/SPEED_REF(0.01)))`
|
||
- 정지/떨림(speed≈0) → alpha≈0.12 → **강한 평활(1배속 안정)**.
|
||
- 빠른 이동(speed≥0.01) → alpha→maxAlpha(패널 EMA α=1.0) → **즉시 추종(빠른 배속 지연 없음)**.
|
||
- 이상치 거부(REJECT_DIST)·연속한계는 유지. `DispPos` 에 vx/vy 추가.
|
||
|
||
## 효과
|
||
- 1배속·먼 POI(떨림 잘 보임) → 강하게 평활돼 안정.
|
||
- 가까운/빠른 이동 POI → 즉시 추종(지연 없음).
|
||
- 팝업도 라벨 displayed 좌표를 따라가므로 함께 안정.
|
||
- 패널 **EMA α** 슬라이더 = 빠를 때의 추종 상한(기본 1.0).
|
||
|
||
## 검증
|
||
- `npm run build -w client` (node20) tsc + vite build 통과.
|
||
|
||
**소요 시간**: 약 10분
|
||
**Context 사용량**: input ~960k / output ~4k tokens
|