opencv传递mat类size_OpenCV-Python Binding（读书笔记）

雨点打透心脏的1/2处 2022-10-27 01:48 218阅读 0赞

![e83e704085545ed9fe35f68c614db7c2.png][]

可参考翻译原文：https://github.com/fendouai/OpenCVTutorials

OpenCV-Python Binding的思维导图，提炼关键点。

![5400714286bbdaaf5d438c06584854e7.png][]

## **11.OpenCV-Python Binding** ##

**1 目标**

了解：

1.如何生成OpenCV-Python bindings？

2.如何将新的OpenCV模块扩展到Python？

**2 OpenCV-Python bindings如何生成？**

1. 在OpenCV中，所有算法均以C ++实现。

2.但是这些算法可以从不同的语言（例如Python，Java等）中使用。绑定生成器使这成为可能。

3.这些生成器在C ++和Python之间建立了桥梁，使用户能够从Python调用C ++函数。为了全面了解后台发生的事情，需要对Python / C API有充分的了解。

4. 因此，通过手动编写包装函数将OpenCV中的所有函数扩展到Python是一项耗时的任务。因此，OpenCV以更智能的方式进行操作。

***2.1 生成器脚本目录：modules/python/src2***

1. OpenCV使用位于modules/python/src2中的一些Python脚本，从C ++头自动生成这些包装器函数。

***2.2 自动监测脚本：modules/python / CMakeFiles.txt***

1. 首先，modules/python / CMakeFiles.txt是一个CMake脚本，用于检查要扩展到Python的模块。

2. 它将自动检查所有要扩展的模块并获取其头文件。

3. 这些头文件包含该特定模块的所有类，函数，常量等的列表。

***2.3 生成器脚本：modules/python/src2/gen2.py***

1. 其次，将这些头文件传递到Python脚本modules/python/src2/gen2.py。

2. 这是Python Binding生成器脚本。

3. 它调用另一个Python脚本module/python/src2/hdr\_parser.py。

***2.4 标头解析器脚本：module/python/src2/hdr\_parser.py***

1. 这是标头解析器脚本。

2. 此标头解析器将完整的标头文件拆分为较小的Python列表。因此，这些列表包含有关特定函数，类等的所有详细信息。

3. 例如，将对一个函数进行解析以获取一个包含函数名称，返回类型，输入参数，参数类型等的列表。最终列表包含所有函数，枚举的详细信息，头文件中的structs，classs等。

***2.5 宏使标头解析器可以标识要解析的函数***

1. 但是标头解析器不会解析标头文件中的所有函数/类。

2. 开发人员必须指定应将哪些函数导出到Python。

3. 为此，在这些声明的开头添加了某些宏，这些宏使标头解析器可以标识要解析的函数。

4. 这些宏由对特定功能进行编程的开发人员添加。简而言之，开发人员决定哪些功能应该扩展到Python，哪些不应该。这些宏的详细信息将在下一个会话中给出。

***2.6 生成的标头文件：build/modules/python/***

1. 因此头解析器将返回已解析函数的最终大列表。

2. 我们的生成器脚本（gen2.py）将为 标头解析器解析的所有函数/类/枚举/结构 创建包装函数（你可以在编译期间在build/modules/python/文件夹中以pyopencv\_genic\_\*.h文件找到这些标头文件）。

***2.7 手动扩展：modules/python/src2/cv2.cpp***

1. 但是可能会有一些基本的OpenCV数据类型，例如Mat，Vec4i，Size。它们需要手动扩展。

2. 例如，Mat类型应扩展为Numpy数组，Size应扩展为两个整数的元组，等等。

3. 类似地，可能会有一些复杂的结构/类/函数等需要手动扩展。

4. 所有这些手动包装函数都放在modules/python/src2/cv2.cpp中。

***2.8 包装文件的编译***

1. 所以现在剩下的就是这些包装文件的编译了，这给了我们\*\*cv2\*\*模块。

2. 因此，当你调用函数时，例如在Python中说res = equalizeHist(img1,img2)，你将传递两个numpy数组，并期望另一个numpy数组作为输出。

3. 因此，将这些numpy数组转换为cv::Mat，然后在C++中调用\*\*equalizeHist\*\*()函数。

4. 最终结果将res转换回Numpy数组。

5. 简而言之，几乎所有操作都是在C++中完成的，这给了我们几乎与C++相同的速度。

**3 如何扩展新的模块到Python？**

1. 头解析器根据添加到函数声明中的一些包装宏来解析头文件。 枚举常量不需要任何包装宏。 它们会自动包装。 但是其余的函数，类等需要包装宏。

***3.1 宏扩展功能：CV\_EXPORTS\_W***

1. 使用CV\_EXPORTS\_W宏扩展功能。 一个例子如下所示。

CV\_EXPORTS\_W void equalizeHist( InputArray src, OutputArray dst );

***3.2 使用CV\_OUT,CV\_IN\_OUT等宏对输入和输出进行硬编码***

1. 标头解析器可以理解诸如InputArray，OutputArray等关键字的输入和输出参数。但是有时，我们可能需要对输入和输出进行硬编码。 为此，使用了CV\_OUT,CV\_IN\_OUT等宏。

***3.3 对于大类，也使用CV\_EXPORTS\_W***

***3.4 扩展类方法，使用CV\_WRAP。CV\_PROP用于类字段***

1. 对于大类，也使用CV\_EXPORTS\_W。为了扩展类方法，使用CV\_WRAP。同样，CV\_PROP用于类字段。

class CV\_EXPORTS\_W CLAHE : public Algorithm

public:

CV\_WRAP virtual void apply(InputArray src, OutputArray dst) = 0;

CV\_WRAP virtual void setClipLimit(double clipLimit) = 0;

CV\_WRAP virtual double getClipLimit() const = 0;

***3.5 扩展重载的函数：CV\_EXPORTS\_AS***

1. 可以使用CV\_EXPORTS\_AS扩展重载的函数。

2. 但是我们需要传递一个新名称，以便在Python中使用该名称调用每个函数。

3. 以下面的积分函数为例。 提供了三个函数，因此每个函数在Python中都带有一个后缀。

CV\_EXPORTS\_W void integral( InputArray src, OutputArray sum, int sdepth = -1 );

CV\_EXPORTS\_AS(integral2) void integral( InputArray src, OutputArray sum,

OutputArray sqsum, int sdepth = -1, int sqdepth = -1 );

CV\_EXPORTS\_AS(integral3) void integral( InputArray src, OutputArray sum,

OutputArray sqsum, OutputArray tilted,

int sdepth = -1, int sqdepth = -1 );

***3.6 包装重载方法：CV\_WRAP\_AS***

***3.7 小类/结构使用CV\_EXPORTS\_W\_SIMPLE进行扩展***

1. 小类/结构使用CV\_EXPORTS\_W\_SIMPLE进行扩展。

2. 这些结构按值传递给C ++函数。 示例包括KeyPoint,Match等。

3. 它们的方法由CV\_WRAP扩展，而字段由CV\_PROP\_RW扩展。

class CV\_EXPORTS\_W\_SIMPLE DMatch

public:

CV\_WRAP DMatch();

CV\_WRAP DMatch(int \_queryIdx, int \_trainIdx, float \_distance);

CV\_WRAP DMatch(int \_queryIdx, int \_trainIdx, int \_imgIdx, float \_distance);

CV\_PROP\_RW int queryIdx; // query descriptor index

CV\_PROP\_RW int trainIdx; // train descriptor index

CV\_PROP\_RW int imgIdx; // train image index

CV\_PROP\_RW float distance;

\};

***3.8 导出小类/结构到Python本机字典中***

1. 可以使用CV\_EXPORTS\_W\_MAP导出其他一些小类/结构，并将其导出到Python本机字典中。Moments()就是一个例子。

class CV\_EXPORTS\_W\_MAP Moments

public:

CV\_PROP\_RW double m00, m10, m01, m20, m11, m02, m30, m21, m12, m03;

CV\_PROP\_RW double mu20, mu11, mu02, mu30, mu21, mu12, mu03;

CV\_PROP\_RW double nu20, nu11, nu02, nu30, nu21, nu12, nu03;

\};

***3.9 自己的pyopencv\_\*.hpp扩展标头***

1. 通常，开发人员必须将适当的宏放在适当的位置。其余的由生成器脚本完成。

2. 有时，在某些特殊情况下，生成器脚本无法创建包装。此类函数需要手动处理，为此，你需要编写自己的pyopencv\_\*.hpp扩展标头，并将其放入模块的misc / python子目录中。

3. 但是大多数时候，根据OpenCV编码指南编写的代码将由生成器脚本自动包装。

***3.10 为Python提供C ++接口中不存在的其他功能***

1. 更高级的情况涉及为Python提供C ++接口中不存在的其他功能，例如额外的方法，类型映射或提供默认参数。稍后，我们将以UMat数据类型为例。

***3.10.1 额外的方法：CV\_WRAP\_PHANTOM***

1. 首先，要提供特定于Python的方法，CV\_WRAP\_PHANTOM的用法与CV\_WRAP相似，不同之处在于它以方法标头作为参数，并且你需要在自己的pyopencv\_\*.hpp扩展名中提供方法主体。

2. UMat::queue()和UMat::context()是此类幻象方法的示例，这些幻象方法在C++接口中不存在，但在Python端处理OpenCL功能时需要使用。

***3.10.2 数据类型映射：CV\_WRAP\_MAPPABLE***

1. 其次，如果一个已经存在的数据类型可以映射到你的类，则最好使用CV\_WRAP\_MAPPABLE以源类型作为其参数来指示这种容量，而不是精心设计自己的绑定函数。

2. 从Mat映射的UMat就是这种情况。

***3.10.3 默认参数： CV\_WRAP\_DEFAULT***

1. 最后，如果需要默认参数，但本机C++接口中未提供，则可以在Python端将其作为CV\_WRAP\_DEFAULT的参数提供。

***3.10.4 UMat::getMat示例***

class CV\_EXPORTS\_W UMat

public:

// 你需要提供 \`static bool cv\_mappable\_to(const Ptr<Mat>& src, Ptr<UMat>& dst)\`

CV\_WRAP\_MAPPABLE(Ptr<Mat>);

/! returns the OpenCL queue used by OpenCV UMat.

// 你需要在资料夹代码中提供方法主体

CV\_WRAP\_PHANTOM(static void\* queue());

// 你需要在资料夹代码中提供方法主体

CV\_WRAP\_PHANTOM(static void\* context());

CV\_WRAP\_AS(get) Mat getMat(int flags CV\_WRAP\_DEFAULT(ACCESS\_RW)) const;

\};

[e83e704085545ed9fe35f68c614db7c2.png]: /images/20221024/30272820b35b4bcda4f5995d555c371b.png
[5400714286bbdaaf5d438c06584854e7.png]: /images/20221024/a1132236222b452c9d9d7bbd064d94a2.png

opencv传递mat类size_OpenCV-Python Binding（读书笔记）

发表评论取消回复

还没有评论，来说两句吧...

相关阅读

相关 OpenCV学习笔记：MAT解析

相关 OpenCV3学习笔记（3）：认识Mat类及其创建

相关 opencv传递mat类size_OpenCV-Python Binding（读书笔记）

相关 OpenCv Mat -类成员函数

相关 OpenCV中矩阵类详解：Mat

相关 opencv笔记（八）——OpenCV中Mat总结

相关 opencv笔记（九）——Mat和IPLImage

相关 opencv笔记（零）——OpenCV参考手册之Mat类详解

相关 opencv Mat类基础知识

相关 opencv 的 Mat 类使用笔记