# 1-클릭 FOV(초점) 보정 — POI를 실제 위치로 드래그해 focal 역산

**날짜**: 2026-06-24
**수정 파일**: `client/src/components/overlay/StationOverlay.tsx`
**관련**: [2026-06-24_1051_라벨-멀리뒤로-가까이먼저-FOV진단.md](2026-06-24_1051_라벨-멀리뒤로-가까이먼저-FOV진단.md),
[2026-06-24_1106_오버레이-objectfit-cover정렬.md](2026-06-24_1106_오버레이-objectfit-cover정렬.md)

## 배경
cover 정렬 후에도 "멀리 뒤로 / 가까이 먼저" 잔차 동일 → 투영 수식 버그 아님(검증). 남은 원인은
**FOV(초점 f) 미스매치**(중심 기준 배율 오차 → 위/아래 반대로 벌어짐). 손으로 f 맞추는 대신
**1-클릭 보정** 추가.

## 기능
편집 모드와 별개의 **🎯 FOV(초점) 보정** 모드. POI 라벨 하나를 영상 속 **실제 위치로 드래그**하면,
그 대응점으로 focal 을 역산해 즉시 적용 → 전 거리(멀·근) 정렬.

### 역산 수식
```
px = 0.5 + cx0 + (Xc/Zc)·(f/sW),  py = 0.5 + cy0 + (Yc/Zc)·(f/sH)
a=Xc/Zc, b=Yc/Zc, u=px*-0.5-cx0, v=py*-0.5-cy0
f = ((a/sW)·u + (b/sH)·v) / ((a/sW)² + (b/sH)²)     // 두 축 공통 f 의 최소제곱
```
- f 는 가로·세로 공통 → 한 점이면 화각 배율 결정(센서·픽셀 정방, 16:9 가정).
- POI 카메라좌표는 렌더와 동일한 poiZ(드론높이 모드면 드론−이격거리, 아니면 선택 z)로 계산.
- `setParam('focalLen', clamp(10..100))` → 카메라 파라미터 패널에 반영·데이터셋별 영속화.

## 구현
- 상태 `fovMode`(+ref), `poiDroneHeightRef`/`droneHeightDropRef`(역산용).
- `onPoiPointerDown`: editMode **또는** fovMode 에서 POI 선택. 캔버스 pointer-events 도 동일 조건.
- `onPoiPointerUp`: fovMode 면 focal 역산 분기(위 수식), 아니면 기존 위치(lat/lon) 보정.
- 드래그 피드백 마커: editMode/fovMode 모두 표시.
- UI: "🎯 FOV(초점) 보정" 토글(편집 모드와 상호 배타) + 안내 InfoTip + 현재 f 표시.

## 사용법
1. 화면표시 옵션 → **🎯 FOV(초점) 보정** 클릭.
2. 멀거나 가까운 POI 하나를 **영상 속 실제 위치로 드래그**(일시정지 권장).
3. f 자동보정 → 멀·근 라벨이 함께 지물에 정렬. 값은 자동 저장.

## 한계
- z(표고)가 크게 틀리면 세로 대응에 z 오차가 섞일 수 있음 → 먼저 DEM/표고 보정 후 FOV 보정 권장.
- 한 점 기준이라, 가능하면 화면 중심에서 충분히 떨어진(위/아래) POI 로 보정하면 안정적.

## 검증
- `npm run build -w client` (node20) tsc + vite build 통과.

**소요 시간**: 약 18분
**Context 사용량**: input ~330k / output ~9k tokens
