XplorePlane/XP.ImageProcessing.Processors/检测分析/FillRateProcessor.cs

// ============================================================================
// Copyright © 2026 Hexagon Technology Center GmbH. All Rights Reserved.
// 文件� FillRateProcessor.cs
// �述: 通孔填锡率测�算�（倾斜投影几何法），基于四椭圆ROI
// 功能:
//   - 样�倾斜�5°放置，利用投影�移关系计算填锡率
//   - 四个椭圆定义�
//     E1 = 通孔底部轮廓
//     E2 = 通孔顶部轮廓
//     E3 = 填锡起点（与E1��，代�%填锡�
//     E4 = 填锡终点（锡实际填充到的高度�
//   - 填锡�= |E4中心 - E3中心| / |E2中心 - E1中心| × 100%
//   - 纯几何方法，��赖�度分�
//   - IPC-610 THT 分级判定（Class 1/2/3�
// 算法: 倾斜投影�移比例
// 作� �伟 wei.lw.li@hexagon.com
// ============================================================================

using Emgu.CV;
using Emgu.CV.Structure;
using Serilog;
using System.Drawing;
using XP.ImageProcessing.Core;

namespace XP.ImageProcessing.Processors;

/// <summary>
/// 通孔填锡率测�算�（倾斜投影几何法）
/// </summary>
public class FillRateProcessor : ImageProcessorBase
{
    private static readonly ILogger _logger = Log.ForContext<FillRateProcessor>();

    public FillRateProcessor()
    {
        Name = LocalizationHelper.GetString("FillRateProcessor_Name");
        Description = LocalizationHelper.GetString("FillRateProcessor_Description");
    }

    protected override void InitializeParameters()
    {
        // 四个椭圆（由交互控件注入，UI���）
        AddEllipseParams("E1", 200, 250, 60, 50, 0);  // 底部
        AddEllipseParams("E2", 220, 180, 60, 50, 0);  // 顶部
        AddEllipseParams("E3", 200, 250, 60, 50, 0);  // 填锡起点�E1�
        AddEllipseParams("E4", 210, 220, 55, 45, 0);  // 填锡终点

        Parameters.Add("THTLimit", new ProcessorParameter(
            "THTLimit",
            LocalizationHelper.GetString("FillRateProcessor_THTLimit"),
            typeof(double), 75.0, 0.0, 100.0,
            LocalizationHelper.GetString("FillRateProcessor_THTLimit_Desc")));

        Parameters.Add("Thickness", new ProcessorParameter(
            "Thickness",
            LocalizationHelper.GetString("FillRateProcessor_Thickness"),
            typeof(int), 2, 1, 10,
            LocalizationHelper.GetString("FillRateProcessor_Thickness_Desc")));
    }

    private void AddEllipseParams(string prefix, int cx, int cy, double a, double b, double angle)
    {
        Parameters.Add($"{prefix}_CX", new ProcessorParameter($"{prefix}_CX", $"{prefix}_CX", typeof(int), cx, null, null, "") { IsVisible = false });
        Parameters.Add($"{prefix}_CY", new ProcessorParameter($"{prefix}_CY", $"{prefix}_CY", typeof(int), cy, null, null, "") { IsVisible = false });
        Parameters.Add($"{prefix}_A", new ProcessorParameter($"{prefix}_A", $"{prefix}_A", typeof(double), a, null, null, "") { IsVisible = false });
        Parameters.Add($"{prefix}_B", new ProcessorParameter($"{prefix}_B", $"{prefix}_B", typeof(double), b, null, null, "") { IsVisible = false });
        Parameters.Add($"{prefix}_Angle", new ProcessorParameter($"{prefix}_Angle", $"{prefix}_Angle", typeof(double), angle, null, null, "") { IsVisible = false });
    }

    public override Image<Gray, byte> Process(Image<Gray, byte> inputImage)
    {
        double thtLimit = GetParameter<double>("THTLimit");
        int thickness = GetParameter<int>("Thickness");

        // 获�四个椭圆中心
        int e1cx = GetParameter<int>("E1_CX"), e1cy = GetParameter<int>("E1_CY");
        int e2cx = GetParameter<int>("E2_CX"), e2cy = GetParameter<int>("E2_CY");
        int e3cx = GetParameter<int>("E3_CX"), e3cy = GetParameter<int>("E3_CY");
        int e4cx = GetParameter<int>("E4_CX"), e4cy = GetParameter<int>("E4_CY");

        // 获�椭圆轴�数（用于绘制�
        double e1a = GetParameter<double>("E1_A"), e1b = GetParameter<double>("E1_B"), e1ang = GetParameter<double>("E1_Angle");
        double e2a = GetParameter<double>("E2_A"), e2b = GetParameter<double>("E2_B"), e2ang = GetParameter<double>("E2_Angle");
        double e3a = GetParameter<double>("E3_A"), e3b = GetParameter<double>("E3_B"), e3ang = GetParameter<double>("E3_Angle");
        double e4a = GetParameter<double>("E4_A"), e4b = GetParameter<double>("E4_B"), e4ang = GetParameter<double>("E4_Angle");

        _logger.Debug("FillRate: E1=({E1X},{E1Y}), E2=({E2X},{E2Y}), E3=({E3X},{E3Y}), E4=({E4X},{E4Y})",
            e1cx, e1cy, e2cx, e2cy, e3cx, e3cy, e4cx, e4cy);

        OutputData.Clear();

        // 计算通孔全高度的投影�移（E1底部 �E2顶部�
        double fullDx = e2cx - e1cx;
        double fullDy = e2cy - e1cy;
        double fullDistance = Math.Sqrt(fullDx * fullDx + fullDy * fullDy);

        // 计算填锡高度的投影�移（E3起点 �E4终点�
        double fillDx = e4cx - e3cx;
        double fillDy = e4cy - e3cy;
        double fillDistance = Math.Sqrt(fillDx * fillDx + fillDy * fillDy);

        // 填锡�= 填锡�移 / 全高度��
        double fillRate = fullDistance > 0 ? (fillDistance / fullDistance) * 100.0 : 0;
        fillRate = Math.Clamp(fillRate, 0, 100);

        // 判定
        string classification = fillRate >= thtLimit ? "PASS" : "FAIL";

        // 存储结果
        OutputData["FillRateResult"] = true;
        OutputData["FillRate"] = fillRate;
        OutputData["VoidRate"] = 100.0 - fillRate;
        OutputData["FullDistance"] = fullDistance;
        OutputData["FillDistance"] = fillDistance;
        OutputData["THTLimit"] = thtLimit;
        OutputData["Classification"] = classification;
        OutputData["Thickness"] = thickness;

        // 椭圆几何（用于绘制）
        OutputData["E1"] = (new Point(e1cx, e1cy), new Size((int)e1a, (int)e1b), e1ang);
        OutputData["E2"] = (new Point(e2cx, e2cy), new Size((int)e2a, (int)e2b), e2ang);
        OutputData["E3"] = (new Point(e3cx, e3cy), new Size((int)e3a, (int)e3b), e3ang);
        OutputData["E4"] = (new Point(e4cx, e4cy), new Size((int)e4a, (int)e4b), e4ang);

        string resultText = $"{fillRate:F1}% | {classification}";
        OutputData["ResultText"] = resultText;

        _logger.Information("FillRate (geometric): {Rate}%, {Class}, FullDist={FD:F1}, FillDist={FiD:F1}",
            fillRate, classification, fullDistance, fillDistance);

        return inputImage.Clone();
    }
}