Python¶
本章将介绍如何在 Windows 上运行 Python 例程。
例程简介¶
例程分为 5 类：Basic、Advanced、Util、Laser 和 UHP。
Basic
ConnectToCamera：连接相机。
ConnectAndCaptureImage：连接相机并获取 2D 图、深度图及点云数据。
CaptureColorMap：从相机获取并保存 2D 图。
CaptureDepthMap：从相机获取并保存深度图。
CapturePointCloud：使用单个曝光时间采集图像，生成并保存白色点云和彩色点云。
CaptureHDRPointCloud：使用多个曝光时间采集图像，生成并保存白色点云和彩色点云。
CapturePointCloudROI：获取并保存感兴趣区域内的白色点云和彩色点云。
CapturePointCloudFromTextureMask：从覆盖掩膜的 2D 图和深度图生成并保存白色点云和彩色点云。
Advanced
CaptureCloudFromDepth：从 2D 图与深度图生成并保存点云。
CaptureSequentiallyMultiCamera：使用多台相机按序获取并保存 2D 图、深度图及点云。
CaptureSimultaneouslyMultiCamera：使用多台相机同时获取并保存 2D 图、深度图及点云。
CaptureTimedAndPeriodically：在设定时间内，定时获取并保存 2D 图、深度图和点云。
Util
GetCameraIntri：获取并打印相机内参。
PrintDeviceInfo：获取并打印相机型号、序列号、固件版本、温度等信息。
SetDepthRange：设置相机深度范围。
SetParameters：设置相机参数。
SetUserSets：执行参数组相关功能，如获取参数组名称，修改参数组名称，保存参数组参数信息等。通过参数组可以保存一组参数值并快速应用。
Laser
SetLaserFramePartitionCount：将投影仪视野分为多个分区，结构光一次投射到一个分区。整个视野的输出由所有分区的图像融合而成。
SetLaserFrameRange：设置结构光投射范围，整个视野范围从 0 到 100。
SetLaserFringeCodingMode：设置结构光样式的编码模式。
SetLaserPowerLevel：设置激光器的输出功率（最大输出功率的百分比），影响激光强度。
UHP
SetUHPCaptureMode：设置采集模式（分为：2D 相机 1，2D 相机 2 及同时使用两个 2D 相机并融合输出）。
SetUHPFringeCodingMode：设置结构光样式的编码模式。
准备工作¶
下载 Python 例程 。依次单击 即可下载。
确保 Python 版本在 3.6.5 至 3.10 之间。
注意
如安装Python时未勾选 Add Python to PATH，请将以下两个路径添加至 Path 环境变量中：
xxx\AppData\LocalProgramsPython\Python36\
xxx\AppData\LocalProgramsPython\Python36\Scripts\
使用指南¶
Python 相关配置¶
以管理员身份运行 Windows PowerShell 。
必装： MechEyeAPI 。
pip install MechEyeAPI
若安装报错，可使用以下命令:
pip install MechEyeAPI -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com
可选：open3d 和 opencv-python。
例程
open3d
opencv-python
CaptureColorMap
√
CaptureDepthMap
√
CapturePointCloud
√
CaptureHDRPointCloud
√
CapturePointCloudROI
√
CaptureCloudFromDepth
√
安装命令：
pip install opencv-python
运行例程¶
以 CaptureColorMap.exe 为例：
使用 cd 命令切换到 CaptureColorMap.py 所在的目录。
cd XXX\mecheye_python_samples\source\Basic
运行例程。
python CaptureColorMap.py
例程运行完成后，将在 Basic 目录下得到：ColorMap （彩色图）。
