C#联合VisionMaste4.2二次开发

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

前言

作为机器时间通用型算法开发平台，VM可以帮助用户快速搭建时间应用方案用户也可以基于VM SDK进行二次开发，
将已经搭建好的VM方案融入到生产软件中去，本章讲解的是VM4.2版本演示基于VM SDK二次开发值钱所需的环境配置步骤，
方案加载、执行及保存，渲染及数据结果获取和模块参数配置的相关操作演示。

一、环境配置

#将一个编辑好的VM流程导入Visual Studio 中

我用的是Visual Studio 2019（建议用户使用VS2013及以上的版本进行开发）

打开VS，第一步新建项目，点击菜单中的文件，选择新建，点击项目，
以C#语言为例，选择Windows窗体应用程序，可以修改项目名称及项目路径，框架选择。NET Framework 4.6.1，
因为VM是基于此框架进行开发的，点击确定创建项目

右键点击项目名称，打开项目属性界面，选择生成窗口，
在平台目标去掉首选32位勾选，最后点击保存使相关设置生效。

第二步添加程序引用，打开VM4.2安装路径，进入如下图路径下的文件夹，VM4.2提供了ImporRef工具用于快速添加引用

浏览打开刚刚创建的项目路径 ，开发者可以自由选择所需添加的模块相关引用，
这里点击全部勾选，导入模式可以选择覆盖或跳过同名DLL，点击确定后等待进度条加载完成后点击退出。

在VM项目中选择全部重新加载
此时打开引用可以看到通过工具成功导入相关引用

点击左面的工具箱，
右键选择项，
浏览海康程序VisionMaster4.2.0\Development\V4.x\ComControls\Assembly文件夹内选择【VMControls.Winform.Release.dll】
这样就可以在工具箱中搜索VM，在窗口中可以看到相关控件，
可以根据自己的需求，将这些控件拖入窗口中进行使用。

将控件拖入主窗口后，会自动在引用中添加控件所依赖的dll，以上是基于VM4.2进行二次开发之前所需的环境配置步骤。

二、方案加载、执行及保存

以此方案为例，进行二次开发

我们以及完成了环境配置添加VM必要的引用和控件，接下来将会对VM二次开发中方案的相关操作进行演示，
首先进行界面的搭建，主界面设置为三个区域，内部的控件均从工具箱中拖拽出来，
分别设置流程显示区，方案操作区和消息显示区

其中方案操作将实现方案的加载，执行及保存，为了在方案加载之后将方案显示在界面上，
我们需要使用VmProcedureConfigControl控件，将其从工具箱拖至主界面，
然后在控件属性中将Dock值设置为Fill，使控件充满流程显示区，
接下来编辑按钮事件，双击选择路径按钮进入该事件代码

选择路径按钮的功能为打开一个文件夹，并选择后缀为.sol的文件
VM方案的后缀均为.sol，然后将方案的路径赋值给textBox1文本框

方案加载需要调用方案的相关接口，首先需要添加两个引用
第一个引用VM.Core命名空间
第二个为引用VM.PlatformSDKCS命名空间
这样就能使用二次开发中方案对应的接口

方案加载需要使用VmSolution.Load函数，函数中的参数为方案的路径，直接使用文本框textBox1的文本内容，
方案加载完成之后，需要执行方案，使用方案接口中的SyncRun函数，
同步执行一次方案，使用此函数执行方案，会同步执行一次方案中的所有流程，
接下来设置保存事件，直接使用方案接口中的Save函数即可进行保存，以下是方案接口中的部分函数

运行程序查看效果【切记在启动程序之前要关闭VM软件及后台服务】

三、渲染及数据结果获取

下面介绍在方案执行之后，如何进行结果的获取

流程的结果分为渲染及数据结果，在进行结果获取之前需要在VM中先对流程进行配置，比如获取流程1的结果，需要对流程1进行结果配置，在显示设置中配置渲染结果

在多选框中配置所需显示的类型，参数名称可以自行设置，关联关系里面绑定对应类型的模块，以此方案为例，矩形框绑定字符识别的检测区域，文本绑定格式化显示文本，数据结果在输出设置下配置，同样是在多选框中配置结果类型

参数名称可以修改，订阅关系绑定对应类型的模块，将out绑定格式化1的结果，out0绑定字符识别1的字符个数，流程1编号为10000，配置好流程输出后点击确定保存，然后关闭VM软件。
进入二次开发程序进行设置，在二次开发程序中，如需显示渲染结果，需要使用到vmRenderControl，从工具箱中拖出控件到图像显示区

然后需要在方案执行事件中进行代码编辑，获取的结果分为渲染结果和数据结果，渲染结果显示在界面上，数据结果获取后我们可进行输出或其他处理，下面我们将数据结果显示在消息区代码编写如下（首先定义并初始化一个流程对象，将其与先前VM中配置好输出的流程1进行绑定，然后将渲染控件的显示源ModuleSource绑定流程1对象，这是渲染结果的设置）（之前在VM中配置了一个string类型，参数名称为out的输出，通过此代码即可获取到格式化中订阅的字符识别结果strValue，并将其赋值给ocrResult变量下一行代码为获取到int类型的out0结果，表示字符识别的字符个数，转化为string类型赋值给ocrNum变量，最后再将这些结果显示在消息区listBox1中）

运行程序（渲染图片显示在图像显示区，消息显示区会显示数据结果）

以上方案就是获取流程渲染与数据结果的操作

四、模块参数配置的相关操作演示

二次开发中对模块参数进行配置，工具箱中提供了两个参数配置控件：
VmParamsConfigControl是不带渲染的参数配置控件
VmParamsConfigWithRenderControl是带渲染的参数配置控件

首先介绍带渲染的参数配置控件，将此控件拖出到参数配置区

进入程序代码界面（第一行代码为实例化一个模块，成功实例化字符识别模块并与流程1中的字符识别1进行绑定，然后将带渲染界面的参数配置控件的ModuleSource属性与ocrTool字符识别工具对象进行绑定）

启动程序查看效果（区域中显示出了字符识别模块的参数配置界面）

在运行参数中更改算法参数，点击执行，可以在渲染界面实时查看效果

以上为模块参数配置的相关操作。

总结

整体代码如下：
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using VM.Core;
using VM.PlatformSDKCS;

namespace WindowsFormsApp0
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}

    private void Form1_Load(object sender, EventArgs e)
    {

    }

    private void button1_Click(object sender, EventArgs e)
    {
        //打开本地路径并识别.sol后缀文件
        OpenFileDialog openFileDialog = new OpenFileDialog();
        openFileDialog.Filter = "VM Sol File|*.sol*";
        DialogResult openFileRes = openFileDialog.ShowDialog();
        if (DialogResult.OK == openFileRes)
        {
            textBox1.Text = openFileDialog.FileName;
            //在Textbox中显示路径信息
        }
        listBox1.Items.Add("选择路径成功");
        listBox1.TopIndex = listBox1.Items.Count - 1;
    }

    private void button2_Click(object sender, EventArgs e)        {

        //将原固定路径加载方案替换为用户自定义路径的方式
        VmSolution.Load(textBox1.Text);
        listBox1.Items.Add("方案加载成功");
        listBox1.TopIndex = listBox1.Items.Count - 1;
    }

    private void button3_Click(object sender, EventArgs e)
    {
        //模块参数配置
        IMVSOcrModuCs.IMVSOcrModuTool ocrTool = (IMVSOcrModuCs.IMVSOcrModuTool)VmSolution.Instance["流程1.字符识别1"];
        vmParamsConfigWithRenderControl1.ModuleSource = ocrTool;




        VmSolution.Instance.SyncRun();
        listBox1.Items.Add("方案执行一次成功");
        listBox1.TopIndex = listBox1.Items.Count - 1;



        VmProcedure vmProcess1 = (VmProcedure)VmSolution.Instance["流程1"];
        vmRenderControl1.ModuleSource = vmProcess1;
        string ocrResult = vmProcess1.ModuResult.GetOutputString("out").astStringVal[0].strValue;
        string ocrNum = vmProcess1.ModuResult.GetOutputInt("out0").pIntVal[0].ToString();
        listBox1.Items.Add("字符识别结果" + ocrResult);
        listBox1.TopIndex = listBox1.Items.Count - 1;
        listBox1.Items.Add("个数" + ocrNum);
        listBox1.TopIndex = listBox1.Items.Count - 1;

    }

    private void button4_Click(object sender, EventArgs e)
    {
        VmSolution.Save();//Save函数是将方案保存到原始路径直接替换原方案
        //VmSolution.SaveAs();SaveAs是将方案另存至自定义的路径
        listBox1.Items.Add("方案保存成功");
        listBox1.TopIndex = listBox1.Items.Count - 1;
    }
}

}