Python（Windows）

示例程序简介

Python 示例程序位于 {Vcamera SDK 安装路径}/Percipio_SDK/API/python/python，包含：

  • DepthToColorRegistration.py：将相机输出的深度图与彩色图对齐。

  • FetchFrame.py：设置相机工作在自由采集模式下采集深度图。

  • ListDevices.py：列举所有连接到电脑上的相机。

  • SoftTrigger.py：设置相机工作在软触发模式，发送软触发指令后，相机采集深度图。

  • version.py：显示当前 SDK 的版本。

  • DumpAllFeatures.py：列举相机支持的属性。

  • DumpDeviceInfo.py：列举相机的信息。

  • ReadWriteFeatures.py：列举相机支持的所有可读可写的属性。

  • SetIpAddress.py：设置静态 IP 地址。

  • UserSetSelector.py：选择用户配置。

  • LogConfig.py：配置 Vcamera SDK 软件与相机硬件双重日志系统。

  • DepthToPointCloud.py：将相机输出的深度图与点云图对齐。

  • SaveLoadFeaturesViaFile.py：保存与加载相机功能。

安装依赖

安装依赖1———Python

注解

推荐安装 Python 3.8 版本（此版本经测试 100% 兼容支持，其他版本未经测试，不保证兼容性）。

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

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

    ../_images/python-load.png

    Python 安装

安装依赖2———CMake

注解

推荐安装 CMake 3.25 版本（此版本经测试 100% 兼容支持，其他版本未经测试，不保证兼容性）。

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

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

Cmake-configuration

CMake 环境配置

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

    cmake --version

安装依赖3———Visual Studio

注解

推荐安装 Visual Studio 2022 版本（此版本经测试 100% 兼容支持，其他版本未经测试，不保证兼容性）。

下载并安装 Visual Studio 。

安装依赖4———OpenCV

pip install opencv-python

编译

  1. 在 {Vcamera SDK 安装路径}/Percipio_SDK/API/python 目录下，新建 build 文件夹。

  2. 启动 cmake-gui。

  3. 指定源码目录到 “python”，编译输出目录为 “python/build”。

    vcamera-compile-dir

  4. 点击 Configure，选择 Visual Studio 的版本并点击 Finish 。

    vcamera-compile-configure

  5. 点击 Generate。

    vcamera-compile-generate

  6. 点击 Open Project，打开工程。

    vcamera-compile-openpro

  7. 选择 “Release x64”，点击 “生成” > “生成解决方案”。

    vcamera-compile-end

运行

  1. 将 Percipio_SDK/API/python/build/Release 路径下全部文件拷贝至 Percipio_SDK/API/python/python 中。

  2. 将 Percipio_SDK/API/cpp/Release/bin 中的动态库文件 （除可执行文件 .exe 外的所有文件）拷贝到 Percipio_SDK/API/python/python/TyLibrary 中。

  3. 在 Percipio_SDK/API/python/python 路径下打开终端，运行示例程序。

    vcamera-compile-end