- 클라이언트(React/Vite): Video.js 플레이어, 하단 스테이션바, POI/구조물 영상 오버레이, 카메라 파라미터 보정, 미니맵/RoutePanel - 서버(Express): Range 스트리밍, HLS 변환, 프레임 추출, tus 업로드, 주석 API - 최근 작업: 스테이션바 종점역 표출/양끝 정렬/미도착(재생불가) 표시, POI 라벨 '구분' 우선·컴팩트 팝업·겹침제외 토글·동일좌표 다중행, 진행방향(상/하) 우선 표출, 커서 배지 크기·픽셀 떨림 개선 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
25 lines
1.4 KiB
Markdown
25 lines
1.4 KiB
Markdown
# 속도적응 평활 튜닝값을 패널 슬라이더로 노출 (떨림억제·반응속도)
|
||
|
||
**날짜**: 2026-06-24
|
||
**수정 파일**: `client/src/components/overlay/StationOverlay.tsx`
|
||
**관련**: [2026-06-24_1758_라벨팝업-속도적응평활-1배속떨림제거.md](2026-06-24_1758_라벨팝업-속도적응평활-1배속떨림제거.md)
|
||
|
||
## 요구
|
||
직전에 추가한 `SMOOTH_MIN_ALPHA(0.12)`/`SMOOTH_SPEED_REF(0.01)` 을 어디서 조절? (코드 상수였음)
|
||
→ 패널에서 실시간 조절 가능하게.
|
||
|
||
## 조치
|
||
- `smoothStep` 시그니처에 `minAlpha, speedRef` 파라미터 추가(모듈 상수 제거). `SMOOTH_VEL_BETA`만 상수 유지.
|
||
- 상태/ref `smoothMinAlpha`(0.12)·`smoothSpeedRef`(0.010) + `DISPLAY_DEFAULTS` 추가.
|
||
- RAF 의 smoothStep 2개 호출에 `smoothMinAlphaRef.current, smoothSpeedRefRef.current` 전달.
|
||
- 화면표시 옵션 패널 "스무딩" 섹션에 슬라이더 2개:
|
||
· **떨림억제**(min α, 0.02~0.6) — 낮을수록 1배속 떨림 강하게 평활.
|
||
· **반응속도**(speedRef, 0.002~0.04) — 클수록 느린 이동까지 부드럽게, 줄이면 빨리 반응.
|
||
- "기본값" 버튼 리셋 + `ghivideo:calib` 영속화(저장/복원)에 포함. EMA α 툴팁을 "빠를 때 추종 상한"으로 정리.
|
||
|
||
## 검증
|
||
- `npm run build -w client` (node20) tsc + vite build 통과.
|
||
|
||
**소요 시간**: 약 10분
|
||
**Context 사용량**: input ~1010k / output ~5k tokens
|