在VisionPro中，常见的操作是：
将产品多种型号分别定义成多个QuickBuild。（PS: 产品A调用QuickBuild1，产品B调用QuickBuild2）
一个QuickBuild（JobManager）文件下可以包括若干个作业（Job），如果一个项目连接多个工业相机，那么可以将相机单独绑定到Job上。
Job中可以包含采像工具、ToolBlock、ToolGroup和各种算法工具。
结果输出，可以通过添加已发送项的方式，将单个Job执行结果输出。
这里主要实现模拟四个相机从分别读取OCR字符，然后将字符的个数打印到CogRecordDisplay的左上角。效果如下：
接下来，上代码：
实例化CogManager（作业管理器）、CogJob（作业）、CogJobIndependent（类似于TaskHelper的存在，欢迎纠错）对象。
1 private CogJobManager myJobManager;
2 private List<CogJob> myJobs = new List<CogJob>();
3 private List<CogJobIndependent> myIndependentJobs = new List<CogJobIndependent>();
初始化对象，并订阅结果可用事件（UserResultAvailable）
1 myJobManager = CogSerializer.LoadObjectFromFile(Application.StartupPath + @"\QuickBuild\QuickBuild1.vpp") as CogJobManager;
2 //将作业管理器中的作业遍历到作业集合中
3 for (int i = 0; i < myJobManager.JobCount; i++)
4 {
5 myJobs.Add(myJobManager.Job(i));
6 myIndependentJobs.Add(myJobs[i].OwnedIndependent);
7 }
8 myJobManager.UserQueueFlush(); //用户队列刷新
9 myJobManager.FailureQueueFlush(); //故障队列刷新
10 for (int i = 0; i < myJobManager.JobCount; i++)
11 {
12 myJobs[i].ImageQueueFlush();
13 myIndependentJobs[i].RealTimeQueueFlush();
14 }
15 this.Invoke(new Action(() =>
16 {
17 cogJobManagerEdit1.Subject = myJobManager; //将工程文件显示到JobManager控件中
18 }));
19
20 //订阅完成事件
21 myJobManager.Stopped += new CogJobManager.CogJobManagerStoppedEventHandler((sender, e) => { });
22 //订阅结果可用事件
23 myJobManager.UserResultAvailable += new CogJobManager.CogUserResultAvailableEventHandler(OnUserResultAvailable);
在OnUserResultAvailable事件的回调函数中，添加显示、获取结果代码
1 private void OnUserResultAvailable(object sender, CogJobManagerActionEventArgs e)
2 {
3 //由于CogManager对象是在异步线程中创建的，所以需要使用主线程的Invoke()方法调用
4 this.Invoke(new Action(() =>
5 {
6 ICogRecord record = myJobManager.UserResult();
7 ICogRecord tmpRecord;
8 switch (record.SubRecords["JobName"].Content.ToString())
9 {
10 case "Camera_1":
11 //获取当前Job的已发送项结果
12 tmpRecord = record.SubRecords["StringLength"];
13 lbl_ResultStrLength1.Text = tmpRecord.Content.ToString();
14
15 tmpRecord = record.SubRecords["ShowLastRunRecordForUserQueue"];
16 tmpRecord = tmpRecord.SubRecords["LastRun"];
17 tmpRecord = tmpRecord.SubRecords["Image Source.OutputImage"];
18 cogRecordDisplay4.InteractiveGraphics.Clear();
19 cogRecordDisplay4.Record = tmpRecord;
20 cogRecordDisplay4.Fit(true);
21 break;
22 case "Camera_2":
23 tmpRecord = record.SubRecords["StringLength"];
24 lbl_ResultStrLength2.Text = tmpRecord.Content.ToString();
25
26 tmpRecord = record.SubRecords["ShowLastRunRecordForUserQueue"];
27 tmpRecord = tmpRecord.SubRecords["LastRun"];
28 tmpRecord = tmpRecord.SubRecords["Image Source.OutputImage"]; cogRecordDisplay5.InteractiveGraphics.Clear();
29 cogRecordDisplay5.Record = tmpRecord;
30 cogRecordDisplay5.Fit(true);
31 break;
32 case "Camera_3":
33 tmpRecord = record.SubRecords["StringLength"];
34 lbl_ResultStrLength3.Text = tmpRecord.Content.ToString();
35
36 tmpRecord = record.SubRecords["ShowLastRunRecordForUserQueue"];
37 tmpRecord = tmpRecord.SubRecords["LastRun"];
38 tmpRecord = tmpRecord.SubRecords["Image Source.OutputImage"];
39 cogRecordDisplay7.InteractiveGraphics.Clear();
40 cogRecordDisplay7.Record = tmpRecord;
41 cogRecordDisplay7.Fit(true);
42 break;
43 case "Camera_4":
44 tmpRecord = record.SubRecords["StringLength"];
45 lbl_ResultStrLength4.Text = tmpRecord.Content.ToString();
46
47 tmpRecord = record.SubRecords["ShowLastRunRecordForUserQueue"];
48 tmpRecord = tmpRecord.SubRecords["LastRun"];
49 tmpRecord = tmpRecord.SubRecords["Image Source.OutputImage"];
50 cogRecordDisplay6.InteractiveGraphics.Clear();
51 cogRecordDisplay6.Record = tmpRecord;
52 cogRecordDisplay6.Fit(true);
53 break;
54 }
55 }));
56 }
执行CogManager作业管理器
1 private void btn_QuickBuildRun_Click(object sender, EventArgs e)
2 {
3 myJobManager.Run();
4 }
如何使用ToolGroup？
以上面的例子为例，可以在每个Job中都通过引入CogOCRMaxTool工具LineResult.Count引脚的方式获取字符总数。也可以通过在ToolGroup中添加脚本的方式获取。
在初始化函数 Initialize()中，添加输入输出引脚
1 public override void Initialize(CogToolGroup host)
2 {
3 // DO NOT REMOVE - Call the base class implementation first - DO NOT REMOVE
4 base.Initialize(host);
5
6 this.toolGroup.DefineScriptTerminal( input,"Input", true);
7 this.toolGroup.DefineScriptTerminal( output,"Output", false);
8 }
定义输入输出变量，在GroupRun()方法中获取输入值，并判断字符个数后输出
1 public string input = "";
2 public int output;
3 public override bool GroupRun(ref string message, ref CogToolResultConstants result)
4 {
5 string str = this.toolGroup.GetScriptTerminalData("Input").ToString();
6 output = str.Length;
7 this.toolGroup.SetScriptTerminalData("Output",output);
8
9 return false;
10 }
连接输入、输出 (可以传递给其他工具，也可以直接添加到已发送项) 引脚
关于ToolGroup和ToolBlock的使用和区别，后面会更新详细的文档。