C#

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

例程简介

目前提供了如下例程：

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

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

  • AcquireRawImage：获取并保存原始图像。

  • AcquirePointCloud：获取轮廓线数据，并生成和保存.csv格式的点云。

  • ManageUserSets：执行参数组相关功能，如获取可用参数组名称，选择参数组，保存参数值至当前参数组等。通过参数组可以保存一组参数值并快速应用。

使用前提

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

  • 正确连接轮廓测量仪和电脑。

  • 获取例程。

  • 安装必需软件。

  • （可选）安装例程依赖的软件库。

获取例程

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

  • 安装路径中的例程位于xxx/Mech-Eye SDK-x.x.x/API/samples/csharp/source路径下；

  • 通过GitHub克隆获取的例程位于xxx/mecheye_csharp_samples/source路径下。

安装必需软件

使用Mech-Eye API的C#例程，必须安装Mech-Eye SDK及Visual Studio。

安装最新版本的Mech-Eye SDK

你可以从梅卡曼德在线社区下载Mech-Eye SDK安装文件。

双击exe格式的安装文件即可安装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，将无法构建例程。

（可选）安装依赖的软件库

部分例程中的功能依赖OpenCV软件库。如需使用下方列出的例程，则必须通过Visiual Studio的NuGet管理器安装EmguCV（即OpenCV的.NET封装）。

具体安装方式请参考 Microsoft提供的指南。

  • AcquireProfileData

  • AcquireProfileDataUsingCallback

  • AcquireRawImage

构建及运行例程

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

使用Visual Studio构建例程

  1. 双击source文件夹中的MechEyeCSharpSamples.sln。

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

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

运行例程

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

在Visual Studio中运行例程

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

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

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

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

运行例程可执行文件

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

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

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

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