VisionPro

本章介绍如何使用梅卡曼德提供的VisionPro例程通过C# Mech-Eye API连接相机并获取2D和3D数据。

例程简介

目前提供以下例程：

AcquireColorAndRangeImages：获取2D和深度数据，并生成康耐视格式的2D图（CogImage24PlanarColor）和深度图（CogImage16Range）。

使用VisionPro例程，需先满足以下使用前提：

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

安装路径中的例程位于xxx/Mech-Eye SDK-2.3.2/API/samples/visionpro/area_scan_3d_camera路径下；
通过GitHub克隆获取的例程位于xxx/mecheye_visionpro_samples/area_scan_3d_camera路径下。

使用VisionPro例程，必须安装Mech-Eye SDK及VisionPro。

完成必要的配置后，即可运行例程。

在VisionPro软件中调用Mech-Eye API，需先将Mech-Eye SDK的动态链接库复制至VisionPro的安装路径下。

请执行以下步骤复制动态链接库：

进入Mech-Eye SDK的安装路径并打开以下文件夹：xxx/Mech-Eye SDK-2.3.2/API/dll。
复制上述文件夹中的以下动态链接库文件（.dll）：
- MechEyeApi
- MechEyeAPiNet
- MechEyeApiWrapper
进入VisionPro的安装路径，打开其中的bin文件夹，并粘贴复制的动态链接库文件。

复制动态链接库后，需在例程中配置脚本参考程序集的路径。

请执行以下步骤配置脚本参考程序集：

打开VisionPro QuickBuild，选择文件菜单中的打开 QuickBuild 应用程序。
在弹出的窗口中，选择需使用的VisionPro例程，并单击打开按钮。
将弹出以下窗口。单击窗口中的否按钮关闭该弹窗。
可能弹出以下窗口。如弹出，单击窗口中的确定按钮关闭该弹窗。
在VisionPro QuickBuild的左边栏中，双击Mech-Eye Industrial 3D Camera。
在弹出的作业编辑器窗口的左边栏中，双击Image Acquisition。
在弹出的Image Acquisition窗口的工具栏中，单击按钮。
在弹出的Image Acquisition 脚本窗口的工具栏中，单击按钮。
在弹出的添加/移除参考程序集窗口中，滚动至最下并双击MechEyeApiNet.dll条目。
在弹出的输入程序集名称窗口中，单击浏览…按钮，导航至Mech-Eye SDK安装路径下动态链接库所在的文件夹（xxx/Mech-Eye SDK-2.3.2/API/dll），并选择MechEyeApiNet动态链接库文件。
单击输入程序集名称窗口中的确定按钮关闭该窗口，然后单击添加/移除参考程序集窗口中的确定按钮关闭该窗口。

运行例程前，需设置脚本中相机的IP地址，以便成功连接相机。

可通过Mech-Eye Viewer或IP配置工具查看并更改相机的IP地址。

请执行以下步骤设置相机的IP地址：

在Image Acquisition 脚本窗口中，找到以下行，并将其中的IP地址更改为待连接相机的实际IP地址。
```
static string cameraIp="192.168.23.245";
```
单击工具栏中的按钮使修改生效。
关闭Image Acquisition 脚本和Image Acquisition窗口，返回至作业编辑器窗口。

请执行以下步骤运行例程并查看获取的2D图和深度图：

在作业编辑器窗口的工具栏中，单击按钮运行例程。
在左边栏中，双击对应的工具查看获取的2D图或深度图：
- 2D图：双击CogAffineTransformTool1。
- 深度图：双击Cog3DVisionDataReRenderTool1。
如果获取的图像不满足要求，请根据下一节的内容调节相机的参数，以提升数据质量。

相机的参数可通过Mech-Eye Viewer调节，或在例程中通过C# Mech-Eye API调节。推荐使用Mech-Eye Viewer调节参数，可在图形化界面中即时采集数据确认参数调节的效果。

使用Mech-Eye Viewer调节参数：请参考操作指南在Mech-Eye Viewer中连接相机、采集数据、查看当前参数值并调节参数。
在例程中通过C# Mech-Eye API调节参数：使用例程调节相机参数，需在例程脚本中添加对应的C# Mech-Eye API方法。请参考以下内容编辑例程脚本。
- C# Mech-Eye API例程：例程简介、获取方式和使用指南请参考C#。
- Mech-Eye API参考手册：提供C++ Mech-Eye API方法的说明。