Python (Windows 平台)

下载 Camport Multi_language SDK

选择以下任意方式，下载 Camport Multi_language SDK：

  • 使用浏览器下载：https://gitee.com/percipioxyz/camport_multi_language.git。

  • 使用 git 指令获取本地副本：打开终端，切换到需存放 SDK 的工作目录下，输入 git clone 命令克隆远程仓库。

    git clone https://gitee.com/percipioxyz/camport_multi_language.git

示例程序说明

示例程序存放在开发包根目录 python 文件夹内，具体示例程序说明见：Python 示例程序列表。

安装依赖

安装 Python（3.8 版本）

  1. 在 Python 官网 下载规定版本。

  2. 双击安装包，勾选 “Add Python to PATH”，点击 “Install Now”。

    ../_images/python-load.png

    Python 安装

安装 NumPy 和 OpenCV

pip install numpy
pip install opencv-python

安装 SWIG （4.0.2 或以上版本）

  1. 在 SWIG 官网 下载 Windows 预编译包。

  2. 解压文件后，配置环境变量。

    右键 此电脑，选择 属性 > 高级系统属性 > 环境变量，在 环境变量 页面中将本地 SWIG 的可执行文件路添加到系统变量的 Path 中。

    ../_images/setpathforswig.gif

    SWIG 环境配置

安装 CMake（3.15.0 或以上版本）

  1. 在 CMake 官网 下载 Windows 安装包。

  2. 双击下载的 .msi 文件，按照提示完成安装。在安装过程中，勾选 “Add CMake to PATH”，将 CMake 添加到系统环境变量。

    Cmake-configuration

    CMake 环境配置

  3. 打开命令提示符（CMD），输入以下命令，验证安装是否成功，若显示版本号，则安装成功。

    cmake --version

安装 Visual Studio

下载并安装 Visual Studio。

注解

安装库或依赖时，在规定版本的基础上优先选择 稳定版本 。

编译

按照以下步骤，编译示例代码：

  1. 打开 camport_multi_language 目录下 CMakeLists.txt，修改文件中的编译目标语言（PYTHON）、 PYTHON 版本 、SWIG 的本地路径，如下图所示：

    ../_images/editcmakelistpython.png

小技巧

编译时若因 SWIG 路径或版本问题中断，可手动选择正确的 SWIG 路径或版本，设置后无需退出，直接继续编译即可。

../_images/Selectionpath.png

  1. 在 camport_multi_language 目录下创建一个新的文件夹，命名为 python_build_x64。

  2. 启动 cmake-gui，指定源码目录到 ``camport_multi_language``，指定编译输出目录到 ``camport_multi_language/python_build_x64``。

    ../_images/specifydirectorypython.png

  3. 点击 Configure，选择 Visual Studio 版本和 X86/X64 版本的设置。

    ../_images/clickcongifure_CP.png

  4. 点击 Generate。

  5. 点击 Open Project 打开工程后，在 Visual Studio 菜单栏中选择 Release 并依次点击 生成 > 生成解决方法。

    ../_images/pythonmake.png

编译后，将生成的动态库 pcammls.py、 _pcammls.pyd 以及 camport3 目录下的 tycam.dll 复制到 ``camport_multi_language/python`` 目录下，打开 Windows PowerShell 并运行生成的 python 文件即可。

  • pcammls.py ：``python_build_x64/swig/swig/_output``

  • _pcammls.pyd ：``python_build_x64/swig/Release``

  • tycam.dll ：``camport3/lib/win/hostapp/x64``

../_images/pythonrun.png