C#

本章介绍如何在Windows系统中使用Visual Studio构建Mech-Eye API的C#例程。

例程简介

目前提供了如下例程:

  • AcquireProfileData:获取轮廓线数据,并生成和保存强度图和深度图。

  • AcquireProfileDataUsingCallback:使用回调函数获取轮廓线数据,并生成和保存强度图和深度图。

  • AcquirePointCloud:获取轮廓线数据,并生成和保存CSV和PLY格式的点云。

  • ManageUserSets:管理参数组,如获取所有参数组的名称、新增参数组、切换参数组和保存参数设置至参数组。

  • RegisterProfilerEvent:定义并注册检测相机连接状态的回调函数。

使用前提

使用Mech-Eye API的C#例程,需先满足以下使用前提:

获取例程

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

  • 安装路径中的例程位于xxx/Mech-Eye SDK-2.2.1/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或以上版本)

  1. 下载Visual Studio安装包

  2. 安装时,勾选以下工作负荷和单个组件,再点击安装

    • 桌面应用和移动应用分类的工作负荷:

      • .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

构建及运行例程

在Visual Studio中构建例程后,可选择合适的方式运行例程。

使用Visual Studio构建例程

  1. 双击profiler文件夹中的MechEyeCSharpSamples.sln

  2. 在Visual Studio工具栏中,将解决方案配置从Debug改为Release模式。

  3. 在菜单栏中选择生成  生成解决方案。每个例程会生成对应的可执行文件(.exe),保存在Build文件夹中,该文件夹位于profiler文件夹中。

运行例程

你可以在Visual Studio中直接运行例程,也可以双击运行例程的可执行文件。

在Visual Studio中运行例程

  1. 解决方案资源管理器窗口中右键单击想要运行的例程,并选择设为启动项目

  2. 单击工具栏中的本地Windows调试器即可在Visual Studio中运行例程。

    例程运行过程中,请根据提示输入待连接轮廓测量仪的编号(index),并按Enter键连接轮廓测量仪。

  3. 如例程保存了图像或点云,将在Build文件夹中得到保存的文件。

运行例程可执行文件

  1. 进入profiler文件夹中的Build文件夹。

  2. 运行与例程同名的可执行文件。

    例程运行过程中,请根据提示输入待连接轮廓测量仪的编号(index),并按Enter键连接轮廓测量仪。

  3. 如例程保存了图像或点云,将在Build文件夹中得到保存的文件。