修复注释乱码

XP.ImageProcessing.Processors/检测分析/BgaVoidRateProcessor.cs

@@ -1,25 +1,25 @@
 // ============================================================================
 // Copyright © 2026 Hexagon Technology Center GmbH. All Rights Reserved.
-// 文件� BgaVoidRateProcessor.cs
-// �述: BGA 空洞率检测算�（两步自动检测法�
+// 文件名: BgaVoidRateProcessor.cs
+// 描述: BGA 空洞率检测算子（两步自动检测法）
 //
 // 处理流程:
-//   第一��焊�定�: 高斯模糊 �Otsu��二值化 �闭���轮廓检��圆度过滤 �椭圆拟�
-//   第二��气泡检� 焊�轮廓掩� ��阈值分��轮廓检���积过滤 �气泡率计�
+//   第一步 — 焊球定位: 高斯模糊 → Otsu反向二值化 → 闭运算 → 轮廓检测 → 圆度过滤 → 椭圆拟合
+//   第二步 — 气泡检测: 焊球轮廓掩码 → 双阈值分割 → 轮廓检测 → 面积过滤 → 气泡率计算
 //
 // 支持多边形ROI限定检测区域，支持IPC-7095标准PASS/FAIL判定
-// 正片模�：焊�暗区域，气泡=亮区�
+// 正片模式：焊球=暗区域，气泡=亮区域
 //
-// 作� �伟 wei.lw.li@hexagon.com
+// 作者: 李伟 wei.lw.li@hexagon.com
 // ============================================================================
 
 using Emgu.CV;
 using Emgu.CV.CvEnum;
 using Emgu.CV.Structure;
 using Emgu.CV.Util;
+using XP.ImageProcessing.Core;
 using Serilog;
 using System.Drawing;
-using XP.ImageProcessing.Core;
 
 namespace XP.ImageProcessing.Processors;
 
@@ -43,7 +43,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
             LocalizationHelper.GetString("BgaVoidRateProcessor_RoiMode_Desc"),
             new string[] { "None", "Polygon" }));
 
-        // 多边形ROI点数和�标（由UI注入，���，最多支�2个点�
+        // 多边形ROI点数和坐标（由UI注入，不可见，最多支持32个点）
         Parameters.Add("PolyCount", new ProcessorParameter("PolyCount", "PolyCount", typeof(int), 0, null, null, "") { IsVisible = false });
         for (int i = 0; i < 32; i++)
         {
@@ -76,7 +76,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
             typeof(double), 0.5, 0.0, 1.0,
             LocalizationHelper.GetString("BgaVoidRateProcessor_BgaCircularity_Desc")));
 
-        // ── 第二步：气泡检测��──
+        // ── 第二步：气泡检测参数 ──
         Parameters.Add("MinThreshold", new ProcessorParameter(
             "MinThreshold",
             LocalizationHelper.GetString("BgaVoidRateProcessor_MinThreshold"),
@@ -148,7 +148,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
         OutputData["RoiMode"] = roiMode;
         OutputData["RoiMask"] = roiMask;
 
-        _logger.Debug("BgaVoidRate 两步� BgaArea=[{Min},{Max}], Blur={Blur}, Circ={Circ}, Thresh=[{TMin},{TMax}]",
+        _logger.Debug("BgaVoidRate 两步法: BgaArea=[{Min},{Max}], Blur={Blur}, Circ={Circ}, Thresh=[{TMin},{TMax}]",
             bgaMinArea, bgaMaxArea, bgaBlurSize, bgaCircularity, minThresh, maxThresh);
 
         // ================================================================
@@ -156,7 +156,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
         // ================================================================
         var bgaResults = DetectBgaBalls(inputImage, bgaBlurSize, bgaMinArea, bgaMaxArea, bgaCircularity, roiMask);
 
-        _logger.Information("第一步完� 检测到 {Count} 个BGA焊�", bgaResults.Count);
+        _logger.Information("第一步完成: 检测到 {Count} 个BGA焊球", bgaResults.Count);
 
         if (bgaResults.Count == 0)
         {
@@ -176,7 +176,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
         }
 
         // ================================================================
-        // 第二步：在�个焊�区域内检测气�
+        // 第二步：在每个焊球区域内检测气泡
         // ================================================================
         int totalBgaArea = 0;
         int totalVoidArea = 0;
@@ -193,13 +193,13 @@ public class BgaVoidRateProcessor : ImageProcessorBase
         double overallVoidRate = totalBgaArea > 0 ? (double)totalVoidArea / totalBgaArea * 100.0 : 0;
         string classification = overallVoidRate <= voidLimit ? "PASS" : "FAIL";
 
-        // 检查�个焊�是��独超�
+        // 检查每个焊球是否单独超标
         foreach (var bga in bgaResults)
         {
             bga.Classification = bga.VoidRate <= voidLimit ? "PASS" : "FAIL";
         }
 
-        _logger.Information("第二步完� 总气泡率={VoidRate:F1}%, 气泡�{Count}, 判定={Class}",
+        _logger.Information("第二步完成: 总气泡率={VoidRate:F1}%, 气泡数={Count}, 判定={Class}",
             overallVoidRate, totalVoidCount, classification);
 
         // 输出数据
@@ -222,7 +222,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
 
     /// <summary>
     /// 第一步：自动检测BGA焊球位置
-    /// 使用Otsu二值化 + 轮廓检�+ 圆度过滤 + 椭圆拟�
+    /// 使用Otsu二值化 + 轮廓检测 + 圆度过滤 + 椭圆拟合
     /// </summary>
     private List<BgaBallInfo> DetectBgaBalls(Image<Gray, byte> input, int blurSize, int minArea, int maxArea, double minCircularity, Image<Gray, byte>? roiMask)
     {
@@ -233,7 +233,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
         var blurred = new Image<Gray, byte>(w, h);
         CvInvoke.GaussianBlur(input, blurred, new Size(blurSize, blurSize), 0);
 
-        // Otsu自动二值化（X-Ray正片：焊�暗区域）
+        // Otsu自动二值化（X-Ray正片：焊球=暗区域）
         var binary = new Image<Gray, byte>(w, h);
         CvInvoke.Threshold(blurred, binary, 0, 255, ThresholdType.Otsu | ThresholdType.BinaryInv);
 
@@ -264,7 +264,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
             double circularity = 4.0 * Math.PI * area / (perimeter * perimeter);
             if (circularity < minCircularity) continue;
 
-            // 需�至�个点�能拟�椭圆
+            // 需要至少5个点才能拟合椭圆
             if (contours[i].Size < 5) continue;
 
             var ellipse = CvInvoke.FitEllipse(contours[i]);
@@ -284,7 +284,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
             });
         }
 
-        // 按�积从大到�排�
+        // 按面积从大到小排序
         results.Sort((a, b) => b.BgaArea.CompareTo(a.BgaArea));
         for (int i = 0; i < results.Count; i++) results[i].Index = i + 1;
 
@@ -296,8 +296,8 @@ public class BgaVoidRateProcessor : ImageProcessorBase
     }
 
     /// <summary>
-    /// 第二步：在�个BGA焊�区域内检测气�
-    /// 使用焊�轮廓作为掩�，�阈值分割气泡区�
+    /// 第二步：在单个BGA焊球区域内检测气泡
+    /// 使用焊球轮廓作为掩码，双阈值分割气泡区域
     /// </summary>
     private void DetectVoidsInBga(Image<Gray, byte> input, BgaBallInfo bga, int minThresh, int maxThresh, int minVoidArea)
     {
@@ -314,7 +314,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
         int bgaPixels = CvInvoke.CountNonZero(mask);
         bga.BgaArea = bgaPixels;
 
-        // �阈值分割（正片模�：气�亮，�度在[minThresh, maxThresh]范围内判为气泡）
+        // 双阈值分割（正片模式：气泡=亮，灰度在[minThresh, maxThresh]范围内判为气泡）
         var voidImg = new Image<Gray, byte>(w, h);
         byte[,,] srcData = input.Data;
         byte[,,] dstData = voidImg.Data;
@@ -361,7 +361,7 @@ public class BgaVoidRateProcessor : ImageProcessorBase
             });
         }
 
-        // 按�积从大到�排�
+        // 按面积从大到小排序
         bga.Voids.Sort((a, b) => b.Area.CompareTo(a.Area));
         for (int i = 0; i < bga.Voids.Count; i++) bga.Voids[i].Index = i + 1;
 
@@ -400,4 +400,4 @@ public class VoidInfo
     public double AreaPercent { get; set; }
     public Rectangle BoundingBox { get; set; }
     public Point[] ContourPoints { get; set; } = Array.Empty<Point>();
-}
+}