12

如何从 C/C++ 扩展源代码到 Windows 的 pyd 文件(或我可以导入到 Python 的其他项目)?

编辑:我想使用的特定库(BRISK)包含在OpenCV 2.4.3 中,所以我对这项技能的需求暂时消失了。如果您来这里寻找 BRISK,这里是我发布的 Python 演示中的简单 BRISK 。


我有想要在我的 python 应用程序中构建和使用的Brisk源代码(下载)。我已经生成了一个 brisk.pyd 文件......但它是 0 字节。如果有更好/替代的方法来瞄准 brisk.pyd 文件,那么我当然也愿意接受。

编辑:请忽略下面我原始问题中的所有尝试,并查看我的答案,这是通过 obmarg 的详细演练实现的

我哪里错了?

  1. 没有库路径的 Distutils:首先我尝试使用 distutils 和以下 setup.py 构建源代码(我刚刚开始学习 distutils,所以这是在黑暗中拍摄)。BRISK源代码的结构在这个问题的底部供参考。

    from distutils.core import setup, Extension
    module1 = Extension('brisk',
        include_dirs = ['include', 'C:/opencv2.4/build/include', 'C:/brisk/thirdparty/agast/include'],
        #libraries = ['agast_static', 'brisk_static'],
        #library_dirs = ['win32/lib'],
        sources = ['src/brisk.cpp'])
    setup (name = 'BriskPackage',
        ext_modules = [module1])
    

    这立即给了我以下几行和构建文件夹中某处的0 字节 brisk.pyd 。很近?

    running build
    running build_ext
    
  2. 带有库路径的 Distutils:暂缓该尝试。所以我添加了上面 setup.py 中注释掉的两个库行。在我得到这个链接错误之前,这似乎没问题:

    creating build\lib.win32-2.7
    C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\BIN\link.exe /DLL /nologo /INCREMENTAL:NO /LIBPATH:win32/lib /LIB
    PATH:C:\Python27_32bit\libs /LIBPATH:C:\Python27_32bit\PCbuild agast_static.lib brisk_static.lib /EXPORT:initbrisk build
    \temp.win32-2.7\Release\src/brisk.obj /OUT:build\lib.win32-2.7\brisk.pyd /IMPLIB:build\temp.win32-2.7\Release\src\brisk.
    lib /MANIFESTFILE:build\temp.win32-2.7\Release\src\brisk.pyd.manifest
    LINK : error LNK2001: unresolved external symbol initbrisk
    build\temp.win32-2.7\Release\src\brisk.lib : fatal error LNK1120: 1 unresolved externals
    error: command '"C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\BIN\link.exe"' failed with exit status 1120
    
  3. 不受控制的甩尾:我认为可能需要构建库,所以我用 cmake + mingw - mingw + vc++ express 2010 做了一个速成课程(很多崩溃),如下所示:

    • cmake gui:来源:c:/brisk,构建:c:/brisk/build
    • cmake gui:为 Visual Studio 10 配置
    • cmake gui:使用默认选项并生成(CMAKE_BACKWARDS_COMPATIBILITY、CMAKE_INSTALL_PREFIX、EXECUTABLE_OUTPUT_PATH、LIBRARY_OUTPUT_PATH)
    • VC++ Express 10:更改为发布并构建由 cmake 生成的解决方案,并获得大约 20 页看起来像非关键警告的内容,然后全部成功。注意 - 不会由此生成任何 dll。它确实会生成以下与下载中包含的类似大小的库:

      win32/lib/Release/
          agast_static.lib
          brisk_static.lib
      
  4. 进一步挥舞。

相关BRISK源文件结构供参考:

build/ (empty)
include/brisk/
    brisk.h
    hammingsse.hpp
src
    brisk.cpp
    demo.cpp
thirdparty/agast/
    include/agast/
        agast5_8.h ....
        cvWrapper.h
    src/
        agast5_8.cc ...
    CMakeLists.txt
win32/
    bin/
        brisk.mexw32
        opencv_calib3d220.dll ...
    lib/
        agast_static.lib
        brisk_static.lib
CMakeLists.txt
FindOpenCV.cmake
Makefile
4

2 回答 2

14

您确定这个轻快的库甚至可以导出 python 绑定吗?我在源代码中看不到对它的任何引用——它甚至似乎都没有导入 python 头文件。这肯定会解释为什么到目前为止你还没有取得太大的成功——你不能只编译普通的 C++ 代码并期望 python 与之交互。

我认为您的第二个 distutils 示例最接近正确-它显然是在编译内容并进入链接器阶段,但是随后您遇到了此错误。该错误仅意味着它找不到名为 initbrisk 的函数,我猜这将是模块的顶级 init 函数。这再次表明您正在尝试从不适合它的代码编译 python 模块。

如果您想自己将 C++ 代码包装在 python 包装器中,您可以查看有关编写 c/c++ 扩展的官方文档。或者,您可以查看boost::pythonSIPshiboken,它们试图在某种程度上(或完全)自动化从 C++ 代码制作 python 扩展的过程。

编辑:由于您似乎已经做出了相当大的努力来自己解决问题并发布了一个很好的问题,因此我决定就如何进行此操作提供更详细的回复。

使用 boost::python 包装 C++ 库的快速教程

就我个人而言,我只使用过 boost::python 来处理这样的事情,所以我会试着给你一个很好的总结,告诉你如何去做。我将假设您使用的是 Visual C++ 2010。我还将假设您已经安装了 32 位版本的 python,因为我相信 boost pro 库仅提供 32 位二进制文​​件。

安装升压

首先,您需要获取 boost 库的副本。最简单的方法是从boost pro 网站下载安装程序。这些应该安装在 Windows 上使用 boost c++ 库所需的所有头文件和二进制文件。记下将这些文件安装到的位置,因为稍后您将需要它们 - 最好安装到其中没有空格的路径。为方便起见,我假设您将这些文件放在 C:\boost 中,但您可以将其替换为您实际使用的路径。

或者,您可以按照这些说明从源代码构建提升。我不是 100% 确定,但您可能要这样做才能获得与您安装的 python 版本兼容的 boost::python 版本。

设置视觉工作室项目

接下来,您需要为 brisk.pyd 设置一个 Visual Studio 项目。如果您打开 Visual Studio,请转到新建 -> 项目,然后找到 Win32 项目的选项。设置您的位置等,然后单击确定。在出现的向导中选择一个 DLL 项目类型,然后勾选空项目复选框。

现在您已经创建了项目,您需要设置包含和库路径以允许您使用 python、boost::python 和 brisk.lib 文件。

在 Visual Studios 解决方案资源管理器中,右键单击您的项目,然后从出现的菜单中选择属性。这应该会为您的项目打开属性页。转到 Linker -> General 部分并查找 Additional Library Directories 部分。您需要使用.libboost、python 和您的brisk_static.lib. 通常,这些可以在您安装库的任何位置的lib(或)子目录中找到。libs路径用分号分隔。我在下面附上了我的设置截图:

其他库目录设置

接下来,您需要让 Visual Studio 链接到 .lib 文件。这些部分可以在属性的 Linker -> Input 部分的 Additional Dependencies 字段中找到。同样,它是一个分号分隔的列表。您应该需要为 python 添加库(在我的情况下是这样,python27.lib但这会因版本而异)和brisk_static.lib. 这些不需要您在上一阶段添加的完整路径。同样,这是一个屏幕截图:

附加依赖项设置

可能还需要添加 boost_python 库文件,但我认为boost 使用了一些头文件魔术来为您省去麻烦。如果我不正确,请查看您提升库路径以查找名为类似于的文件并将其boost_python-vc100-mt.lib添加。

最后,您需要设置包含路径以允许您的项目包含相关的 C++ 头文件。要使相关设置出现在项目属性中,您需要将 .cpp 文件添加到您的项目中。右键单击解决方案资源管理器中的源文件文件夹,然后转到添加新项目。选择一个 C++ 文件 (.cpp) 并将其命名为 main.cpp(或您想要的任何其他名称)。

接下来,返回您的项目属性并转到 C/C++ -> 常规。在附加库目录下,您需要添加 brisk、python 和 boost 的包含路径。再一次,分号用于分隔符,这里又是一个屏幕截图:

在此处输入图像描述

我怀疑您可能需要更新这些设置以包括 opencv2 和 agast 库,但我将把它留给您来解决 - 它应该是相同的过程。

用 boost::python 包装现有的 c++ 类。

现在有点棘手 - 实际上编写 C++ 以将您的轻快库包装在 boost python 中。你可以在这里找到一个教程,但我也会试着复习一下。

这将在main.cpp您之前创建的文件中进行。首先,在文件顶部添加您需要的相关包含语句:

#include <brisk/brisk.h>
#include <Python.h>
#include <boost/python.hpp>

接下来,您需要声明您的 python 模块。我假设你希望这被称为轻快,所以你做这样的事情:

BOOST_PYTHON_MODULE(brisk)
{
}

这应该告诉 boost::python 创建一个名为brisk.

接下来,它只是遍历所有要包装的类和结构并用它们声明 boost python 类的情况。类的声明都应该包含在 brisk.h 中。您应该只包装类的公共成员,而不是任何受保护或私有成员。作为一个简单的例子,我在这里做了几个结构:

BOOST_PYTHON_MODULE(brisk)
{
    using namespace boost::python;

    class_< cv::BriskPatternPoint >( "BriskPatternPoint" )
         .def_readwrite("x", &cv::BriskPatternPoint::x)
         .def_readwrite("y", &cv::BriskPatternPoint::y)
         .def_readwrite("sigma", &cv::BriskPatternPoint::sigma);

    class< cv::BriskScaleSpace >( "BriskScaleSpace", init< uint8_t >() )
         .def( "constructPyramid", &cv::BriskScaleSpace::constructPyramid );
}

在这里,我包装了 cv::BriskPatternPoint 结构和 cv::BriskScaleSpace 类。一些快速的解释:

class_< cv::BriskPatternPoint >( "BriskPatternPoint" )告诉 boost::python 声明一个类,使用cv::BriskPatternPointC++ 类,并像BriskPatternPoint在 python 中一样公开它。

.def_readwrite("y", &cv::BriskPatternPoint::y)向类添加可读和可写属性BriskPatternPoint。该属性名为 y,并将映射到BriskPatternPoint::yc++ 字段。

class< cv::BriskScaleSpace >( "BriskScaleSpace", init< uint8_t >() )这次声明了另一个类,BriskScaleSpace但还提供了一个接受 uint8_t 的构造函数(一个无符号字节 - 它应该只映射到 python 中的一个整数,但我要小心不要传入一个大于 255 字节的字节 - 我不知道在那种情况下会发生什么)

以下.def行只是声明了一个函数 - boost::python 应该(我认为)能够自动确定函数的参数类型,因此您不需要提供它们。

可能值得注意的是,我实际上并没有编译任何这些示例——它们很可能根本不起作用。

无论如何,要让这个在 python 中完全工作,它应该只是对你希望从 python 访问的每个结构、类、属性和函数做类似的事情——这可能是一项相当耗时的任务!

如果你想看到另一个例子,我在这里做了这个来结束这个类

构建和使用扩展

Visual Studio 应该负责构建扩展 - 然后使用它只是获取 .DLL 并将其重命名为 .pyd 的情况(您可以让 VS 为您执行此操作,但我将由您决定)。

然后你只需要将你的 python 文件复制到你的 python 路径上的某个地方(site-packages例如),导入它并使用它!

import brisk

patternPoint = brisk.BriskPatternPoint()
....    

无论如何,我花了一个小时左右的时间来写这篇文章——所以我要在这里停下来。如果我遗漏了任何内容或有任何不清楚的地方,我深表歉意,但我主要是凭记忆这样做的。希望它对您有所帮助。如果您需要澄清任何事情,请发表评论或提出其他问题。

于 2012-06-06T15:46:13.237 回答
4

如果有人需要它,这是我到目前为止所拥有的。基本上是一个BriskFeatureDetector,可以在 Python 中创建,然后调用检测。其中大部分只是确认/复制 obmarg 向我展示的内容,但我已经添加了一直到 pyd 库的详细信息。

检测方法对我来说仍然不完整,因为它不转换数据类型。任何知道改善这一点的好方法的人,请做!例如,我确实找到了这个库,它似乎将 numpy ndarray 转换为 cv::Mat,但我现在没有时间弄清楚如何集成它。还有其他数据类型需要转换。

安装OpenCV 2.2

  • 对于下面的设置,我安装到C:\opencv2.2
  • 2.4 版对 API 或实现进行了更改,这给我带来了问题(可能是新的算法对象?),所以我坚持使用 BRISK 开发的 2.2。

使用 Boost Python安装Boost

  • 对于下面的设置,我安装到C:\boost\boost_1_47

创建一个 Visual Studio 10 项目:

  • 新项目 --> win32
  • 对于下面的设置,我将其命名为brisk
  • next --> DLL 应用程序类型;空项目 --> 完成
  • 在顶部,从Debug Win32 更改为Release Win32

在源文件中创建 main.cpp

在项目设置之前执行此操作,以便 C++ 选项在项目设置中可用

#include <boost/python.hpp>
#include <opencv2/opencv.hpp>
#include <brisk/brisk.h>

BOOST_PYTHON_MODULE(brisk)
{
    using namespace boost::python;

    //this long mess is the only way I could get the overloaded signatures to be accepted
    void (cv::BriskFeatureDetector::*detect_1)(const cv::Mat&,
                std::vector<cv::KeyPoint, std::allocator<cv::KeyPoint>>&,
                const cv::Mat&) const
                = &cv::BriskFeatureDetector::detect;
    void (cv::BriskFeatureDetector::*detect_vector)(const std::vector<cv::Mat, std::allocator<cv::Mat>>&,
                std::vector< std::vector< cv::KeyPoint, std::allocator<cv::KeyPoint>>, std::allocator< std::vector<cv::KeyPoint, std::allocator<cv::KeyPoint>>>>&,
                const std::vector<cv::Mat, std::allocator<cv::Mat>>&) const
                = &cv::BriskFeatureDetector::detect;

    class_< cv::BriskFeatureDetector >( "BriskFeatureDetector", init<int, int>())
        .def( "detect", detect_1)
    ;
}

项目设置(右键单击项目 --> 属性):

  1. 包括/标题

    • 配置属性 --> C/C++ --> 常规
    • 添加到附加包含目录(调整到您自己的 python / brisk / 等基本路径):

      C:\opencv2.2\include;

      C:\boost\boost_1_47;

      C:\brisk\include;C:\brisk\thirdparty\agast\include;

      C:\python27\include;

  2. 库(链接器)

    • 配置属性 --> 链接器 --> 常规
    • 添加到附加库目录(调整到您自己的 python / brisk / 等基本路径):

      C:\opencv2.2\lib;

      C:\boost\boost_1_47\lib;

      C:\brisk\win32\lib;

      C:\python27\Libs;

    • 配置属性 --> 链接器 --> 输入

    • 添加到附加依赖项(调整到您自己的 python / brisk / 等基本路径):

      opencv_imgproc220.lib;opencv_core220.lib;opencv_features2d220.lib;

      agast_static.lib; brisk_static.lib;

      python27.lib;

  3. .pyd 输出而不是 .dll

    • 配置属性 --> 常规
    • 将目标扩展更改为 .pyd

如有必要,构建和重命名

  • 右键单击解决方案并构建/重建
  • 您可能需要将输出从“Brisk.pyd”重命名为“brisk.pyd”,否则 python 会给您有关无法加载 DLL 的错误
  • 通过将 brisk.pyd 放在站点包中或放置一个链接到其路径的 .pth 文件,使 python 可以使用 brisk.pyd

更新路径环境变量

  • 在 Windows 设置中,确保您的路径中包含以下内容(再次调整为您的路径):

    `C:\boost\boost_1_47\lib;C:\brisk\win32\bin`
    
于 2012-06-11T15:26:53.727 回答