海康Vision Master-脚本模块

VM是海康机器人自主研发的机器视觉软件，将一系列的图像算法、逻辑工具和通讯协议等封装成图形化模块，致力于帮助客户提供快速搭建视觉应用、解决视觉难题，能够满足视觉定位、尺寸测量、缺陷检测以及信息识别等机器视觉应用。
转自：机器视觉技术交流社区

• 1 引言
• 2 脚本模块
• • 2.1 接口介绍
  • 2.2 引用和调试
• 3 案例演示
• 4 总结

在VM的工具箱中，虽然已经包含了一百多个算法模块可供用户通过连线组合的方式来完成相应的视觉需求，但仍存在一些数据处理逻辑是工具箱中的模块所不涵盖的。此时，脚本模块就可以体现数据处理的灵活性。例如打印日志、二位坐标排序，多个试剂盒中有无试纸一次性输出结果，图像格式转换，联合OpenCV开发等等。
脚本模块主要是需要确定输入变量、输出变量以及数据处理逻辑。可导入或导出已经编写的脚本内容，脚本文本格式的后缀为cs；可编辑程序集来调用第三方库；可直接在脚本编辑页面编写代码、预编译和执行；也可导出当前脚本的工程，直接就会打开工程所在文件夹，再用VS打开工程、附加进程就可以进行脚本的调试，具体介绍见脚本模块章节。

双击打开脚本模块，界面如下所示，可以分为五个区域：变量输入区、变量输出区、菜单栏、C#编程区、提示区。

C#编程区的代码可分为三部分：命名空间、初始化函数、执行函数。Init()函数为初始化函数，Process()为执行函数。

使用脚本模块的目的，主要是为了处理数据，那么就需要获取脚本输入的数据以及通过设置数据将脚本某些结果进行输出，因此需要了解相应的获取和设置数据的接口函数。针对不同类型的数据有不同的接口函数，如：string、float、int、byte、image等数据类型的获取和设置接口大同小异。另外，还可以使用通信的发送数据接口，全局变量获取及设置接口，模块的结果获取和运行参数设置。

1. 数据类型接口

2. 其它接口

1. 添加引用
   在脚本界面点击【编辑程序集】进入程序集界面，点击【添加】根据需求进行程序集动态库的添加，仅支持C#程序集添加，到需要的第三方程序集路径下找到想要添加的.dll点击打开即可添加，添加完成后在脚本中调用即可。
   

2. 调试步骤
   在脚本界面点击【导出工程】，选择.sln文件使用VS打开，设置断点并且重新生成，然后点击【调试】中的【附加到进程】，选择VmModuleProxy.exe附加，最后在VM中单次执行方案或者单次执行流程或者脚本模块来查看是否能进入断点。小小提示：断点调试时，每次修改代码都需要重新编译，VS每次重新编译后，只有第一次运行会进入初始化函数Init()。
   

需求：获取下图中条码信息和二维码信息，然后通过编写脚本打印日志到本地。

根据案例需求，步骤如下:

1. 使用条码识别模块和二维码识别模块获取识别信息；
2. 用GetStringValue函数分别获取条码和二维码信息；
3. 通过FileStream类操作流写入信息到本地；
4. 并通过SetstringValue函数输出打印日志的状态信息给到下一个模块。

效果如下所示，确定输入输出变量，然后编写代码，执行之后将输出相应得结果。

完整代码如下所示：

using System;
using System.Text;
using System.Windows.Forms;
using System.IO;
using Script.Methods;
public partial class UserScript:ScriptMethods,IProcessMethods
{
   //********输入变量**********   
    string Barcode; 				//条码 
	string TwoD_Code;				//二维码	    
    //*******输出变量**********    
    string writeSucceedOrFailed; 	//日志写入状态；
    
    /// 

    /// 预编译时变量初始化
    /// 
    public void Init()
    {
		//变量初始化，其余变量可在该函数中添加      
    }

    /// 

    /// Enter the process function when running code once
	/// 流程执行一次进入Process函数
    /// 
    /// 
    public bool Process()
    {
        //每次执行将进入该函数，此处添加所需的逻辑流程处理           
        GetStringValue("barcode",ref Barcode);				//获取条码信息
        GetStringValue("twoD_Code", ref TwoD_Code);			//获取二维码信息        
        try
       {
       	   using(FileStream fsWrite = new FileStream(@"E:\Log.txt",FileMode.Append,FileAccess.Write) )
           {
       		  string str= "条码信息："+ Barcode + "rn" + "二维码信息：" + TwoD_Code;
       		  byte[] buffer=Encoding.Default.GetBytes(str+"rn");		
       		  fsWrite.Write(buffer,0,buffer.Length); 		
           }
           writeSucceedOrFailed="写入OKAY";    
       }
         catch
       {
			writeSucceedOrFailed="写入失败";
       }
       SetStringValue("stateOutput",writeSucceedOrFailed);	  //输出日志打印状态
        
        return true;
    }
}

作为VM中的逻辑模块之一，脚本模块能够灵活的按照需求处理数据，只要简单的模仿写过一遍，就能掌握其中规则，随后就能在实际项目中拓展使用。根据经验，有以下两点需要注意：

1. 无法进入到断点位置。建议调试过程中，导出工程后关闭脚本模块编辑界面，只使用vs修改代码和编译，然后附加进程。
2. 全局变量与局部变量的差异，在函数外定义的是全局变量，在process函数定义的是局部变量。