namespace XP.ImageProcessing.Core.Alignment; /// /// 将示教图(模板坐标系)上的 ROI 点变换到运行图坐标。 /// 旋转中心与模板匹配一致:绕 /(pattern 中心)。 /// public static class RoiAlignment { /// /// 刚体变换:示教图点 → 运行图点。 /// :示教图上的基准位姿; /// :运行图匹配位姿。 /// public static Point2D TransformPoint(Point2D point, Pose2D reference, Pose2D measured) { double dTheta = DegreesToRadians(measured.AngleDegrees - reference.AngleDegrees); double cos = Math.Cos(dTheta); double sin = Math.Sin(dTheta); double dx = point.X - reference.X; double dy = point.Y - reference.Y; return new Point2D( measured.X + cos * dx - sin * dy, measured.Y + sin * dx + cos * dy); } public static Point2D TransformPoint(double x, double y, Pose2D reference, Pose2D measured) => TransformPoint(new Point2D(x, y), reference, measured); /// 变换多边形顶点(顺序不变)。 public static Point2D[] TransformPolygon(IReadOnlyList templatePoints, Pose2D reference, Pose2D measured) { if (templatePoints == null || templatePoints.Count == 0) return Array.Empty(); var result = new Point2D[templatePoints.Count]; for (int i = 0; i < templatePoints.Count; i++) result[i] = TransformPoint(templatePoints[i], reference, measured); return result; } /// 变换后四舍五入为整型顶点,供 BGA 等算子 PolyX/PolyY 注入。 public static (int X, int Y)[] TransformPolygonToInt( IReadOnlyList templatePoints, Pose2D reference, Pose2D measured) { var transformed = TransformPolygon(templatePoints, reference, measured); var result = new (int X, int Y)[transformed.Length]; for (int i = 0; i < transformed.Length; i++) { result[i] = ( (int)Math.Round(transformed[i].X, MidpointRounding.AwayFromZero), (int)Math.Round(transformed[i].Y, MidpointRounding.AwayFromZero)); } return result; } /// 变换轴对齐矩形为四个顶点(左上、右上、右下、左下)。 public static Point2D[] TransformRect(double x, double y, double width, double height, Pose2D reference, Pose2D measured) { var corners = new[] { new Point2D(x, y), new Point2D(x + width, y), new Point2D(x + width, y + height), new Point2D(x, y + height) }; return TransformPolygon(corners, reference, measured); } /// /// 校验匹配结果四角质心是否与 Center 一致(用于确认库的中心/角度约定)。 /// public static bool IsMatchCenterConsistentWithCorners( double centerX, double centerY, double ltX, double ltY, double rtX, double rtY, double rbX, double rbY, double lbX, double lbY, double tolerancePixels = 1.0) { double cx = (ltX + rtX + rbX + lbX) * 0.25; double cy = (ltY + rtY + rbY + lbY) * 0.25; double dx = cx - centerX; double dy = cy - centerY; return dx * dx + dy * dy <= tolerancePixels * tolerancePixels; } private static double DegreesToRadians(double degrees) => degrees * (Math.PI / 180.0); }