GhiVideo 소스 복제 — v4 작업 시작 기준

기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제.
(node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-09 14:32:51 +09:00
co-authored by Claude Fable 5
commit d38b842e8d
362 changed files with 46358 additions and 0 deletions
+941
View File
@@ -0,0 +1,941 @@
import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
import type { MouseEvent as ReactMouseEvent, RefObject } from 'react';
import type { DroneFrameBasic } from '../utils/geoProjection';
import { useGeoStore } from '../store/geoStore';
import { useSettingsStore, isGradeVisible } from '../store/settingsStore';
import {
STAGE_WIDTH,
TRACK_END_PX,
TRACK_START_PX,
TRACK_WIDTH_PX,
renderX,
trackXFromRender,
} from './mocks/route';
import { cssVars } from './utils/cssVars';
import { formatMileage } from './utils/mileage';
import { PlaybackControls } from './components/PlaybackControls/PlaybackControls';
import { Timeline } from './components/Timeline/Timeline';
import { TimelineCursor } from './components/TimelineCursor/TimelineCursor';
import styles from './StationBar.module.scss';
import './tokens.css';
/** 영상 실제 fps (RoutePanel·StationOverlay 와 동일 기준). */
const VIDEO_FPS = 30000 / 1001;
/** 프레임→현재측점 precompute 시 프레임 샘플 간격(영상 step). */
const FRAME_STEP = 10;
interface GeoPoint {
title: string;
category: string;
lat: number;
lon: number;
z: number;
type: string;
}
/** 프레임별 precompute 결과. km=배지용 최근접측점, chain=구간방향용 연속 체이니지. */
interface ViewedPoint {
frameNum: number;
km: number;
chain: number;
time: number;
}
/** 측점 폴리라인(평면 투영). 연속 체이니지 계산용. */
interface StationLine {
pts: { x: number; y: number; km: number }[];
k: number; // 경도→m 환산 (cos(lat0)*111000)
}
/** 드론 lat/lon 을 측점 폴리라인에 투영 → 연속 체이니지(m).
* 100m 양자화된 최근접측점과 달리 전진/후진 전환 시점이 실제 이동과 일치. */
function projectChainage(lat: number, lon: number, line: StationLine): number {
const px = lon * line.k;
const py = lat * 111000;
const pts = line.pts;
let bestD = Infinity;
let bestKm = pts.length ? pts[0].km : -1;
for (let i = 0; i < pts.length - 1; i++) {
const a = pts[i];
const b = pts[i + 1];
const dx = b.x - a.x;
const dy = b.y - a.y;
const L2 = dx * dx + dy * dy;
const t = L2 === 0 ? 0 : Math.max(0, Math.min(1, ((px - a.x) * dx + (py - a.y) * dy) / L2));
const cx = a.x + dx * t;
const cy = a.y + dy * t;
const d = (px - cx) ** 2 + (py - cy) ** 2;
if (d < bestD) {
bestD = d;
bestKm = a.km + (b.km - a.km) * t;
}
}
return bestKm;
}
/** 데이터 기반 트랙 구간: km 증가(dir 1, 주황) / 감소(dir -1, 하늘색). px는 시간축. */
export interface BarSegment {
startPx: number;
endPx: number;
dir: 1 | -1;
}
/** 측점값 라벨 (방향 전환점·시종점). px는 시간축. */
export interface KmLabel {
px: number;
text: string;
}
/** 구조물 마크 (교량/터널/역사). px는 통과 시점(시간축), km은 측점값(연속 체이니지, m). */
export interface StructMark {
px: number;
title: string;
category: string;
km: number;
/** 원본 속성(KMZ/CSV) — 마커 클릭 팝업 표시용. */
props?: { k: string; v: string }[];
/** 종점역인데 영상이 도착하지 못함 → 끝에 '미도착' 스타일(속 빈 링)로 표시. */
unreached?: boolean;
/** 표시 측점값이 그 위치에 실제로 존재하는가. false=좌표 반경만으로 잡힌 통과(값 라벨·검색 제외). */
kmExists?: boolean;
}
interface StationBarProps {
currentTime: number;
/** 라이브 재생시간 ref (매 프레임 갱신). 커서/진행바를 React 리렌더 없이 직접 이동. */
timeRef?: RefObject<number>;
duration: number;
playing: boolean;
onTogglePlay: () => void;
onStop: () => void;
onCapture: () => void;
onSeek: (time: number) => void;
showStations: boolean;
onToggleStations: () => void;
}
const clamp = (v: number, lo: number, hi: number): number =>
Math.min(hi, Math.max(lo, v));
function stationKm(title: string): number {
const m = title.match(/(\d+)[Kk](\d+)/);
return m ? parseInt(m[1], 10) * 1000 + parseInt(m[2], 10) : -1;
}
/** 드론 GPS 최근접 측점 km (FOV 안에 측점이 없을 때 폴백). */
function nearestStationKm(f: DroneFrameBasic, stations: GeoPoint[]): number {
let best = -1;
let bd = Infinity;
for (const st of stations) {
const d = (f.lat - st.lat) ** 2 + (f.lon - st.lon) ** 2;
if (d < bd) {
bd = d;
best = stationKm(st.title);
}
}
return best;
}
/** station 값(숫자=미터, "158k400" 문자열) → 미터. 실패 시 -1. */
function mileageToMeters(v: number | string): number {
if (typeof v === 'number') return v;
const m = String(v).match(/(\d+)\s*[kK]\s*(\d+)/);
if (m) return parseInt(m[1], 10) * 1000 + parseInt(m[2], 10);
const n = parseInt(String(v).replace(/[^0-9]/g, ''), 10);
return Number.isFinite(n) ? n : -1;
}
/** 미터값 → "158k710" (10m 단위 반올림). 커서 배지용 십단위 표시. */
function formatMileage10(m: number): string {
const r = Math.round(m / 10) * 10;
const km = Math.floor(r / 1000);
const mm = r % 1000;
return `${km}k${String(mm).padStart(3, '0')}`;
}
/**
* abcVideo 실제 영상 데이터 기반 측점 바.
* - 트랙 x축 = 프레임(시간) 진행. 구간 색 = 측점 km 증가(주황)/감소(하늘색).
* - 측점값 라벨·구조물(교량/터널/역사) = 재생 파일의 측점/POI 데이터로 배치.
* - 커서 = 프레임 진행, 배지 = 드론 GPS 최근접 측점.
* - 클릭/드래그/측점입력 seek = 시간(프레임) 기준 이동.
*/
export function StationBar({
currentTime,
timeRef,
duration,
playing,
onTogglePlay,
onStop,
onCapture,
onSeek,
showStations,
onToggleStations,
}: StationBarProps) {
const wrapRef = useRef<HTMLDivElement>(null);
const stageRef = useRef<HTMLDivElement>(null);
const [scale, setScale] = useState(0.5);
const draggingRef = useRef(false);
// 측점/POI/드론프레임은 폴더 선택으로 채워지는 geoStore에서 읽는다 (서버 /api/geo fetch 대체).
const storePois = useGeoStore((s) => s.pois);
const storeStations = useGeoStore((s) => s.stations);
const pois = useMemo<GeoPoint[]>(
() => [...storeStations, ...storePois],
[storeStations, storePois],
);
const storeFrames = useGeoStore((s) => s.frames);
const routeMeta = useGeoStore((s) => s.routeMeta);
const directionChanges = useGeoStore((s) => s.directionChanges);
// v2.0: 구조물은 geoStore.structures(CSV 03)교량/04)터널/06)구교 + route.json 보정) 를 우선 사용.
const storeStructuresRaw = useGeoStore((s) => s.structures);
// 시설종별 필터(설정 스토어) — 체크 변경 시 즉시 반영(구독).
const gradeFilter = useSettingsStore((s) => s.gradeFilter);
const poiOverlapExclude = useSettingsStore((s) => s.poiOverlapExclude);
const storeStructures = useMemo(
() => storeStructuresRaw.filter((s) => isGradeVisible(s.grade, gradeFilter)),
[storeStructuresRaw, gradeFilter],
);
const viewedRef = useRef<ViewedPoint[]>([]);
// 이동거리축: time[i] ↔ frac[i](누적 이동거리 비율 0~1, 단조 비감소).
// 드론의 '실제 이동거리'를 옆으로 펴서 배치 → 같은 측점이라도 이동량만큼 떨어져 보인다.
// 호버(드론 이동 無) 구간은 frac 정체 → 커서 정지. 방향(전진/후진)은 barSegments 색 리본으로 구분.
// 이동거리(누적) 축: time[i]↔frac[i](누적 이동거리 비율 0~1, 단조 비감소) → 커서 항상 우측 이동.
// depChain=출발측점, arrChain=도착측점 → 방향색 기준(도착방향=주황/반대=파랑).
const chainRef = useRef<{ time: Float64Array; frac: Float64Array; depChain: number; arrChain: number } | null>(null);
const [ready, setReady] = useState(false);
const stations = useMemo(
() => pois.filter((p) => p.type === 'station' && stationKm(p.title) >= 0),
[pois],
);
// 측점 폴리라인(평면 투영) — 연속 체이니지 계산용.
const stationLine = useMemo<StationLine | null>(() => {
if (!stations.length) return null;
const sorted = [...stations].sort((a, b) => stationKm(a.title) - stationKm(b.title));
const lat0 = sorted.reduce((s, p) => s + p.lat, 0) / sorted.length;
const k = Math.cos((lat0 * Math.PI) / 180) * 111000;
return {
pts: sorted.map((p) => ({ x: p.lon * k, y: p.lat * 111000, km: stationKm(p.title) })),
k,
};
}, [stations]);
// 프레임별 precompute (frames·stations 준비되면 1회).
// - km: 드론 GPS 최근접 측점 (배지 표시용, 좌측 RoutePanel 과 동일).
// - chain: 측점 폴리라인 투영 연속 체이니지 (구간 방향용, 전환 타이밍 정확).
// FPS는 고정값(29.97)이 아니라 실데이터(마지막 프레임 번호 / 재생시간)에서 유도 → 영상별 자동 적응.
// 데이터 미비 시에만 VIDEO_FPS(29.97) 폴백. (frame/fps = 절대시간)
const videoFps = useMemo<number>(() => {
const last = storeFrames.length ? storeFrames[storeFrames.length - 1].frame : 0;
return last > 0 && duration > 0 ? last / duration : VIDEO_FPS;
}, [storeFrames, duration]);
useEffect(() => {
const frames = storeFrames;
if (!frames.length || !stations.length || !stationLine) { setReady(false); return; }
const n = frames.length;
const out: ViewedPoint[] = new Array(n);
for (let i = 0; i < n; i++) {
const f = frames[i];
out[i] = {
frameNum: f.frame,
km: nearestStationKm(f, stations),
chain: projectChainage(f.lat, f.lon, stationLine),
time: f.frame / videoFps,
};
}
// 이동거리 축: 평활 측점값(±W 이동평균)의 프레임간 |Δ| 누적 = 실제 이동량 → 전체로 정규화(frac).
// 호버(이동 無)면 frac 정체 → 커서 정지. 이동하면(전진/후진 무관) frac 증가 → 커서 항상 우측.
// depChain/arrChain(앞·뒤 5% 평균)은 방향색 기준.
const W = 8; // 평활 반폭(프레임)
const pre = new Float64Array(n + 1);
for (let i = 0; i < n; i++) pre[i + 1] = pre[i] + out[i].chain;
const time = new Float64Array(n);
const sm = new Float64Array(n);
const frac = new Float64Array(n);
let cum = 0;
for (let i = 0; i < n; i++) {
const lo = Math.max(0, i - W), hi = Math.min(n, i + W + 1);
sm[i] = (pre[hi] - pre[lo]) / (hi - lo);
if (i > 0) cum += Math.abs(sm[i] - sm[i - 1]);
time[i] = out[i].time;
frac[i] = cum;
}
const total = cum > 0 ? cum : 1;
for (let i = 0; i < n; i++) frac[i] /= total;
const seg = Math.max(1, Math.floor(n * 0.05));
let dep = 0, arr = 0;
for (let i = 0; i < seg; i++) { dep += sm[i]; arr += sm[n - 1 - i]; }
dep /= seg; arr /= seg;
if (Math.abs(arr - dep) < 1) arr = dep + 1; // 퇴화 방지
chainRef.current = { time, frac, depChain: dep, arrChain: arr };
viewedRef.current = out;
setReady(true);
}, [stations, stationLine, storeFrames, videoFps]);
/** 현재 시간에 가장 가까운 precompute 인덱스. */
const viewedIdxAtTime = useCallback((t: number): number => {
const arr = viewedRef.current;
if (!arr.length) return -1;
const target = t * videoFps;
let best = 0;
let bd = Math.abs(arr[0].frameNum - target);
for (let i = 1; i < arr.length; i++) {
const d = Math.abs(arr[i].frameNum - target);
if (d < bd) {
bd = d;
best = i;
}
}
return best;
}, [videoFps]);
// 현재 보는 측점값 — 연속 체이니지(chain)로 10m 해상도 (km 필드는 100m 양자화).
const realChain = useMemo<number | null>(() => {
if (!ready) return null;
const idx = viewedIdxAtTime(currentTime);
return idx >= 0 ? viewedRef.current[idx].chain : null;
}, [currentTime, ready, viewedIdxAtTime]);
// 종점역 '미도착' 폭(px) — 영상이 종점역 도착 전 끝날 때, 트랙 우측에 이만큼 비워둔다.
// 영상 타임라인은 [START … ENDendGapPx] 에만 매핑되고, 종점역 마커는 END(미도착)에 둔다.
// 폭 = 미도착거리(m) / 노선길이(m) × 트랙폭 (옵션 2: 실제 비례). 안전상 15%로 상한.
const endGapPx = useMemo<number>(() => {
const gapM = routeMeta?.routeInfo?.endStationGapMeters ?? 0;
const lenM = (routeMeta?.routeInfo?.lengthKm ?? 0) * 1000;
if (gapM <= 0 || lenM <= 0) return 0;
return Math.min(TRACK_WIDTH_PX * 0.15, (gapM / lenM) * TRACK_WIDTH_PX);
}, [routeMeta]);
// 시간→px 변환에 쓰는 유효 트랙폭 (미도착폭 제외).
const timeTrackWidth = TRACK_WIDTH_PX - endGapPx;
// 노선 진행방향 '상'|'하' — 동명 시설물의 (상)/(하) 변형 중 어느 쪽을 바에 표출할지 결정.
// 1순위 route.json direction, 없으면 directionChanges(상행↔하행 전환점)에서 가장 오래 지속된 방향.
const routeDirCh = useMemo<'상' | '하' | null>(() => {
const d = routeMeta?.routeInfo?.direction ?? '';
const up = d.includes('상'), down = d.includes('하');
if (up && !down) return '상';
if (down && !up) return '하';
const dc = directionChanges;
if (dc && dc.length && duration > 0) {
const acc: Record<string, number> = {};
let prevT = 0;
let cur = dc[0].from;
for (const c of dc) {
acc[cur] = (acc[cur] ?? 0) + Math.max(0, c.atSeconds - prevT);
prevT = c.atSeconds;
cur = c.to;
}
acc[cur] = (acc[cur] ?? 0) + Math.max(0, duration - prevT);
let best = '', bv = -1;
for (const k in acc) if (acc[k] > bv) { bv = acc[k]; best = k; }
if (best.includes('상') && !best.includes('하')) return '상';
if (best.includes('하') && !best.includes('상')) return '하';
}
return null;
}, [routeMeta, directionChanges, duration]);
// 진행도(이동거리축): 시간 t → 누적 이동거리 비율(frac, 0~1). chainRef 미준비 시 시간선형 폴백.
const cumFracAtTime = useCallback(
(t: number): number => {
const c = chainRef.current;
if (!c || !ready || duration <= 0)
return duration > 0 ? clamp(t / duration, 0, 1) : 0;
const { time, frac } = c;
const n = time.length;
if (n === 0) return 0;
if (t <= time[0]) return frac[0];
if (t >= time[n - 1]) return frac[n - 1];
let lo = 0, hi = n - 1;
while (hi - lo > 1) { const m = (lo + hi) >> 1; if (time[m] <= t) lo = m; else hi = m; }
const span = time[hi] - time[lo];
const r = span > 0 ? (t - time[lo]) / span : 0;
return frac[lo] + (frac[hi] - frac[lo]) * r;
},
[ready, duration],
);
// 역변환(이동거리 비율 → 시간): 바 클릭 seek 용. frac 단조 비감소 → 이진 탐색.
const timeAtFrac = useCallback(
(f: number): number => {
const c = chainRef.current;
if (!c || !ready || duration <= 0) return clamp(f, 0, 1) * duration;
const { time, frac } = c;
const n = frac.length;
if (n === 0) return 0;
const ff = clamp(f, 0, 1);
if (ff <= frac[0]) return time[0];
if (ff >= frac[n - 1]) return time[n - 1];
let lo = 0, hi = n - 1;
while (hi - lo > 1) { const m = (lo + hi) >> 1; if (frac[m] <= ff) lo = m; else hi = m; }
const span = frac[hi] - frac[lo];
const r = span > 0 ? (ff - frac[lo]) / span : 0;
return time[lo] + (time[hi] - time[lo]) * r;
},
[ready, duration],
);
// ── 데이터 기반 측점 바 ──────────────────────────────────────────
// 시간(프레임) → 트랙 px (이동거리축). 커서·구간색·구조물 마커가 이 매핑을 공유한다.
const pxAtTime = useCallback(
(t: number): number =>
TRACK_START_PX + clamp(cumFracAtTime(t), 0, 1) * timeTrackWidth,
[cumFracAtTime, timeTrackWidth],
);
// 커서 위치 = 이동거리축 진행도 → 전진/후진 무관하게 항상 우측으로 이동. 색만 방향에 따라 바뀜.
const progressPx = pxAtTime(currentTime);
const cursorPx = progressPx;
// 커서 배지 = 폴더 데이터 기반 연속 체이니지(realChain)를 10m 단위로 표시. 데이터 없으면 빈 문자열.
const cursorText =
realChain !== null && realChain >= 0 ? formatMileage10(realChain) : '';
// viewedRef(프레임→측점 km) 추이로 구간 색·전환점 산출.
// km 증가 구간 = dir 1(주황), 감소 구간 = dir -1(하늘색). HYST로 최근접 지터 무시.
const { barSegments, kmLabels } = useMemo<{
barSegments: BarSegment[];
kmLabels: KmLabel[];
}>(() => {
const arr = viewedRef.current;
const n = arr.length;
if (!ready || !n || duration <= 0)
return { barSegments: [], kmLabels: [] };
// 측점값(chain)을 ±W 이동평균으로 평활 → GPS 지터 제거. 평활했으므로 HYST를 작게 잡아
// '목적지에 가까워짐/멀어짐'의 작은 추세 전환(20m+)도 구간으로 잡는다. (커서 배지 = 그 구간 색)
const W = 8;
const pre = new Float64Array(n + 1);
for (let i = 0; i < n; i++) pre[i + 1] = pre[i] + arr[i].chain;
const sm = new Float64Array(n);
for (let i = 0; i < n; i++) {
const lo = Math.max(0, i - W), hi = Math.min(n, i + W + 1);
sm[i] = (pre[hi] - pre[lo]) / (hi - lo);
}
const HYST = 10; // m — 평활 후 기준. 이 이상 반대로 움직이면 방향(가까워짐↔멀어짐) 전환.
const segs: BarSegment[] = [];
const bounds: { chain: number; time: number; turn: boolean }[] = [
{ chain: sm[0], time: arr[0].time, turn: false },
];
// 시작 방향을 실제 데이터(첫 유의미 이동)로 판정.
let dir: 1 | -1 = 1;
for (let i = 1; i < n; i++) {
const d = sm[i] - sm[0];
if (Math.abs(d) >= HYST) { dir = d > 0 ? 1 : -1; break; }
}
let extCh = sm[0];
let extIdx = 0;
let startIdx = 0;
for (let i = 1; i < n; i++) {
const c = sm[i];
if (dir > 0 ? c > extCh : c < extCh) {
extCh = c;
extIdx = i;
} else if (dir > 0 ? extCh - c >= HYST : c - extCh >= HYST) {
segs.push({
startPx: pxAtTime(arr[startIdx].time),
endPx: pxAtTime(arr[extIdx].time),
dir,
});
bounds.push({ chain: extCh, time: arr[extIdx].time, turn: true });
dir = dir > 0 ? -1 : 1;
startIdx = extIdx;
extCh = c;
extIdx = i;
}
}
segs.push({
startPx: pxAtTime(arr[startIdx].time),
endPx: pxAtTime(arr[n - 1].time),
dir,
});
bounds.push({ chain: sm[n - 1], time: arr[n - 1].time, turn: false });
// 전환(턴) 지점은 실제 위치를 10m 단위로, 시·종점 등 기본 라벨은 100m 단위로 표시.
const labels: KmLabel[] = bounds.map((b) => ({
px: pxAtTime(b.time),
text: b.turn ? formatMileage10(b.chain) : formatMileage(Math.round(b.chain / 100) * 100),
}));
return { barSegments: segs, kmLabels: labels };
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [ready, duration, storeFrames, pxAtTime]);
// viewedRef의 km(최근접 측점)가 주어진 mileage(m)에 가장 가까운 프레임 시간 → px.
const pxAtMileage = useCallback(
(mileage: number): number | null => {
const arr = viewedRef.current;
if (!arr.length) return null;
let best = -1;
let bd = Infinity;
for (let i = 0; i < arr.length; i++) {
const d = Math.abs(arr[i].km - mileage);
if (d < bd) {
bd = d;
best = i;
}
}
return best >= 0 ? pxAtTime(arr[best].time) : null;
},
[pxAtTime],
);
// 구조물(교량/터널/역사) 위치 = 실제 좌표(POI 위경도)에 드론 GPS 가 가장 가까워지는
// 프레임의 시점 px. → 영상에 구조물이 실제 지나가는 순간과 일치.
// route.json structures 의 이정값은 매칭되는 POI 가 없을 때만 폴백으로 사용.
const structureMarks = useMemo<StructMark[]>(() => {
const arr = viewedRef.current;
const frames = storeFrames;
if (!ready || !arr.length || duration <= 0 || !frames.length) return [];
// 실좌표(lat/lon)에 드론이 가까워지는 '모든 통과 구간'의 px 목록.
// (드론이 같은 구조물을 2번 이상 지날 때 각 통과마다 마커를 찍기 위함)
const pxPassesTo = (lat: number, lon: number, offsetM = 0): { px: number; km: number }[] => {
const cosLat = Math.cos((lat * Math.PI) / 180);
const ds: number[] = new Array(frames.length);
let gmin = Infinity;
for (let i = 0; i < frames.length; i++) {
const dy = (frames[i].lat - lat) * 111000;
const dx = (frames[i].lon - lon) * 111000 * cosLat;
const d = Math.hypot(dx, dy); // m
ds[i] = d;
if (d < gmin) gmin = d;
}
if (!isFinite(gmin)) return [];
const TH = Math.max(100, gmin * 3); // 통과 인정 거리(m)
// 통과 프레임에서 진행방향으로 offsetM 만큼 이동(GPS 누적거리 기준).
const shift = (idx: number): number => {
if (!offsetM) return idx;
const step = offsetM >= 0 ? 1 : -1;
const target = Math.abs(offsetM);
let fi = idx, acc = 0;
while (acc < target) {
const n = fi + step;
if (n < 0 || n >= frames.length) break;
const dy = (frames[n].lat - frames[fi].lat) * 111000;
const dx = (frames[n].lon - frames[fi].lon) * 111000 * cosLat;
acc += Math.hypot(dx, dy);
fi = n;
}
return fi;
};
const out: { px: number; km: number }[] = [];
let i = 0;
while (i < frames.length) {
if (ds[i] < TH) {
let j = i, bj = i, bd = ds[i];
while (j < frames.length && ds[j] < TH) {
if (ds[j] < bd) { bd = ds[j]; bj = j; }
j++;
}
const fi = shift(bj);
const px = pxAtTime(frames[fi].frame / videoFps);
if (px !== null) out.push({ px, km: viewedRef.current[fi]?.chain ?? -1 });
i = j;
} else i++;
}
return out;
};
// 측점값(미터)에 해당하는 모든 통과 지점 px (연속 체이니지 기준).
const pxPassesAtMileage = (targetM: number): { px: number; km: number }[] => {
const arr = viewedRef.current;
if (!arr.length) return [];
// 측점 인정 범위(m): route.json routeInfo.stationTolerance (폴더별), 기본 20.
// 너무 크면 인접 통과가 합쳐져 마커가 밀린다 → 멀리 떨어진 통과만 안 잡힐 때 폴더에서 키울 것.
const TH = routeMeta?.routeInfo?.stationTolerance ?? 20;
const out: { px: number; km: number }[] = [];
let i = 0;
while (i < arr.length) {
if (Math.abs(arr[i].chain - targetM) < TH) {
let j = i, bj = i, bd = Math.abs(arr[i].chain - targetM);
while (j < arr.length && Math.abs(arr[j].chain - targetM) < TH) {
const d = Math.abs(arr[j].chain - targetM);
if (d < bd) { bd = d; bj = j; }
j++;
}
const px = pxAtTime(arr[bj].time);
if (px !== null) out.push({ px, km: targetM });
i = j;
} else i++;
}
return out;
};
// 구조물 후보 POI(교량/터널/역사) base 이름 → 실좌표.
const cats = new Set(['교량', '터널', '역사']);
const poiByName = new Map<string, { lat: number; lon: number; category: string }>();
for (const p of pois) {
if (!cats.has(p.category)) continue;
const base = p.title.replace(/\s*[(].*$/, '').trim();
if (!poiByName.has(base)) poiByName.set(base, { lat: p.lat, lon: p.lon, category: p.category });
}
// 실제 통과 마커는 '이동/삭제 없이' 직교 통과 위치에 그대로 둔다(드론이 종점 야드에서 162080을
// 여러 번 지나면 각 통과 자리에 마커 유지 → 검색과 일치).
// 종점(최우측 역사)이 '미도착'(endGapPx>0)이면, 기존 마커를 옮기지 않고 트랙 끝(TRACK_END,
// 실제 종점 측점 위치)에 '미도착' 종점 마커를 하나 '추가'한다. → 드론이 못 간 종점 162080도
// 끝에 표시되고, 지나간 162080 통과들도 실제 위치에 그대로 남는다.
const placeUnreachedTerminal = (marks: StructMark[]): StructMark[] => {
if (endGapPx <= 0) return marks;
let hiPx = -Infinity;
let term: StructMark | null = null;
for (const m of marks) {
if ((m.category === '역사' || m.category === '역') && m.px > hiPx) { hiPx = m.px; term = m; }
}
if (term) marks.push({ ...term, px: TRACK_END_PX, unreached: true });
return marks;
};
// 경로상 시설물만: 시설물명에 방향표기((상…/(하…)가 있으면 영상 진행방향과 일치하는 것만.
// 하행이면 '(상…' 제외, 상행이면 '(하…' 제외. (예: 회덕천교(상)/(상인상)은 하행 영상에서 숨김)
// 진행방향(routeDirCh)의 반대 변형은 바에서 제외 → 상행이면 (상), 하행이면 (하) 만 남는다.
const oppDirCh = routeDirCh === '하' ? '상' : routeDirCh === '상' ? '하' : '';
const isOppositeDir = (name: string): boolean =>
!!oppDirCh && new RegExp(`[(]${oppDirCh}`).test(name);
// v2.0: CSV 유래 구조물(storeStructures) 우선. route.json 보정은 geoData 에서 이미 병합됨.
if (storeStructures && storeStructures.length) {
const out: StructMark[] = [];
for (const s of storeStructures) {
// 구교(06)는 영상 오버레이에 표출 → 스테이션바에서는 제외(교량/터널만).
if (s.category === '구교') continue;
if (isOppositeDir(s.name)) continue; // 반대 방향(다른 선로) 시설물 제외
const cat = s.type === 'tunnel' ? '터널' : s.type === 'bridge' ? '교량' : '역사';
const sBase = s.name.replace(/\s*[(].*$/, '').trim();
// 이름 매칭 POI 실좌표 우선 → 없으면 route.json 이정값 폴백.
const match =
poiByName.get(sBase) ??
[...poiByName.entries()].find(([k]) => k.includes(sBase) || sBase.includes(k))?.[1];
// 우선순위: station(측점값) → 좌표를 측점선에 투영한 '측점 기준' 탐지 → 좌표 근접(최후 폴백) → 이정값.
// 각 통과 지점마다 마커(드론이 2번 지나면 2개). 동명 시설물은 각자 station 으로 구분.
// ※ 좌표 근접(pxPassesTo)은 출발점 부근 등에서 엉뚱한 '조기 통과'를 잡아 마커가 앞쪽(좌측)으로
// 잘못 배치될 수 있다 → 좌표를 측점값으로 환산해 station-기준으로 탐지하면 실제 통과순서와 일치.
let passes: { px: number; km: number }[] = [];
const off = s.offset ?? 0;
if (s.station != null) {
const sM = mileageToMeters(s.station);
if (sM >= 0) passes = pxPassesAtMileage(sM);
}
if (!passes.length && s.lat != null && s.lon != null && stationLine)
passes = pxPassesAtMileage(projectChainage(s.lat, s.lon, stationLine));
if (!passes.length && match && stationLine)
passes = pxPassesAtMileage(projectChainage(match.lat, match.lon, stationLine));
// 역사(역)은 좌표근접(pxPassesTo) 폴백을 쓰지 않는다 → '드론 실제 측점(chain)이 역 측점과
// 일치(pxPassesAtMileage)'하는 통과에서만 마커를 찍는다. 그래야:
// ① 좌표만 가까운(측점 다른) 조차장 재진입(드론 162k210인데 대전조차장 162k080)은 안 찍히고,
// ② 진짜 162k080 통과에는 정상적으로 찍힌다. (교량/터널만 좌표근접 폴백 허용.)
if (!passes.length && cat !== '역사' && s.lat != null && s.lon != null) passes = pxPassesTo(s.lat, s.lon, off);
if (!passes.length && cat !== '역사' && match) passes = pxPassesTo(match.lat, match.lon, off);
if (!passes.length && s.startMileage != null && s.endMileage != null) {
const mid = (s.startMileage + s.endMileage) / 2;
const px = pxAtMileage(mid);
if (px !== null) passes = [{ px, km: mid }];
}
// 역사 km 라벨 = '역 좌표 자체'의 측점값(드론 최근접 프레임 chain 아님).
// 역은 바 양끝에 스냅되므로, 시작/끝 커서값(= 역 위치 측점)과 일치시키기 위함.
const stationKmVal = cat === '역사' && s.lat != null && s.lon != null && stationLine
? projectChainage(s.lat, s.lon, stationLine) : null;
const existTol = routeMeta?.routeInfo?.stationTolerance ?? 20;
for (const p of passes) {
// 이 통과들은 pxPassesAtMileage(측점 일치) 또는 이정값 기반이라 이미 '실제 측점 일치' 통과.
// (역사는 좌표근접 폴백을 위에서 배제.) kmExists 는 라벨/검색 참고용으로만 유지.
const kmExists = stationKmVal == null || Math.abs(p.km - stationKmVal) <= existTol;
out.push({ px: p.px, title: s.name, category: cat, km: stationKmVal ?? p.km, kmExists, props: s.props });
}
}
return placeUnreachedTerminal(out);
}
// 폴백: POI category 기반 (실좌표 GPS 근접, 모든 통과).
const out: StructMark[] = [];
for (const [base, info] of poiByName) {
if (isOppositeDir(base)) continue; // 반대 방향(다른 선로) 시설물 제외
const stationKmVal = info.category === '역사' && stationLine
? projectChainage(info.lat, info.lon, stationLine) : null;
const existTol = routeMeta?.routeInfo?.stationTolerance ?? 20;
// 측점 기준 탐지 우선(통과순서 정확), 측점선 없으면 좌표 근접 폴백.
const ps = stationLine
? pxPassesAtMileage(projectChainage(info.lat, info.lon, stationLine))
: pxPassesTo(info.lat, info.lon);
for (const p of ps) {
const kmExists = stationKmVal == null || Math.abs(p.km - stationKmVal) <= existTol;
out.push({ px: p.px, title: base, category: info.category, km: stationKmVal ?? p.km, kmExists });
}
}
return placeUnreachedTerminal(out);
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [ready, duration, storeFrames, pois, stations, pxAtTime, routeMeta, routeDirCh, storeStructures, pxAtMileage, endGapPx, stationLine, videoFps]);
// 여정 정방향(목적지=도착 방향): 측점값이 출발(depChain)→도착(arrChain) 으로 변하는 방향.
// 그 방향으로 움직이는 구간=정방향(황색), 반대=역방향(청색).
const forwardDir = useMemo<1 | -1>(() => {
const c = chainRef.current;
if (!ready || !c) return 1;
return c.arrChain >= c.depChain ? 1 : -1;
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [ready, storeFrames]);
// 방향 색 트랙 gradient — 이동거리축은 구간 px가 좌→우 단조라 gradient 1장으로 충분(경량).
// 정방향(도착방향)=FWD, 역방향=BWD. 구간 경계는 하드 스톱.
const buildGradient = useCallback(
(FWD: string, BWD: string): string => {
const segs = barSegments;
if (!segs.length) return '';
const col = (d: 1 | -1) => (d === forwardDir ? FWD : BWD);
const pct = (px: number) => clamp(((px - TRACK_START_PX) / TRACK_WIDTH_PX) * 100, 0, 100);
const stops: string[] = [`${col(segs[0].dir)} 0%`];
for (let i = 1; i < segs.length; i++) {
const bp = pct(segs[i].startPx).toFixed(2);
stops.push(`${col(segs[i - 1].dir)} ${bp}%`);
stops.push(`${col(segs[i].dir)} ${bp}%`);
}
stops.push(`${col(segs[segs.length - 1].dir)} 100%`);
return `linear-gradient(to right, ${stops.join(', ')})`;
},
[barSegments, forwardDir],
);
// 통과 음영(구간마다 좌→우 3색). 정방향 주황 / 역방향 청록.
const buildShaded = useCallback(
(fwd: [string, string, string], bwd: [string, string, string]): string => {
const segs = barSegments;
if (!segs.length) return '';
const cols = (d: 1 | -1) => (d === forwardDir ? fwd : bwd);
const pct = (px: number) => clamp(((px - TRACK_START_PX) / TRACK_WIDTH_PX) * 100, 0, 100);
const stops: string[] = [];
for (const s of segs) {
const a = pct(s.startPx), b = pct(s.endPx), c = cols(s.dir);
stops.push(`${c[0]} ${a.toFixed(2)}%`);
stops.push(`${c[1]} ${((a + b) / 2).toFixed(2)}%`);
stops.push(`${c[2]} ${b.toFixed(2)}%`);
}
return `linear-gradient(to right, ${stops.join(', ')})`;
},
[barSegments, forwardDir],
);
// 통과(지나간): 음영. 미통과: 단색(정방향 회색 / 역방향 청회색).
const trackGradient = useMemo(
() => buildShaded(['#ffc257', '#ff8a25', '#ff7b1b'], ['#5ca887', '#35a7a7', '#06a4c8']),
[buildShaded],
);
const trackGradientIdle = useMemo(() => buildGradient('#7a7a7a', '#637789'), [buildGradient]);
// 방향(색)이 바뀌는 전환점 px — 구분선 위치.
const dividers = useMemo(() => barSegments.slice(1).map((s) => s.startPx), [barSegments]);
// 커서 배지 색 = 현재 위치한 '구간' 색과 동일(바 배경과 일치). 역방향(목적지 반대) 구간이면 파란색.
// → 배지·바 배경이 항상 같은 색(기존 방식). 구간 색은 forwardDir 기준 정/역방향.
const currentReverse = useMemo<boolean>(() => {
for (const s of barSegments) {
if (cursorPx >= s.startPx && cursorPx <= s.endPx) return s.dir !== forwardDir;
}
return false;
}, [barSegments, cursorPx, forwardDir]);
// 컨테이너 폭 기준 균등 스케일
useEffect(() => {
const el = wrapRef.current;
if (!el) return;
const update = (): void =>
setScale((el.clientWidth || STAGE_WIDTH) / STAGE_WIDTH);
update();
const ro = new ResizeObserver(update);
ro.observe(el);
return () => ro.disconnect();
}, []);
// 구조물 아이콘(3-slice PNG) 상태별 이미지를 미리 로드해, passed 전환 시
// 새 이미지 로딩으로 인한 깜빡임(잠시 사라짐)을 방지한다.
useEffect(() => {
const base = import.meta.env.BASE_URL;
for (const type of ['bridge', 'tunnel']) {
for (const st of ['upcoming', 'passed', 'revisit']) {
for (const slice of ['left', 'center', 'right']) {
const img = new Image();
img.src = `${base}assets/route-segment/${type}/${type}-${st}-${slice}.png`;
}
}
}
for (const st of ['upcoming', 'passed', 'revisit']) {
const img = new Image();
img.src = `${base}assets/route-segment/terminal/circle-${st}.png`;
}
}, []);
// 커서/진행바 매끄러운 이동: 라이브 시간(timeRef)을 매 프레임 읽어 CSS 변수만 직접 갱신.
// React 리렌더(배지/색)는 currentTime(throttle)으로 별도 처리 → 4K 디코딩 중에도 부드러움.
useEffect(() => {
if (!timeRef) return;
let raf = 0;
const tick = (): void => {
const el = wrapRef.current;
if (el && duration > 0) {
const t = timeRef.current ?? 0;
const pos = pxAtTime(t); // 이동거리축: 현재 진행도 → px
el.style.setProperty('--pos-px', `${pos}px`);
el.style.setProperty('--cursor-x', `${renderX(pos)}px`);
}
raf = requestAnimationFrame(tick);
};
raf = requestAnimationFrame(tick);
return () => cancelAnimationFrame(raf);
}, [timeRef, duration, pxAtTime]);
// 클릭/드래그 트랙 px → 이동거리 비율 → 시간(역변환)으로 seek (이동거리축 일관).
const seekToTrackX = useCallback(
(trackX: number) => {
if (duration <= 0) return;
const px = clamp(trackX, TRACK_START_PX, TRACK_END_PX);
const targetTime = timeAtFrac((px - TRACK_START_PX) / timeTrackWidth);
onSeek(clamp(targetTime, 0, duration));
},
[duration, onSeek, timeTrackWidth, timeAtFrac],
);
const seekFromClientX = useCallback(
(clientX: number) => {
const stage = stageRef.current;
if (!stage) return;
const rect = stage.getBoundingClientRect();
const stageX = ((clientX - rect.left) / rect.width) * STAGE_WIDTH;
seekToTrackX(trackXFromRender(stageX));
},
[seekToTrackX],
);
useEffect(() => {
const move = (e: globalThis.MouseEvent): void => {
if (draggingRef.current) seekFromClientX(e.clientX);
};
const up = (): void => {
draggingRef.current = false;
};
window.addEventListener('mousemove', move);
window.addEventListener('mouseup', up);
return () => {
window.removeEventListener('mousemove', move);
window.removeEventListener('mouseup', up);
};
}, [seekFromClientX]);
const handleSeekDown = useCallback(
(e: ReactMouseEvent<HTMLDivElement>) => {
draggingRef.current = true;
seekFromClientX(e.clientX);
},
[seekFromClientX],
);
// 터미널 역명: route.json routeInfo.startStationName/endStationName 값. 없으면 측점 첫/끝 폴백.
const { startStationName, endStationName } = useMemo(() => {
const sorted = [...stations].sort(
(a, b) => stationKm(a.title) - stationKm(b.title),
);
const firstTitle = sorted.length ? sorted[0].title : '';
const lastTitle = sorted.length ? sorted[sorted.length - 1].title : '';
return {
startStationName: routeMeta?.routeInfo?.startStationName ?? firstTitle,
endStationName: routeMeta?.routeInfo?.endStationName ?? lastTitle,
};
}, [stations, routeMeta]);
// 측점입력(예: 158k200) → 그 측점을 보는(최근접) 프레임으로 seek (실데이터 기반).
// 해당 영상이 커버하는 측점(체이니지) 범위 밖이면 무시(seek 안 함).
// 측점 검색 순환 상태 — 같은 측점값을 연속 Enter 할 때 '직전 점프 위치'에서 다음으로 이어가기 위함.
const jumpRef = useRef<{ km: number; time: number } | null>(null);
const handleJumpToMileage = useCallback(
(km: number) => {
const arr = viewedRef.current;
if (!arr.length || duration <= 0) return false;
// 커버 측점 범위 산출 (구간 밖 입력은 무시).
let lo = Infinity, hi = -Infinity;
for (let i = 0; i < arr.length; i++) {
const c = arr[i].chain;
if (c < lo) lo = c;
if (c > hi) hi = c;
}
const MARGIN = 20;
if (km < lo - MARGIN || km > hi + MARGIN) return false;
// 측점 검색은 '드론의 실제 투영 측점(chain)' 기준으로만 이동한다(마커에 '표시된' 라벨 기준 아님).
// → 입력값과 허용오차(stationTolerance 기본 20m) 안인 프레임들을 '연속구간=1통과'로 묶어,
// 그 통과 지점들로만 순환 이동. 표시 라벨만 162080이고 실제 위치는 다른(예: 162210 조차장
// 좌표근접) 마커로는 절대 튀지 않는다.
// 통과가 0개면(그 측점을 실제로 안 지남) 이동하지 않고 false → 입력창에 '측점 없음' 안내.
const TOL = routeMeta?.routeInfo?.stationTolerance ?? 20;
const times: number[] = [];
{
let i = 0;
while (i < arr.length) {
if (Math.abs(arr[i].chain - km) < TOL) {
let j = i, bj = i, bd = Math.abs(arr[i].chain - km);
while (j < arr.length && Math.abs(arr[j].chain - km) < TOL) {
const d = Math.abs(arr[j].chain - km);
if (d < bd) { bd = d; bj = j; }
j++;
}
times.push(arr[bj].time);
i = j;
} else i++;
}
}
if (!times.length) return false;
// 시간 오름차순 + 근접 중복 제거(같은 통과가 두 경로/마커로 잡힌 경우).
times.sort((a, b) => a - b);
const passes: number[] = [];
for (const t of times) if (!passes.length || t - passes[passes.length - 1] > 0.3) passes.push(t);
// 기준 시각: 같은 측점을 '직전 점프 위치 그대로'에서 다시 Enter 하면 연속(다음 통과),
// 재생/클릭으로 커서가 움직였거나 다른 측점이면 현재 커서(라이브) 시각에서 새로 시작.
const liveT = timeRef?.current ?? currentTime;
const same = !!jumpRef.current
&& Math.abs(jumpRef.current.km - km) < 1e-6
&& Math.abs(liveT - jumpRef.current.time) < 0.1;
const baseT = same ? jumpRef.current!.time : liveT;
// 통과방향(시간 증가)으로 baseT 다음 통과. 끝까지 가면 처음으로 순환.
const EPS = 1e-3;
const target = passes.find((t) => t > baseT + EPS) ?? passes[0];
jumpRef.current = { km, time: target };
onSeek(clamp(target, 0, duration));
return true;
},
[duration, onSeek, routeMeta, currentTime, timeRef],
);
return (
<div
ref={wrapRef}
className={styles.wrap}
style={cssVars({ '--bar-scale': scale })}
>
<div ref={stageRef} className={styles.layer}>
<div className={styles.bottomBar}>
<PlaybackControls
playing={playing}
onTogglePlay={onTogglePlay}
onStop={onStop}
onCapture={onCapture}
onJumpToMileage={handleJumpToMileage}
lineOn={showStations}
onToggleLine={onToggleStations}
/>
<Timeline
posPx={cursorPx}
onSeekDown={handleSeekDown}
trackGradient={trackGradient}
trackGradientIdle={trackGradientIdle}
dividers={dividers}
kmLabels={kmLabels}
structures={structureMarks}
startStationName={startStationName}
endStationName={endStationName}
endGapPx={endGapPx}
routeDir={routeDirCh}
overlapExclude={poiOverlapExclude}
/>
</div>
<TimelineCursor
mileageText={cursorText}
reverse={currentReverse}
onSeekDown={handleSeekDown}
/>
</div>
</div>
);
}