import React, { useEffect, useRef, useState } from 'react'; type GuideLineProps = { /** 方向 forward前进 reverse倒车 */ direction: 'forward' | 'reverse'; /** 方向盘转角,单位°:左转负数,右转正数,范围建议 -45 ~ 45 */ steer: number; /** 引导线底部(车尾端)两条线间距,默认为容器宽度的 40% */ bottomGap?: number; /** 引导线顶部(远端)两条线间距,默认为容器宽度的 20% */ topGap?: number; /** 是否显示辅助线 */ visible?: boolean; }; const CarReverseGuideLine: React.FC = ({ direction, steer, bottomGap, topGap, visible = true, }) => { const canvasRef = useRef(null); const containerRef = useRef(null); const [size, setSize] = useState({ width: 0, height: 0 }); // 监听容器大小变化 useEffect(() => { if (!containerRef.current) return; const resizeObserver = new ResizeObserver((entries) => { for (const entry of entries) { const { width, height } = entry.contentRect; setSize({ width, height }); } }); resizeObserver.observe(containerRef.current); return () => resizeObserver.disconnect(); }, []); useEffect(() => { const canvas = canvasRef.current; if (!canvas || size.width === 0 || size.height === 0 || !visible) return; const ctx = canvas.getContext('2d'); if (!ctx) return; const { width, height } = size; ctx.clearRect(0, 0, width, height); // 基础参数计算 // 前向视角:下面宽(近处),上面窄(远处) // 后向视角:上面宽(远处固定点),下面窄(近处转弯点) let bGap = bottomGap || (direction === 'reverse' ? width * 0.25 : width * 0.45); let tGap = topGap || (direction === 'reverse' ? width * 0.45 : width * 0.25); const maxWheelAngle = 45; const wheelAngleRad = Math.max(-maxWheelAngle, Math.min(maxWheelAngle, steer)) * Math.PI / 180; const step = 2; // 迭代计算轨迹点函数 const getPathPoints = (side: 'left' | 'right'): [number, number][] => { const points: [number, number][] = []; const totalDist = direction === 'reverse' ? height * 0.75 : height * 0.7; const stepCount = Math.floor(totalDist / step); if (direction === 'forward') { // 前视角:底部固定,向上延伸并转向 let x = width / 2; let y = height - 20; let angle = -Math.PI / 2; for (let i = 0; i <= stepCount; i++) { const progress = i / stepCount; const currentGap = bGap * (1 - progress) + tGap * progress; const sideOffset = side === 'left' ? -currentGap / 2 : currentGap / 2; if (Math.abs(wheelAngleRad) > 0.001) { // 恢复前视转向灵敏度:使用固定曲率 const curvature = height * 0.5; const turnStepRad = (step * Math.tan(wheelAngleRad)) / curvature; angle += turnStepRad; x += Math.cos(angle) * step; y += Math.sin(angle) * step; } else { y -= step; } points.push([x + sideOffset, y]); if (y < 0) break; } } else { // 后视角:顶部固定点,向下延伸至底部并随转向摆动 // 我们从顶部 (width/2, height - totalDist) 开始向下画 let x = width / 2; let startY = height - totalDist - 20; let y = startY; let angle = Math.PI / 2; // 向下 for (let i = 0; i <= stepCount; i++) { const progress = i / stepCount; // 0 是顶部,1 是底部 // 后视角透视:progress=0(顶部)时使用 tGap,progress=1(底部)时使用 bGap const currentGap = tGap * (1 - progress) + bGap * progress; const sideOffset = side === 'left' ? currentGap / 2 : -currentGap / 2; if (Math.abs(wheelAngleRad) > 0.001) { // 转向逻辑:从顶部向下走,底部随 steer 摆动 // steer 为负(左打)时,底部应该向左摆动(x减小) const curvature = height * 0.5; // 与前视角保持一致的曲率灵敏度 const turnStepRad = (step * Math.tan(wheelAngleRad)) / curvature; angle -= turnStepRad; // 后视角向下绘制,减去增量以实现正确的左右转向 x += Math.cos(angle) * step; y += Math.sin(angle) * step; } else { y += step; } points.push([x + sideOffset, y]); } // 后视角的点是从上往下的,为了统一绘制逻辑(从下往上渐变),我们翻转数组 points.reverse(); } return points; }; // 绘制左右两条轨迹 const leftPath = getPathPoints('left'); const rightPath = getPathPoints('right'); const drawPath = (pts: [number, number][], color: string, dash: number[] = []) => { if (pts.length < 2) return; ctx.beginPath(); ctx.lineWidth = 4; ctx.strokeStyle = color; ctx.setLineDash(dash); ctx.lineJoin = 'round'; ctx.lineCap = 'round'; ctx.moveTo(pts[0][0], pts[0][1]); for (let i = 1; i < pts.length; i++) { ctx.lineTo(pts[i][0], pts[i][1]); } ctx.stroke(); }; // 渐变色绘制 const gradient = ctx.createLinearGradient(0, height, 0, 0); gradient.addColorStop(0, 'rgba(0, 255, 0, 0.8)'); // 近处绿色 gradient.addColorStop(0.5, 'rgba(255, 255, 0, 0.8)'); // 中间黄色 gradient.addColorStop(1, 'rgba(255, 0, 0, 0.8)'); // 远处红色 drawPath(leftPath, gradient); drawPath(rightPath, gradient); // ========== 横向距离标记虚线 ========== ctx.lineWidth = 2; ctx.setLineDash([10, 8]); const markCount = 4; for (let m = 1; m <= markCount; m++) { const ratio = m / (markCount + 1); const idx = Math.floor(leftPath.length * ratio); if (idx >= leftPath.length || idx >= rightPath.length) continue; const [lx, ly] = leftPath[idx]; const [rx, ry] = rightPath[idx]; // 根据距离改变颜色 ctx.strokeStyle = ratio < 0.3 ? 'rgba(0, 255, 0, 0.6)' : ratio < 0.7 ? 'rgba(255, 255, 0, 0.6)' : 'rgba(255, 0, 0, 0.6)'; ctx.beginPath(); ctx.moveTo(lx, ly); ctx.lineTo(rx, ry); ctx.stroke(); } }, [direction, steer, size, bottomGap, topGap, visible]); return (
); }; export default CarReverseGuideLine;