高大山 发表于 2024-3-27 14:43:06

【OpenCV】OpenCV (C++) 与 OpenCvSharp (C#) 之间数据通信

  OpenCV是一个基于Apache2.0许可(开源)发行的跨平台计算机视觉和机器学习软件库,可以运行在Linux、Windows、Android和Mac OS操作系统上。 它轻量级而且高效——由一系列 C 函数和少量 C++ 类构成,同时提供了Python、Ruby、MATLAB等语言的接口,实现了图像处理和计算机视觉方面的很多通用算法。OpenCV用C++语言编写,它具有C ++,Python,Java和MATLAB接口,并支持Windows,Linux,Android和Mac OS,OpenCV主要倾向于实时视觉应用。
  OpenCvSharp 是一个OpenCV的.Net wrapper,应用最新的OpenCV库开发,使用习惯比EmguCV更接近原始的OpenCV,有详细的使用样例供参考。该库采用LGPL发行,对商业应用友好。使用OpenCvSharp,可用C#,VB.NET等语言实现多种流行的图像处理(image processing)与计算机视觉(computer vision)算法。
    但是在实际使用中,由于涉及到不同编程语言之间互相调用,导致C++ 中的OpenCV与C#中的OpenCvSharp 图像数据在不同编程语言之间难以有效传递。在本文中我们将结合OpenCvSharp源码实现原理,探究两种数据之间的通信方式
1. 问题分析

  在日常开发中,由于一些库不支持C#接口,因此在使用时我们需要借助动态链接库的方式,在C#中调用C++封装的应用。由于C++与C#底层编译方式不同,因此动态链接库只可以传递基础的数据类型,无法传递像Class这种高级的数据格式。
  在日常开发中,我们在C#中使用OpenCvSharp进行图像处理,但是我们调用的算法是通过C++封装的动态链接库,且需要将图片数据传递到C++封装的动态链接库中进行处理,因此实现高效的实现图片数据传递是十分有必要的。常见的方式有两种:
  (1)第一种方式是在C#中将图片数据转为基本数据类型byte[]数组,然后将该数据传递到C++动态链接库中,在接收到该数据后,由C++再将该数据重新转为图片数据进行处理。目前该方式经过测试,是可以实现的,但是这样有一个弊端,图片数据需要进行两次的转换,这样会导致严重浪费时间和消耗大量内存。
  (2)第二种方式是在C#中将数据保存到本地,然后再C++动态链接库中读取。与上一种方式一样,这样会导致严重浪费时间和消耗大量内存。
2. 解决办法

  为了解决这个问题,我们探究了一下OpenCvSharp 实现方式,通过其源码可知,OpenCvSharp 在实现时,是通过对C++中的OpenCV进行了进一步封装,将Mat数据定义成指针类型,然后以指针的方式在C++与C#中进行传递;而在C#中,重新定义了Mat数据类型,将C++传递来的Mat指针作为成员变量进行初始化,而后续基于Mat的所有操作,其低层都是通过传递这个指针进行操作的。
  知道了Mat的这个数据类型的实现原理后,我们可以模仿这种方式,以指针的方式实现将OpenCvSharp的数据传递到OpenCV C++中,这样就可以快速实现数据类型传递。实现方式如下图所示。
  在C#中使用OpenCvSharp获取一个图片数据,数据类型为Mat,我们可以先进行处理等操作;接下来我们可以获取OpenCvSharp的地址CvPtr,然后在C++中使用*Mat指针进行获取,然后通过*Mat我们便可以获取到OpenCV C++中的Mat数据。接下来,用户就可以根据自己的需求进行处理即可。在处理完成后,在将获得新的用Mat数据转为用*Mat指针,然后再C#中,使用IntPtr数据类型进行接收,然后使用OpenCvSharp的Mat以获取的指针数据为初始值初始化Mat数据类型即获得新的Mat数据。
  通过上述方式,我们便可以很轻松的实现C#中的OpenCvSharp与C++中的OpenCv数据转换。
3. 项目创建

为方便演示,下述所有程序设计与编译皆是在Windows11环境下,使用Visual Studio 2022编辑器实现。

[*]OpenCV: 4.8.0
[*]OpenCvSharp: 4.9.0
大家可以根据上述版本进行配置,也可以使用其他版本配置,但要保证OpenCV与OpenCvSharp都是同一个基础版本的,且版本差别不要太大。
3.1 创建C++项目

  使用Visual Studio 2022创建一个空的C++项目,然后添加两个文件,分别为:mat_conv.h、mat_conv.cpp。
  接下来配置项目属性,首先配置项目输出类型,如下图所示,设置图片输出类型为动态库(.dll)
  然后配置OpenCV C++项目依赖,主要是配置C++项目的包含目录、库目录以及附加依赖项三个地方,如下图所示:
  以下是我的项目设置信息,大家可以根据自己安装的OpenCV情况进行设置:
包含目录: C:\3rdpartylib\opencv\build\include
库目录: C:\3rdpartylib\opencv\build\x64\vc16\lib
附加依赖项: opencv_world480.lib3.2 创建C#项目

使用Visual Studio 2022创建一个新的C#控制台项目,然后使用NuGet安装所需的程序集即可,此处只需要安装OpenCvSharp即可,如下图所示:
4. 接口测试

此处主要测试四个接口:

[*]第一个接口测试在OpenCvSharp中读取一张图片,然后将图片数据传入到OpenCV中,测试传入是否成功。
[*]第二个测试接口在OpenCV创建一个图片,绘制一个矩形,然后将创建好的图片传出到OpenCvSharp,测试传出数据是否成功。
[*]第三个测试接口是在OpenCvSharp中读取一张图片,然后将图片数据传入到OpenCV中,并进行一步处理,该处理结果会将数据保存到另一个新的图片数据中,将该新的图片数据传出,然后在OpenCvSharp查看是否处理成功,测试该过程是否成功。
[*]第四个测试接口是在OpenCvSharp中读取一张图片,然后将图片数据传入到OpenCV中,并进行一步处理,该处理结果会直接在原有数据上进行修改,然后在OpenCvSharp查看是否处理成功,测试该过程是否成功。
4.1 接口一测试

  在以下文件中分别添加以下代码:
mat_conv.h
#include "opencv2/opencv.hpp"
extern "C"__declspec(dllexport) void __stdcall mat_conv1(cv::Mat * mat);mat_conv.cpp
#include "mat_conv.h"

void mat_conv1(cv::Mat *mat)
{
        cv::imshow("image", *mat);
        cv::waitKey(0);
}Program.cs
using OpenCvSharp;
using OpenCvSharp.Internal;
using System.Runtime.InteropServices;
namespace opencv_csharp
{
    internal class Program
    {
      static void Main(string[] args)
      {
            Console.WriteLine("Hello, World!");
            string image_path = "image.jpg";
            Mat mat1 = Cv2.ImRead(image_path);
            Methord.mat_conv1(mat1.CvPtr);
      }
    }

    class Methord
    {
      private const string dll_path = "C:\\Users\\lenovo\\Desktop\\test_opencv\\x64\\Release\\opencv_cpp.dll";
      
      public static extern void mat_conv1(IntPtr mat);
    }
}  其中,mat_conv.h、mat_conv.cpp为C++项目文件,Program.cs文件为C#项目文件。
  在C++项目文件中,extern "C"__declspec(dllexport)表示使用C语言的编译方式进行编译,并导出到dll中。 mat_conv1(cv::Mat * mat)方法主要是接受传入的Mat指针,并使用cv::imshow("image", *mat)将图片数据展示出来。
  在C#项目中,使用属性将动态链接库中的mat_conv1读取出来,同时因为在C#中指针都是被封装为IntPtr类型的,因此使用IntPtr表示此处传入的参数为指针类型。在使用该接口时,直接调用该方法,并且传入指针参数,该指针参数可以通过Mat.CvPtr直接获得。
  如下图所示,程序在运行后,成功将传入的图片数据绘制出来,如下图所示,说明该接口测试成功,也证明了该方法是可行的。
4.2 接口二测试

  在以下文件中分别添加以下代码:
mat_conv.h
#include "opencv2/opencv.hpp"
extern "C"__declspec(dllexport) void __stdcall mat_conv2(cv::Mat **returnValue);mat_conv.cpp
#include "mat_conv.h"

voidmat_conv2(cv::Mat** returnValue)
{
    // 创建一个空白图像
    cv::Mat image = cv::Mat::zeros(400, 400, CV_8UC3);
    // 矩形的左上角和右下角坐标
    cv::Point2f rect_start(50, 50);
    cv::Point2f rect_end(350, 350);
    // 矩形颜色 (B, G, R)
    cv::Scalar color(255, 0, 0); // 红色
    // 矩形线条粗细
    int thickness = 2;
    // 绘制矩形
    cv::rectangle(image, rect_start, rect_end, color, thickness);
    *returnValue = new cv::Mat(image);
}Program.cs
using OpenCvSharp;
using OpenCvSharp.Internal;
using System.Runtime.InteropServices;
namespace opencv_csharp
{
    internal class Program
    {
      static void Main(string[] args)
      {
            Console.WriteLine("Hello, World!");
            IntPtr ptr2 = IntPtr.Zero;
            Methord.mat_conv2(out ptr2);
            Mat mat2 = new Mat(ptr2);
            Cv2.ImShow("image2", mat2);
            Cv2.WaitKey(0);
      }
    }

    class Methord
    {
      private const string dll_path = "C:\\Users\\lenovo\\Desktop\\test_opencv\\x64\\Release\\opencv_cpp.dll";
      
      public static extern void mat_conv2(out IntPtr returnValue);
    }
}  其中,mat_conv.h、mat_conv.cpp为C++项目文件,Program.cs文件为C#项目文件。
  在C++项目文件中,mat_conv2(cv::Mat** returnValue)主要是创建一个画布,并绘制一个矩形,然后将创建好的图片数据以指针的方式传递到C#中。
  在C#项目中,使用属性将动态链接库中的mat_conv2读取出来,传出数据此处使用的时双重指针,因此使用out IntPtr进行接收。再获取到该方法后,我们调用new Mat(IntPtr ptr)构造方法初始化为新的Mat数据。。
  如下图所示,程序在运行后,成功将传出的图片数据绘制出来,如下图所示,说明该接口测试成功,也证明了该方法是可行的。
4.3 接口三测试

  在以下文件中分别添加以下代码:
mat_conv.h
#include "opencv2/opencv.hpp"
extern "C"__declspec(dllexport) void __stdcall mat_conv3(cv::Mat * mat, cv::Mat **returnValue);mat_conv.cpp
#include "mat_conv.h"

voidmat_conv3(cv::Mat * mat, cv::Mat **returnValue)
{
        cv::Mat m;
        cv::cvtColor(*mat, m, cv::COLOR_BGR2GRAY);
        *returnValue = new cv::Mat(m);
}Program.cs
using OpenCvSharp;
using OpenCvSharp.Internal;
using System.Runtime.InteropServices;
namespace opencv_csharp
{
    internal class Program
    {
      static void Main(string[] args)
      {
            Console.WriteLine("Hello, World!");
            string image_path = "image.jpg";
            Mat mat3 = Cv2.ImRead(image_path);
            IntPtr ptr3 = IntPtr.Zero;
            Methord.mat_conv3(mat1.CvPtr, out ptr3);
            Mat mat3 = new Mat(ptr3);
            Cv2.ImShow("image1", mat3);
            Cv2.WaitKey(0);
      }
    }

    class Methord
    {
      private const string dll_path = "C:\\Users\\lenovo\\Desktop\\test_opencv\\x64\\Release\\opencv_cpp.dll";
      
      public static extern void mat_conv3(IntPtr mat, out IntPtr return_value);
    }
}  其中,mat_conv.h、mat_conv.cpp为C++项目文件,Program.cs文件为C#项目文件。
  在C++项目文件中, mat_conv2(cv::Mat * mat, cv::Mat **returnValue)方法主要是接受传入的Mat指针,并将传入的图片数据转为灰度图,同时将转换好的图片数据以指针的方式传出到C#中。
  在C#项目中,使用属性将动态链接库中的mat_conv3读取出来,其中传入数据为指针数据,所以直接使用IntPtr即可;而对于传出数据此处使用的时双重指针,因此使用out IntPtr进行接收。再获取到该方法后,我们调用new Mat(IntPtr ptr)构造方法初始化为新的Mat数据。
  如下图所示,程序在运行后,成功将传入的图片数据进行灰度转换,并将转换后的图片数据成功传递出来,说明该接口测试成功,也证明了该方法是可行的。同时我们测试了该过程所需时间,仅使用了3.69毫秒。
4.4 接口四测试

  在以下文件中分别添加以下代码:
mat_conv.h
#include "opencv2/opencv.hpp"
extern "C"__declspec(dllexport) void __stdcall mat_conv4(cv::Mat * mat);mat_conv.cpp
#include "mat_conv.h"

voidmat_conv4(cv::Mat* mat)
{
    // 矩形的左上角和右下角坐标
    cv::Point2f rect_start(50, 50);
    cv::Point2f rect_end(350, 350);
    // 矩形颜色 (B, G, R)
    cv::Scalar color(255, 0, 0); // 红色
    // 矩形线条粗细
    int thickness = 2;
    // 绘制矩形
    cv::rectangle(*mat, rect_start, rect_end, color, thickness);
}Program.cs
using OpenCvSharp;
using OpenCvSharp.Internal;
using System.Runtime.InteropServices;
namespace opencv_csharp
{
    internal class Program
    {
      static void Main(string[] args)
      {
            Console.WriteLine("Hello, World!");
            string image_path = "image.jpg";
            Mat mat4 = Cv2.ImRead(image_path);
            Methord.mat_conv4(mat1.CvPtr);
            Cv2.ImShow("image2", mat4);
            Cv2.WaitKey(0);
      }
    }

    class Methord
    {
      private const string dll_path = "C:\\Users\\lenovo\\Desktop\\test_opencv\\x64\\Release\\opencv_cpp.dll";
      
      public static extern void mat_conv4(IntPtr mat);
    }
}  其中,mat_conv.h、mat_conv.cpp为C++项目文件,Program.cs文件为C#项目文件。
  在C++项目文件中, mat_conv4(IntPtr mat)方法主要是接受传入的Mat指针,并在传入的图片数据中绘制一个矩形,因为该操作是在原始数据上进行的操作,没有残生新的图像数据,所以不需要传出。
  在C#项目中,使用属性将动态链接库中的mat_conv4读取出来,其中传入数据为指针数据,所以直接使用IntPtr即可。然后该方法运行完后,我们直接查看该图像数据信息,查看是否已经被修改。
  如下图所示,程序在运行后,结果如下图所示,说明该接口测试成功,也证明了该方法是可行的。
5. 总结

  在项目中,我们结合OpenCvSharp源码,使用OpenCvSharp数据指针实现了在C#与C++之间传递图像数据。与传统的数据传递方式相比,该方式通过传递指针,通过指针的方式实现对同一块图像数据进行操作,避免了图像数据的来回转换,极大的节省了程序运行时间以及内存消耗。
  最后如果各位开发者在使用中有任何问题,欢迎大家与我联系。

来源:https://www.cnblogs.com/guojin-blogs/p/18098931
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: 【OpenCV】OpenCV (C++) 与 OpenCvSharp (C#) 之间数据通信