Python（Windows）

您正在查看V2.3.1版本的文档。如果您想查阅其他版本的文档，可以点击页面右上角“切换版本”按钮进行切换。

■ 如果您想使用最新版本，可以从梅卡曼德下载中心下载。

■ 如果您不确定当前使用的产品是哪个版本，请随时联系梅卡曼德技术支持。

本章介绍如何在Windows系统中获取并运行Mech-Eye API的Python例程。

例程简介

目前提供了如下例程：

trigger_with_software_and_fixed_rate：通过软触发 + 固定频率的方式触发数据采集，然后获取并保存采集的数据。
trigger_with_external_device_and_fixed_rate：通过外部触发 + 固定频率的方式触发数据采集，然后获取并保存采集的数据。
trigger_with_software_and_encoder：通过软触发 + 编码器的方式触发数据采集，然后获取并保存采集的数据。
trigger_with_external_device_and_encoder：通过外部触发 + 编码器的方式触发数据采集，然后获取并保存采集的数据。
trigger_multiple_profilers_simultaneously：异步触发多台轮廓测量仪进行采集，然后获取并保存采集的数据。
manage_user_sets：管理参数组，如获取所有参数组的名称、新增参数组、切换参数组和保存参数设置至参数组。
register_profiler_event：定义并注册检测相机连接状态的回调函数。
use_virtual_device：获取虚拟设备中储存的轮廓线数据，并生成和保存强度图和深度图。

关于触发轮廓测量仪进行数据采集的不同方式，请参考触发数据采集的方式。

使用Mech-Eye API的Python例程，需先满足以下使用前提：

确保安装的Python为64位，且版本在3.7至3.11之间。

如安装Python时未勾选Add Python to PATH，请将以下两个路径添加至Path环境变量中：

Python例程包含在Mech-Eye SDK的安装路径中，也可从GitHub克隆获取。安装路径中的例程为Mech-Eye SDK发布时的版本，GitHub上的例程可能包含最新修改。

使用Mech-Eye API的Python例程，必须安装Mech-Eye SDK及Python Mech-Eye API。

请根据Mech-Eye SDK安装指南安装或升级Mech-Eye SDK。

请执行以下步骤安装最新版本的Python Mech-Eye API：

部分例程中的功能依赖OpenCV。如需使用下方列出的例程，则必须安装OpenCV（推荐最新版本）。

请执行以下命令安装最新版本的OpenCV：

pip install opencv-python

本节以安装路径中包含的例程为例提供相关路径，如使用从GitHub克隆获取的例程，需对应更改路径。

请执行以下步骤运行例程：

进入例程所在的文件夹。

cd xxx/Mech-Eye SDK-2.3.1/API/samples/python/profiler

运行例程：将sample_name替换为例程名称。例程运行过程中，请根据提示输入待连接轮廓测量仪的编号（index），并按Enter键连接轮廓测量仪。
```
python sample_name.py
```
如例程保存了图像或点云，将在例程所在文件夹中得到保存的文件。