C#
本章介绍如何在Windows系统中使用Visual Studio构建Mech-Eye API的C#例程。
例程简介
目前提供了如下例程:
-
AcquireProfileData:获取轮廓线数据,并生成和保存强度图和深度图。
-
AcquireProfileDataUsingCallback:使用回调函数获取轮廓线数据,并生成和保存强度图和深度图。
-
AcquirePointCloud:获取轮廓线数据,并生成和保存CSV和PLY格式的点云。
-
ManageUserSets:管理参数组,如获取所有参数组的名称、新增参数组、切换参数组和保存参数设置至参数组。
-
RegisterProfilerEvent:定义并注册检测相机连接状态的回调函数。
-
UseVirtualDevice:获取虚拟设备中储存的轮廓线数据,并生成和保存强度图和深度图。
获取例程
C#例程包含在Mech-Eye SDK的安装路径中,也可从GitHub克隆获取克隆获取。安装路径中的例程为Mech-Eye SDK发布时的版本,GitHub上的例程可能包含最新修改。
-
安装路径中的例程位于xxx/Mech-Eye SDK-2.3.0/API/samples/csharp/profiler路径下;
-
通过GitHub克隆获取的例程位于xxx/mecheye_csharp_samples/profiler路径下。
安装必需软件
使用Mech-Eye API的C#例程,必须安装Mech-Eye SDK及Visual Studio。
安装最新版本的Mech-Eye SDK
请根据Mech-Eye SDK安装指南安装或升级Mech-Eye SDK。
安装Visual Studio(2019或以上版本)
-
安装时,勾选以下工作负荷和单个组件,再点击安装。
-
桌面应用和移动应用分类的工作负荷:
-
.NET桌面开发
-
使用C++的桌面开发
-
通用Windows平台开发
-
-
单个组件:.NET Framework 4.8目标包
-
C#的Mech-Eye API基于.NET Framework 4.8。如未安装.NET Framework 4.8,将无法构建例程。 |
安装Emgu CV
部分例程中的功能依赖OpenCV软件库。如需使用下方列出的例程,则必须通过Visiual Studio的NuGet管理器安装Emgu CV(即OpenCV的.NET封装)。
具体安装方式请参考 Microsoft提供的指南。
-
AcquireProfileData
-
AcquireProfileDataUsingCallback
-
UseVirtualDevice
构建及运行例程
在Visual Studio中构建例程后,可选择合适的方式运行例程。
使用Visual Studio构建例程
-
双击profiler文件夹中的MechEyeCSharpSamples.sln。
-
在Visual Studio工具栏中,将解决方案配置从Debug改为Release模式。
-
在菜单栏中选择
。每个例程会生成对应的可执行文件(.exe),保存在Build文件夹中,该文件夹位于profiler文件夹中。