Halcon——C#中在HWindow上显示字符串遇见的问题及解决方案

---

前言

在视觉项目中通常会用HWindiw显示图像处理过后的内容，并推送一些数据信息。在实际实现的过程中，遇到了一些小问题。网上的答案也并不是很详细全面，在此做自己的总结。

---

一、HWindow上显示字符串的两种方式

1. DispText函数

c#代码形式：HalconWindow是HWindow类型。

	public void DispText(HTuple stringVal, string coordSystem, HTuple row, HTuple column, HTuple color, HTuple genParamName, HTuple genParamValue);
	//参数意义
	//stringVal:想显示的文本
	//coordSystem：显示的容器（显示在HWindow的话就是‘window’）
	//row：显示框的左上角行号
	//column：显示框的左上角列号
	//color：显示的颜色
	//genParamName:一个字符串数组，包含要设置的其他参数的名称。可以为空数组
	//genParamValue:一个与GenParamName对应的值数组，包含要设置的参数的值。可以为空数组

	//代码案例
	this.HalconWindow.DispText(item.Message, "window", item.Y, item.X, item.Color, new HTuple(), new HTuple());

ps：genParamName中可以参数详情

• ‘font’: 设置字体的名称。例如，‘font’ => ‘Arial’。
• ‘size’: 设置字体的大小。例如，‘size’ => 20。
• ‘orientation’: 设置文本的方向。可以是’right’（从右到左）或’left’（从左到右）。默认为’right’。
• ‘underline’: 设置文本是否带有下划线。可以是’true’（带有下划线）或’false’（不带下划线）。默认为’false’。
• ‘strikeout’: 设置文本是否带有删除线。可以是’true’（带有删除线）或’false’（不带删除线）。默认为’false’。
• ‘color’: 设置文本的颜色。可以是预定义的颜色名称（如’red’、‘green’、'blue’等）或RGB颜色值。例如，‘color’ => ‘red’或’color’ => [255, 0, 0]。
• ‘halignment’: 设置文本的水平对齐方式。可以是’left’（左对齐）、‘center’（居中对齐）或’right’（右对齐）。默认为’left’。
• ‘valignment’: 设置文本的垂直对齐方式。可以是’top’（顶部对齐）、‘center’（居中对齐）或’bottom’（底部对齐）。默认为’top’。
• ‘spacing’: 设置文本行之间的间距。可以是固定的像素值或相对于字体大小的百分比。例如，‘spacing’ => ‘2’或’spacing’ => ‘20%’。
• ‘outline’: 设置文本是否有轮廓。可以是’true’（有轮廓）或’false’（没有轮廓）。默认为’false’。
• ‘outline_color’: 设置文本轮廓的颜色。可以是预定义的颜色名称或RGB颜色值。例如，‘outline_color’ => ‘blue’或’outline_color’ => [0, 0, 255]。

2. WriteString函数

c#代码形式：

	public static void WriteString(HTuple windowHandle, HTuple stringVal);
	//参数意义
	//windowHandle:显示窗体的句柄，可为Hwindow对象
	//stringVal：想显示的文本

	//代码案例
	HOperatorSet.WriteString(this.HalconWindow, item.Message);

二、DispText函数与WriteString函数的区别

• ‘DispText’函数可以在图像窗口中显示文本，并根据给定的参数设置字体、颜色、对齐方式等属性。它可以根据输入的文本长度自动换行，并可以在指定的位置绘制文本。
• ‘WriteString’函数可以将文本绘制到指定的图像或图像区域中，并根据给定的参数设置字体、颜色等属性。它通常用于在创建新的图像时添加标注或注释。

三、遇见的问题及解决方案

“HALCON error #5123: Wrong window type in operator disp_text”

当程序文件夹下，只存放了halcon.dll和halcondotnet.dll时，调用DispText函数时会出现如下报错。

此时，将Halcon软件目录下的hcanvas.dll放到自己软件目录下，则可以正常运行。

“HALCON error #5137: Wrong font name in operator set_font”

按上述操作后，通过SetFont改变公用的字体时，会出现新的问题：

通过排查发现：

1.当导入hcanvas.dll后，SetFont的字体设置形式应该为：“Arial-Normal-20”。

注意字符串两侧没有字符‘-’

2.当没导入hcanvas.dll时，SetFont的字体设置形式应该为：“-System---0-0-0-1-GB2312_CHARSET-”。

注意字符串两侧有字符‘-’