2.3.1 渲染控件：渲染控件上自定义图形的方法
2.3.2 参数控件：参数配置控件绑定模块的方法
2.3.3 控件颜色：控件颜色修改方法
2.3.4 独立控件：二次开发单独显示Group的方法
2.3.5 取流控件：实时取流控件的使用方法
2.3.6 渲染控件：渲染控件绘制ROI的方法
2.3.7 控件语言：控件设置为英文的方法
2.3.8 控件报错：子窗口包含主界面控件及其它控件时报错的解决方法
2.3.9 图像传入：给渲染控件传入图像的方法
2.3.10 主界面控件：主界面控件添加参数修改记录并将记录保存至本地的方法
2.3.11 渲染控件：渲染控件绘制十字方法

2.3.1 渲染控件：渲染控件上自定义图形的方法

描述
环境：VM4.2 + VS2013及以上
现象：VM4.2如何在渲染控件上自定义图形？
解答
VM4.2二次开发相比较VM4.0二次开发，渲染控件上自定义图形有一些更新，除了接口vmRenderControl.DrawShape()，新增加一个接口vmRenderControl.AddShape(),前者是立刻绘制，后者是在下次刷新渲染时自动绘制。所以在VM4.0二次开发回调函数中图像渲染并添加自定义图形时， DrawShape接口函数前需要添加延时，不然回调中的图像渲染还没更新，自定义的图形已经调用DrawShape函数，从而导致自定义图形不能很好的渲染在图像上。在VM4.2二次开发中使用AddShape接口就不要加延时，它会在图像渲染结束后再绘制自定义图形。
手动添加引用VMControls.WPF.dll、WindowsBase.dll，添加后，引用属性【复制本地】改为false；渲染控件需要先绑定图像，再调用渲染控件的AddShape绘图接口；支持直线、圆形、矩形、文本等图形元素绘制；绘制时机：流程运行结束，在流程结果回调函数中绘制。下面绘制了直线和文本，其它图形依次类推。

C#
//绘制直线
VMControls.WPF.LineEx line = new VMControls.WPF.LineEx(new System.Windows.Point(100, 100), new System.Windows.Point(600, 600), stroke: "#FF0000", strokeThickness: 10);
vmRenderControl1.AddShape(line);
//绘制文本
VMControls.WPF.TextEx text = new VMControls.WPF.TextEx("欢迎使用VM4.2二次开发！", new System.Windows.Point(1000, 1000), fontSize: 20, stroke: "#FF0000");
vmRenderControl1.AddShape(text);

问题根因
不熟悉如何绘制自定义图形。

2.3.2 参数控件：参数配置控件绑定模块的方法

描述
环境：VM4.2 + VS2013及以上
现象：如何给参数配置控件绑定指定模块？
解答

参数配置控件绑定模块方法（C#），示例代码如下。

C#

// 参数配置控件模块绑定
private void button3_Click(object sender, EventArgs e)
{
    try
    {
        //参数配置
        var blobTool = (VMControls.Interface.IVmModule)VmSolution.Instance["流程1.BLOB分析1"];
        //参数配置控件
        vmParamsConfigControl1.ModuleSource=blobTool;
        //参数配置控件带渲染
        vmParamsConfigWithRenderControl1.ModuleSource = blobTool;
    }
    catch (VmException ex)
    {
        MessageBox.Show(Convert.ToString(ex.errorCode, 16));
    }
}

2.参数配置控件绑定模块方法（C++），代码如下。

C++
//参数设置
void CMFCApplication5Dlg::OnBnClickedButton4()
{
	// TODO: 在此添加控件通知处理程序代码
	try
	{
		auto pObject = (CModuParamsBase*)(*m_pVmSol)[“流程1.圆查找1”];
		m_ParamsRender.SetParamsInfo(pObject, "");
	}
	catch (CVmException ex)
	{
		CString strTemp;
		strTemp.Format(_T("%d"), ex.GetErrorCode());
	}
}

3.绑定效果
在这里插入图片描述

问题根因
不熟悉控件的资源绑定方法。

2.3.3 控件颜色：控件颜色修改方法

描述
环境：VM4.2 + VS2013及以上
现象：如何修改控件颜色？
解答

修改控件背景色，示例代码（C#）如下。注意：渲染控件颜色修改的前提是渲染控件已经绘制到窗口中。
当通过拖拉渲染控件到窗口中时，控件颜色修改只能写在窗口初始化之后，如Load事件中或按钮事件中；
当通过动态定义渲染控件到窗口中时，控件颜色修改只能写在窗口Add渲染控件之后，如this.Controls.Add(vmRenderControl1)之后。

C#
private void button16_Click(object sender, EventArgs e)
{
    string str = "#DD22AA";//十六进制颜色码
    vmRenderControl1.SetBackground(str);
}

2.修改控件背景色，示例代码（C++）如下。

C++
//修改控件背景色
int CMFCApplication5Dlg::SetBackGroundColor()
{
	// TODO: 在此处添加实现代码.
	CString str("#DD22AA");//十六进制颜色码
	m_RenderCtr.SetBackground(str.GetBuffer());
	return 0;
}

3.修改效果
在这里插入图片描述

问题根因
不熟悉控件接口。

2.3.4 独立控件：二次开发单独显示Group的方法

描述
环境：VM4.2 + VS2013及以上
现象：如何单独显示Group（.gro后缀）文件？
解答

首先需要在界面上拖拽SingleModuleSetConfigControl控件，该控件专门用于显示Group。
2.加载Group文件并绑定到该控件的ModuleSource属性，代码如下。

C#
private void button16_Click(object sender, EventArgs e)
{
    vmSingleModuleSetConfigControl1.ModuleSource = VmSolution.LoadIndependentGroup("D://Files//test.gro");
}

3.显示效果
在这里插入图片描述

问题根因
不熟悉控件的资源绑定方法。

2.3.5 取流控件：实时取流控件的使用方法

描述
环境：VM4.2 + VS2013及以上
现象：VM4.2新增了一个控件，实时取流控件。
解答
1.在工具箱添加控件后，就可以拖拽实时取流控件VmRealTimeAcqControl到窗体中进行使用。
2.拖拉控件后，还需要将全局相机与控件进行绑定，代码如下所示：

C#
GlobalCameraModuleCs.GlobalCameraModuleTool cameraModu=(GlobalCameraModuleCs.GlobalCameraModuleTool)VmSolution.Instance["全局相机1"];
vmRealTimeAcqControl1.ModuleSource = cameraModu;
vmRealTimeAcqControl1.StartGrabbing();//开始采集
vmRealTimeAcqControl1.Stop Grabbing();//停止采集

问题根因
不熟悉实时取流控件的使用。

2.3.6 渲染控件：渲染控件绘制ROI的方法

描述
环境：VM4.2.0 + VS2013及以上
现象：VM二次开发，如何在渲染控件上绘制ROI，以实现界面快速建模、调整模块ROI？
解答
安装20220914及后续补丁包，注册GAC后，在二次开发软件中注册ROI绘制事件。示例代码如下：

C#
using VMControls.RenderInterface;
using VMControls.Interface;
using VMControls.Winform.Release;

// 注册ROI绘制事件
vmRenderControl1.IsShowCustomROIMenu = true;
vmRenderControl1.OnCustomRoiAddEvent -= VmRenderControl1_OnCustomRoiAddEvent;
vmRenderControl1.OnCustomRoiAddEvent += VmRenderControl1_OnCustomRoiAddEvent;

// ROI绘制事件
private void VmRenderControl1_OnCustomRoiAddEvent(object sender, VMControls.RenderInterface.RoiEventArgs e)
{
	roi = e.Roi;
	roi.DataChangedCommand = new DelegateCommand<IROI>(OnDataChangedCommandExcute);
    if (roi is IRectROI rect)  // 绘制的ROI为矩形
	{
	// Avoid表示ROI类型为屏蔽区
	if (!(rect.UseType == ROIUseType.Avoid)) { // To Do Code }
	// To Do Code 例如设置模块ROI、例如模板匹配建模等
	}
}

// ROI修改事件
private void OnDataChangedCommandExcute(IROI obj)
{
	if (roi is IRectROI rect)  // 绘制的ROI为矩形
	{ 
	if (!(rect.UseType == ROIUseType.Avoid)) //屏蔽区
	{ // To Do Code }
	// To Do Code 例如设置模块ROI、例如模板匹配建模等
	}
}

问题根因
不熟悉渲染控件的相关事件。

2.3.7 控件语言：控件设置为英文的方法

描述
环境：VM4.2+VS2013及以上
现象：如何设置控件为英文？
解答
在VM4.0的二次开发中，控件设置为英文的相关配置文件在debug路径中LangCFG文件中，修改配置文件LanguageSet.cfg。在VM4.2的二次开发中，因为debug中没有进行拷贝操作，所以修改配置文件路径如下图所示，zh-cn表示中文，英文则用en-us。
在这里插入图片描述

上图中是手动打开配置文件直接进行修改，也可以通过代码来修改配置文件：

C#
///修改对应cfg文件内容，切换中文
string path2 =Path+ "Development\\V4.x\\ComControls\\Assembly\\LangCFG\\LanguageSet.cfg";
string[] filelines = File.ReadAllLines(path2);
filelines[2] = "  <LangSet>zh-cn</LangSet>";
File.WriteAllLines(path2, filelines);

///修改对应文件内容，切换英文
string path2 =Path+ "Development\\V4.x\\ComControls\\Assembly\\LangCFG\\LanguageSet.cfg";
string[] filelines = File.ReadAllLines(path2);
filelines[2] = "  <LangSet>en-us</LangSet>";
File.WriteAllLines(path2, filelines);

注意：切换后VM二次开发需要重新启动才会生效
问题根因
不熟悉如何修改VM4.2二次开发控件的语言

2.3.8 控件报错：子窗口包含主界面控件及其它控件时报错的解决方法

描述
环境：VM4.0及以上 + VS2013及以上
现象：子窗口包含主界面控件（VmMainViewConfigControl）及其它控件时，打开子窗口报错如下所示。
在这里插入图片描述

解答
将子窗口中的VM控件的属性【TopStop】都改为false即可。
在这里插入图片描述

问题根因
主界面控件机制问题，VM4.3将会改善。

2.3.9 图像传入：给渲染控件传入图像的方法

描述
环境：VM4.0及以上 + VS2013及以上
现象：VM二次开发如何将在渲染控件上显示本地图像？
解答
1．可以通过模块的方式，再将渲染控件绑定模块或流程来显示本地图像，也可以通过VmRnderControl控件的ImageSource属性来设置图像。
2.首先需要继承IImaageData接口实现图像数据类。示例代码如下：

C#
public class ImageSource : VMControls.RenderInterface.IImageData
{
    public ImageSource(int width, int height, byte[] buffer, VMPixelFormat pixelformat)
    {
        Width = width;
        Height = height;
        PixelFormat = pixelformat == VMPixelFormat.VM_PIXEL_MONO_08 ? "Gray8" : "Rgb24";
        int channels = pixelformat == VMPixelFormat.VM_PIXEL_MONO_08 ? 1 : 3;
        if (buffer.Length != width * height * channels)
            throw new Exception("buffer is error");
        Buffer = new byte[buffer.Length];
        Array.Copy(buffer, Buffer, buffer.Length);
    }

    public int Width { get; set; }

    public int Height { get; set; }

    public byte[] Buffer { get; set; }

    public string MemoryAddress
    {
        get
        {
            GCHandle gCHandle = GCHandle.Alloc(Buffer, GCHandleType.WeakTrackResurrection);
            IntPtr bufferAddress = GCHandle.ToIntPtr(gCHandle);
            return bufferAddress.ToString();
        }
    }

    public string PixelFormat { get; }
}

3.使用OpenCV等接口获取本地图像数据流并转换成ImageSource类型显示，示例代码如下：

C#
private void button1_Click(object sender, EventArgs e)
{
    OpenFileDialog openFile = new OpenFileDialog();
    if (openFile.ShowDialog() == DialogResult.OK)
    {
        pictureBox1.Image = Image.FromFile(openFile.FileName);
        var mat = Cv2.ImRead(openFile.FileName);
        byte[] imageByte = new byte[mat.Width * mat.Height * mat.Channels()];
        ImageSource imageSource = null;
        if (mat.Channels() == 1)
        {
            imageSource = new ImageSource(mat.Width, mat.Height, imageByte, VMPixelFormat.VM_PIXEL_MONO_08);
        }
        else
        {
            //OpenCV为BGR VM 为RGB通道
            Cv2.CvtColor(mat,mat,ColorConversionCodes.BGR2RGB);
            Marshal.Copy(mat.Data, imageByte, 0, imageByte.Length);
            imageSource = new ImageSource(mat.Width, mat.Height, imageByte, VMPixelFormat.VM_PIXEL_RGB24_C3);
        }
        if(imageSource!=null)
        vmRenderControl1.ImageSource = imageSource;
   }
}

注意事项：灰度图读取到的如果是三通道需先转成单通道图像，彩色图需要交换下R和G通道，即用Cv2.CvtColor转换一下。
问题根因
不熟ImageSource属性及接口。

2.3.10 主界面控件：主界面控件添加参数修改记录并将记录保存至本地的方法

描述
环境：VM4.2 + VS2013及以上
现象：在VisionMaster软件里，修改模块参数值时，右下角的状态栏会显示修改记录并且记录至本地日志，而在VM二次开发里不会显示修改和记录日志。
在这里插入图片描述

解答
当前VM二次开发默认不支持，要支持需手动添加代码Apps.XmlParser.ParamTab.NameValueItem.logManager = new Apps.XmlUI.UILogManager(false);加载到程序初始化函数里。其中，添加引用集Apps.XmlParser.dll和Apps.XmlUI.dll在VM安装路径“VisionMaster4.2.0\Development\V4.x\ComControls\Assembly”下。
示例代码如下：

C# 
public Form1()
{
InitializeComponent();
Apps.XmlParser.ParamTab.NameValueItem.logManager = new Apps.XmlUI.UILogManager(false);
}

添加后，控件日志显示如下：
在这里插入图片描述

并且，在二次开发应用程序exe同级下的log/UI/SystemLog.log就会记录模块参数修改的日志。
注：若没有该log，请将VisionMaster路径“VisionMaster4.2.0\Development\V4.x
\ComControls\Assembly”下的第一个文件夹“3rdLib”拷贝替换至二次开发应用程序exe同级路径下。
问题根因
某些功能接口不对外开放，需手动添加。

2.3.11 渲染控件：渲染控件绘制十字方法

描述
环境：VM4.2 + VS2013及以上
现象：如何在vmRenderControl控件上显示十字线？
解答

使用控件AddShape()接口显示十字线(渲染控件渲染时机为流程执行结束回调，适合静态显示)，示例代码如下；

C#

/// <summary>
/// 流程工作状态回调
/// </summary>
/// <param name="workStatusInfo"></param>
private void VmSolution_OnWorkStatusEvent(VM.PlatformSDKCS.ImvsSdkDefine.IMVS_MODULE_WORK_STAUS workStatusInfo)
{
    if (workStatusInfo.nWorkStatus == 0 && workStatusInfo.nProcessID == 10000)//流程空闲且为流程1
    {
        if (vmRenderControl1.ImageSource != null)
        {
            var width = vmRenderControl1.ImageSource.Width;
            var height = vmRenderControl1.ImageSource.Height;
            var lineY = new LineEx(new System.Windows.Point(width / 2, 0), new System.Windows.Point(width / 2, height), stroke: "#4400FF");
            var lineX = new LineEx(new System.Windows.Point(0, height / 2), new System.Windows.Point(width, height / 2), stroke: "#4400FF");
            renderControl.vmRenderControl1.AddShape(lineX);
            renderControl.vmRenderControl1.AddShape(lineY);
        }
    }
}