基于Opencv C# 开发的卡尺测量距离源码，代码运行正常，由实际运行项目中剥离，含测试图片

基于Opencv C# 开发的卡尺测量距离源码，代码运行正常，由实际运行项目中剥离，含测试图片，包含一个强大的视觉控件源码，控件仿halcon,支持平移，无损缩放，显示各种自定义图形工具，鼠标拖动，简单方便。

一、系统概述

基于OpenCV C#开发的卡尺测距系统，是从实际运行项目中剥离的视觉测量解决方案，包含完整的视觉控件源码与测试图片，可实现图像显示、卡尺测量、距离计算等核心功能。系统采用模块化设计，分为图像显示控件模块、图形绘制模块、卡尺测量模块及数据交互模块，支持圆、直线、矩形等多种形状的测量需求，适用于工业检测、精密测量等场景。

基于Opencv C# 开发的卡尺测量距离源码，代码运行正常，由实际运行项目中剥离，含测试图片，包含一个强大的视觉控件源码，控件仿halcon,支持平移，无损缩放，显示各种自定义图形工具，鼠标拖动，简单方便。

系统技术栈以C#为开发语言，依托OpenCVSharp库实现图像处理能力，基于.NET Framework 4.7.2构建，支持Windows平台运行。核心优势在于可视化操作界面、灵活的参数配置机制与高精度的边缘检测算法，可满足不同场景下的测量需求。

二、核心模块功能说明

（一）图像显示控件模块

该模块是系统的视觉交互核心，提供高性能的图像渲染与交互能力，包含UDisPlay与UDisPlay_Pen两个核心控件，均继承自PictureBox并扩展OpenCV图像处理能力。

1. 基础显示功能

• 多模式显示：支持三种图像显示模式，Original（原始尺寸）、Fit（适配控件）、Full（铺满控件），用户可通过右键菜单快速切换，也可通过双击图像自动触发Fit模式。
• 图像操作：支持鼠标滚轮缩放（缩放系数0.5/2.0）、鼠标拖拽平移，缩放时以鼠标位置为中心，确保操作直观性；提供图像保存功能，支持将当前显示图像导出为BMP格式。
• 像素信息反馈：鼠标移动时，通过 tooltip 实时显示当前像素的坐标（图像坐标系）与通道值（如灰度值、RGB三通道值），支持单通道、三通道等多种图像格式。

2. 增强功能（U_DisPlay_Pen）

在基础显示功能之上，额外提供图像标记能力，支持两种核心操作模式：

• 标记模式：鼠标拖动时，以红色标记指定区域，通过掩码（Mask）技术实现标记区域与原始图像的叠加显示，标记大小可通过Size_Pen参数配置。
• 擦除模式：支持对已标记区域进行擦除，恢复原始图像显示，满足临时标记与修改需求。

（二）图形绘制模块

该模块提供丰富的图形绘制能力，支撑卡尺测量的可视化交互，所有图形类均继承自CvDisplayGraphicsShape，确保统一的渲染与交互标准。核心图形组件包括：

1. 基础图形

• 点（CvDisplayGraphicsDot）：支持单个像素点的绘制与选中交互，可作为卡尺测量的端点标记，支持鼠标拖动调整位置。
• 线段（CvDisplayGraphicsLineSegment）：用于绘制卡尺基线、测量线段等，支持端点与线段整体的选中与拖动，选中时高亮显示（绿色），并在端点显示选中标记。
• 圆（CvDisplayGraphicsCircle）：支持圆心与半径的独立调整，鼠标选中圆心可整体移动，选中边缘可调整半径，适用于圆形工件的测量基准绘制。

2. 复合图形

• 矩形（CvDisplayGraphicsRectangle2）：支持旋转矩形的绘制，可调整中心位置、边长与旋转角度，适用于矩形工件的测量区域划定，选中时显示边框与旋转控制点。
• 多点集（CvDisplayGraphicsDots）：支持批量点的绘制与管理，常用于标记多个测量特征点，如边缘检测结果的可视化展示。

（三）卡尺测量模块

该模块是系统的核心功能模块，通过卡尺算法实现图像边缘检测与距离测量，支持多种测量场景，核心逻辑封装在CvDisplayGraphicsCalipersDistance与Form1的测量相关方法中。

1. 卡尺基础配置

用户可通过界面参数配置卡尺测量的核心参数，确保测量精度与效率：

• 检测参数：包括边缘阈值（控制边缘检测灵敏度）、滤波尺寸（去除图像噪声干扰）、搜索极性（由暗到明/由明到暗/所有边缘）、搜索次序（第一个/第二个/倒数第一个等）。
• 卡尺形态参数：针对不同测量场景，配置卡尺数量、长度、宽度等，如圆卡尺需配置圆周分布的卡尺数量，直线卡尺需配置线段方向的卡尺分布密度。

2. 核心测量流程

以“卡尺测距”功能为例，完整测量流程如下：

1. 图像加载：用户选择待测量图像（支持BMP、PNG格式），系统将图像转换为灰度图存储，减少色彩干扰。
2. 卡尺创建：在图像上创建卡尺基线（线段），作为测量的基准线，支持鼠标拖动调整基线位置与长度。
3. 边缘检测：
   - 系统围绕卡尺基线构建测量区域，对区域内图像进行滤波处理，降低噪声影响。
   - 通过梯度计算获取图像边缘的灰度变化，根据配置的搜索极性与阈值，筛选有效边缘点。
   - 对边缘点进行亚像素级拟合，提高边缘定位精度，避免像素级定位的误差。
4. 距离计算：根据检测到的边缘点，结合卡尺基线的几何关系，计算目标两点间的直线距离，并在图像上高亮显示测量结果（线段与数值）。
5. 结果输出：在界面上展示测量结果，包括起点坐标、终点坐标与距离值，支持结果的导出与工程保存。

3. 多场景测量支持

系统支持多种典型测量场景，满足不同工业需求：

• 圆测量：通过圆周分布的卡尺检测圆形工件的边缘，拟合圆心与半径，输出圆的几何参数。
• 直线测量：通过平行分布的卡尺检测直线边缘，拟合直线方程，计算两条直线的交点或夹角。
• 矩形测量：通过矩形四条边的卡尺检测，获取矩形的中心位置、边长与旋转角度。

（四）数据交互模块

该模块负责系统的参数保存、工程管理与数据持久化，确保测量配置的复用与结果的可追溯。

1. 工程管理

• 工程保存：将当前测量配置（卡尺参数、图像路径、测量结果）保存为.prj工程文件，同时存储关联的图像文件与模板文件（如检测模板、掩码图像）。
• 工程加载：加载已保存的工程文件，自动恢复之前的测量配置与图像状态，支持断点续测。

2. 数据格式支持

• 二进制存储：核心参数（如卡尺配置、图像尺寸）以二进制格式存储，确保数据读写效率与完整性。
• XML存储：相机标定参数（如内参矩阵、畸变系数）以XML格式存储，便于与其他视觉系统兼容。
• 图像存储：测量过程中涉及的图像（原始图、标记图、结果图）以BMP格式存储，保证图像质量无损失。

三、系统交互与操作流程

（一）界面布局

系统采用TabControl分页布局，将不同功能模块分区，用户操作路径清晰：

• 模板匹配：用于创建图像模板与批量匹配，适用于多目标定位场景。
• 圆卡尺/直线卡尺/矩形卡尺/卡尺测距：对应不同测量场景，提供专属的参数配置与操作界面。
• 畸变矫正：通过棋盘格标定相机，消除镜头畸变对测量精度的影响。

（二）典型操作流程（卡尺测距）

1. 打开“卡尺测距”Tab页，点击“卡尺图片”按钮，加载待测量图像。
2. 点击“添加卡尺”按钮，在图像上创建卡尺基线，拖动基线端点调整测量范围。
3. 在参数配置区设置边缘阈值（如10）、滤波尺寸（如2）、搜索极性（如“由暗到明”）。
4. 点击“距离测量”按钮，系统自动完成边缘检测与距离计算。
5. 查看测量结果：界面显示起点（X/Y）、终点（X/Y）与距离值，图像上高亮显示测量线段。
6. （可选）点击“保存工程”按钮，保存当前测量配置与结果，便于后续复用。

四、系统优势与适用场景

（一）核心优势

1. 高精度：采用亚像素级边缘拟合算法，测量精度高于传统像素级定位，满足精密测量需求。
2. 高灵活性：支持多种测量场景与参数配置，可根据不同工件类型调整检测逻辑。
3. 可视化操作：所有操作均在图像上直观交互，降低用户学习成本，无需专业视觉知识也可快速上手。
4. 工程化支持：支持工程的保存与加载，便于多场景复用与数据追溯，提升工作效率。

（二）适用场景

1. 工业检测：如电子元件的引脚间距测量、机械零件的尺寸公差检测。
2. 精密制造：如模具的型腔尺寸测量、玻璃基板的厚度测量。
3. 自动化设备：集成到自动化生产线中，实现实时在线测量与质量判定。

五、注意事项

1. 图像质量要求：为确保测量精度，建议输入图像无明显噪声、光照均匀，避免反光或阴影区域覆盖测量目标。
2. 参数调试建议：初次使用时，建议从默认参数开始调试，逐步调整边缘阈值与滤波尺寸，观察边缘检测结果，直至获取稳定的边缘点。
3. 相机标定：若使用相机实时采集图像，需先进行相机标定，消除镜头畸变对测量结果的影响，标定参数保存后可长期复用。
4. 工程备份：重要测量项目建议定期备份工程文件，避免配置丢失或数据损坏。

通过以上功能模块的协同工作，该卡尺测距系统实现了从图像加载、参数配置、边缘检测到结果输出的全流程视觉测量能力，为工业视觉检测提供了高效、高精度的解决方案。