WPF与OpenCV融合的高级图像显示控件2.0：支持拖拽与交互式绘图

基于WPFOpencv 高级显示控件2.0 全新优化支持图像拖入显示使用wpf的adnoner和thumb实现可交互的绘图对象。一、项目基础信息与环境配置一项目结构与依赖根据代码文件目录项目分为WindowControl控件库与WindowControlDemo演示程序两大模块总计57个文件核心文件分布如下模块核心文件功能定位WindowControlDrawingObject.cs、WindowSmartControl.xaml.cs、ImageConvertor.cs控件核心逻辑含绘图对象、交互控制、图像转换WindowControlGraphicsDrawing.cs、MathMethods.cs、ViewWithModel.cs图形绘制、数学计算、MVVM数据绑定WindowControlDemoMainWindow.xaml.cs、App.xaml.cs演示程序界面交互、功能调用示例配置文件App.config、WindowControl.csproj、WindowControlDemo.csproj框架版本、项目依赖、编译配置二环境配置参数框架版本所有项目目标框架为.NETFramework,Versionv4.8见App.config、WindowControl.csproj依赖库OpenCvSharp4版本4.9.0.20240103、System.Buffers、System.Memory等见packages.config编译配置Debug模式生成pdb调试文件Release模式优化代码支持AnyCPU平台WindowControlDemo额外配置x64平台目标见WindowControlDemo.csproj资源复制PreBuild事件自动复制WindowControl.dll及依赖库到输出目录见WindowControlDemo.csproj PreBuildEvent。二、核心控件库WindowControl代码解读一DrawingObject.cs可交互绘图对象基类与实现1. 基类DrawingObject核心枚举Param定义绘图对象基础参数Stroke边框画笔、StrokeThickness边框厚度CallBackType定义回调类型OnDrag拖拽、OnResize缩放、OnAttached绑定、OnDisattached解绑。关键属性ScaleToImage依赖属性绑定图像与控件的缩放比例变化时触发OnScaleToImageChanged更新图形位置_mShape绘图对象对应的WPF Shape如Ellipse、Rectangle、Line作为Adorner装饰器的目标元素。核心方法AttachToWindowControl将绘图对象绑定到WindowSmartControl建立缩放比例绑定DisAttachWithWindowControl解绑绘图对象清除绑定与回调SetDrawingObjectCallback/GetDrawingObjectParam设置回调函数、获取/设置绘图对象参数含类型校验如Stroke需为Brush类型。2. 派生绘图对象实现1CircleDrawingObject圆形专属ParamCenterX圆心X、CenterY圆心Y、Radius半径创建与更新CreateDrawingObject初始化圆心与半径UpdateShapePos通过PosToControlCoordinate转换图像坐标到控件坐标计算椭圆Ellipse的左上角位置与尺寸交互逻辑ThumbDrag处理两种Thumb事件——Center标签拖拽移动圆心、CenterRight标签调整半径触发OnDrag/OnResize回调。2RectDrawingObject矩形专属ParamLeft左上角X、Top左上角Y、Width宽度、Height高度交互逻辑支持9个Thumb手柄TopLeft、TopCenter等ThumbDrag根据手柄标签计算矩形位置/尺寸变化如TopLeft手柄同时调整Left/Top/Width/Height。3Rect2DrawingObject旋转矩形专属ParamCenterX、CenterY、Width、Height、Angle旋转角度创建与旋转CreateDrawingObject初始化旋转角度UpdateShapePos通过MathMethods.GetRect2Points计算旋转后矩形的四个顶点交互逻辑新增Rotate标签Thumb通过Vector.AngleBetween计算角度变化更新矩形旋转状态。4LineDrawingObject直线专属ParamStartX、StartY起点、EndX、EndY终点交互逻辑3个Thumb手柄CenterLeft起点、CenterRight终点、Center移动ThumbDrag调整端点坐标或整体移动直线。5PolygonDrawingObject多边形专属ParamCentroidX质心X、CentroidY质心Y、Points顶点集合创建与更新CreateDrawingObject接收顶点列表计算质心坐标SetDrawingObjectParam支持动态添加顶点如Demo中“Add Random Point”功能交互逻辑每个顶点对应一个Thumb支持顶点拖拽调整与整体移动自动更新质心坐标。二WindowSmartControl.xaml.cs控件交互核心1. 自定义CanvasRudeCanvas重写VisualChildrenCount与GetVisualChild维护_visuals列表管理视觉元素提供AddVisual/RemoveVisual/ClearVisual方法支持添加/移除绘图视觉对象排除Shape类型元素避免与绘图对象冲突。2. 核心属性与事件依赖属性ScaleToImage图像缩放比例、IsEnableAdaptiveDisplay自适应显示开关、IsEnableAutomaticDisplayClear自动清除显示开关拖放事件rootCanvasDragEnter/rootCanvasDrop支持图像文件拖入通过LoadBitmapImage/LoadMat加载图像触发UpdateImageCanvas更新显示尺寸。3. 图像交互控制鼠标移动rootCanvas_MouseMove转换鼠标坐标到图像坐标调用viewModel.UpdateImageCanvas更新鼠标位置与像素信息BGR值缩放平移imageCanvasMouseWheel计算缩放因子鼠标滚轮 delta 控制更新mImageCanvasScaleX/Y支持最大80倍缩放imageCanvasMouseLeftButtonDown/Move实现图像拖拽平移自适应显示AdaptiveDisplay方法根据控件尺寸调整图像显示位置与比例重置平移偏移。4. 绘图与显示接口提供两类绘图接口DisplayXXX临时显示、DrawXXX永久绘制到图像核心接口如下DisplayCircle/DrawCircle绘制圆形支持填充与边框设置DisplayRect2/DrawRect2绘制旋转矩形传入中心坐标、角度、宽高等参数DisplayText在指定位置显示文本支持字体、大小、颜色设置ClearDisplay/ClearWindow清除临时显示元素/清空整个窗口含图像与绘图对象。三ImageConvertor.cs图像格式转换格式映射mPixelFormatDict定义WPF PixelFormat与System.Drawing PixelFormat的映射如Bgr24对应Format24bppRgb核心转换方法Bitmap2Writable将System.Drawing.Bitmap转换为WPF WriteableBitmap通过LockBits/UnlockBits处理像素数据Writable2Bitmap反向转换支持不安全代码unsafe复制内存数据Bitmap2Mat/Mat2Bitmap通过OpenCvSharp.Extensions.BitmapConverter实现Bitmap与OpenCV Mat的转换灰度图8bpp/4bpp单独处理。四MathMethods.cs数学计算工具坐标与几何计算GetRectCenter计算矩形WPF Rect/OpenCV Rect2d等中心坐标GetRectLT根据中心坐标与半宽高计算左上角坐标GetPPDistance计算两点间距离RotatePoint绕中心点旋转坐标点通过三角函数计算旋转后位置GetRect2Points计算旋转矩形的四个顶点坐标为Rect2DrawingObject提供支撑。五ViewWithModel.csMVVM数据绑定1. 数据模型Model维护图像源imageSource、位图bitmap、缩放比例_ScaleToImage等核心数据提供DrawCircle/DrawRect2/DrawPolygon等OpenCV绘图方法将几何图形绘制到Mat对象。2. 视图模型ViewModel属性绑定mImageSource图像源、mScaleToImage缩放比例、mCurPosDisplay鼠标位置显示等属性通过Do方法触发PropertyChanged事件图像加载与显示LoadImage支持加载Bitmap/Mat格式图像Display更新图像显示图形生成GenCircle/GenRect2/GenPolygon生成WPF DrawingVisual对象用于临时显示不修改原图像。三、演示程序WindowControlDemo代码解读一MainWindow.xaml.cs界面交互逻辑1. 初始化与变量声明5种绘图对象实例CircleDrawingObject/RectDrawingObject等维护OpenCV Matsrc与BitmapsrcBitmap存储原始图像数据。2. Button_Click核心功能触发根据按钮内容执行对应操作逐段解读如下private void Button_Click(object sender, RoutedEventArgs e) { string szContent (sender as Button).Content.ToString(); // 1. 圆形绘图对象创建、绑定到控件、设置拖拽/缩放回调 if(szContent 圆形绘图图像) { drawingObject.CreateDrawingObject(); drawingObject.AttachToWindowControl(WindowControl); drawingObject.SetDrawingObjectCallback(DrawingObject.CallBackType.OnDrag, DrawObjCallback); drawingObject.SetDrawingObjectCallback(DrawingObject.CallBackType.OnResize, DrawObjCallback); } // 2. 矩形绘图对象创建、绑定、设置拖拽回调 else if (szContent 矩形绘图图像) { rectDrawingObject.CreateDrawingObject(); rectDrawingObject.AttachToWindowControl(WindowControl); rectDrawingObject.SetDrawingObjectCallback(DrawingObject.CallBackType.OnDrag, DrawObjCallback); } // 3. 直线绘图对象创建、绑定无回调 else if (szContent 直线绘图图像) { lineDrawingObject.CreateDrawingObject(); lineDrawingObject.AttachToWindowControl(WindowControl); } // 4. 旋转矩形绘图对象指定初始位置0,0、尺寸125,125、角度0绑定拖拽回调 else if (szContent 旋转矩形绘图图像) { double d 0; rect2DrawingObject.CreateDrawingObject(0, 0, 125, 125, d); rect2DrawingObject.AttachToWindowControl(WindowControl); rect2DrawingObject.SetDrawingObjectCallback(DrawingObject.CallBackType.OnDrag, DrawObjCallback); } // 5. 多边形绘图对象指定初始顶点列表创建并绑定 else if(szContent 多边形矩形绘图图像) { ListPoint points new ListPoint { new Point(50, 50), new Point(100, 150), new Point(250, 250), new Point(350, 250),new Point(250, 100) }; polygonDrawingObject.CreateDrawingObject(points); polygonDrawingObject.AttachToWindowControl(WindowControl); } // 6. 为多边形添加随机顶点获取质心坐标生成随机点并添加到顶点列表 else if (szContent Add Random Point) { if(polygonDrawingObject null) { return; } polygonDrawingObject.GetDrawingObjectParam((int)PolygonDrawingObject.Param.CentroidX, out double objX); polygonDrawingObject.GetDrawingObjectParam((int)PolygonDrawingObject.Param.CentroidY, out double objY); Random random1 new Random(); Point p new Point(random1.Next((int)objX - 50, (int)objX 50), random1.Next((int)objY - 50, (int)objY 50)); polygonDrawingObject.GetDrawingObjectParam((int)PolygonDrawingObject.Param.Points, out ListPoint lPoints); lPoints.Add(p); polygonDrawingObject.SetDrawingObjectParam((int)PolygonDrawingObject.Param.Points, lPoints); } // 7. 清空绘图对象所有绘图对象解绑 else if(szContent 清空绘图对象) { drawingObject.DisAttachWithWindowControl(WindowControl); rectDrawingObject.DisAttachWithWindowControl(WindowControl); lineDrawingObject.DisAttachWithWindowControl(WindowControl); rect2DrawingObject.DisAttachWithWindowControl(WindowControl); polygonDrawingObject.DisAttachWithWindowControl(WindowControl); } // 8. 清空窗口清除控件显示重置原始图像变量 else if(szContent 清空窗口) { WindowControl.ClearWindow(); _src null; _srcBitmap null; } // 9. 获得显示图像从控件获取Mat格式图像通过OpenCV显示 else if (szContent 获得显示图像) { OpenCvSharp.Mat mat WindowControl.GetDisplayOpenCvSharp.Mat(); OpenCvSharp.Cv2.ImShow(Display, mat); OpenCvSharp.Cv2.WaitKey(0); } }3. DrawObjCallback绘图对象回调处理根据绘图对象类型执行对应逻辑逐段解读private void DrawObjCallback(DrawingObject.CallBackType callBackType, DrawingObject drawingObject) { // 1. 圆形对象拖拽/缩放时触发Sobel边缘检测 if (drawingObject is CircleDrawingObject) { CircleDrawingObject circleDrawingObject drawingObject as CircleDrawingObject; circleDrawingObject.GetDrawingObjectParam((int)CircleDrawingObject.Param.CenterX, out double dCenterX); circleDrawingObject.GetDrawingObjectParam((int)CircleDrawingObject.Param.CenterY, out double dCenterY); circleDrawingObject.GetDrawingObjectParam((int)CircleDrawingObject.Param.Radius, out double dR); if (SobelcheckBox.IsChecked true) { if (_src null) { _src WindowControl.GetDisplayOpenCvSharp.Mat(); // 转换为灰度图若为多通道 if (_src.Channels() 1) { OpenCvSharp.Cv2.CvtColor(_src, _src, OpenCvSharp.ColorConversionCodes.BGR2GRAY); WindowControl.Display(_src); } } // 生成Sobel处理后的图像并显示 OpenCvSharp.Mat sobelMat SobelMat(_src, new Point(dCenterX, dCenterY), dR); WindowControl.Display(sobelMat); } } // 2. 旋转矩形对象拖拽时在图像上绘制蓝色旋转矩形缩小10单位 else if (drawingObject is Rect2DrawingObject) { drawingObject.GetDrawingObjectParam((int)Rect2DrawingObject.Param.CenterX, out double dCenterX); drawingObject.GetDrawingObjectParam((int)Rect2DrawingObject.Param.CenterY, out double dCenterY); drawingObject.GetDrawingObjectParam((int)Rect2DrawingObject.Param.Width, out double dWidth); drawingObject.GetDrawingObjectParam((int)Rect2DrawingObject.Param.Height, out double dHeight); drawingObject.GetDrawingObjectParam((int)Rect2DrawingObject.Param.Angle, out double dAngle); if (drawToImageCheckBox.IsChecked true) { if (_srcBitmap null) { _srcBitmap WindowControl.GetDisplaysd.Bitmap(); } WindowControl.Display(_srcBitmap); WindowControl.DrawRect2(new Point(dCenterX, dCenterY), dAngle, dWidth - 10, dHeight - 10, Colors.Blue, 3, false); } } // 3. 矩形对象拖拽时清除显示若勾选显示文本则在矩形内显示指定文本 else if (drawingObject is RectDrawingObject) { WindowControl.ClearDisplay(); drawingObject.GetDrawingObjectParam((int)RectDrawingObject.Param.Left, out double dLeft); drawingObject.GetDrawingObjectParam((int)RectDrawingObject.Param.Top, out double dTop); drawingObject.GetDrawingObjectParam((int)RectDrawingObject.Param.Width, out double dW); drawingObject.GetDrawingObjectParam((int)RectDrawingObject.Param.Height, out double dH); if (showTextCheckBox.IsChecked true) { WindowControl.DisplayText(showTBX.Text, new Point(dLeft 50, dTop 50), new FontFamily(Arial), 20, Colors.LightGreen); } } }4. 其他交互逻辑colorCombo_SelectionChanged下拉选择颜色红/绿/蓝更新所有绘图对象的Stroke参数TextBox_TextChanged输入数值更新所有绘图对象的StrokeThickness参数边框厚度SobelMatSobel边缘检测核心方法通过掩码提取圆形ROI用Scharr算子计算边缘与原图叠加后返回。四、关键功能与程序意图还原一核心功能清单基于代码实存功能图像加载与显示支持拖入加载、路径加载格式含BMP/PNG/JPG支持Mat/Bitmap互转可交互绘图圆形拖拽缩放、矩形拖拽多方向缩放、直线拖拽端点调整、旋转矩形拖拽缩放旋转、多边形拖拽顶点添加调整图像交互鼠标滚轮缩放1~80倍、鼠标拖拽平移、鼠标位置与像素BGR值实时显示图像处理Sobel边缘检测圆形区域、旋转矩形绘制、文本叠加控制功能清空绘图对象、清空窗口、获取当前显示图像、自适应显示。二程序设计意图控件复用性WindowControl作为独立控件库通过接口暴露绘图、显示、交互功能供外部程序调用交互友好性用AdornerThumb实现可视化交互手柄支持实时反馈如颜色、尺寸变化功能扩展性绘图对象通过继承DrawingObject可扩展图像处理接口预留扩展空间如新增Canny检测数据安全性参数获取/设置含类型校验避免错误类型导致崩溃图像操作前判断对象是否为空减少异常。三代码约束与限制基于原始代码框架依赖仅支持.NET Framework 4.8不兼容.NET Core/.NET 5平台限制OpenCvSharp.runtime.win依赖Windows系统无跨平台支持功能边界Sobel检测仅支持圆形绘图对象其他对象无此功能多边形仅支持顶点添加不支持删除性能约束大尺寸图像如4K及以上缩放时可能卡顿无异步处理逻辑。基于WPFOpencv 高级显示控件2.0 全新优化支持图像拖入显示使用wpf的adnoner和thumb实现可交互的绘图对象。