Halcon——C#中在HWindow上显示字符串遇见的问题及解决方案
前言一、HWindow上显示字符串的两种方式1. DispText函数2. WriteString函数
二、DispText函数与WriteString函数的区别三、遇见的问题及解决方案“HALCON error #5123: Wrong window type in operator disp_text”“HALCON error #5137: Wrong font name in operator set_font”
前言
在视觉项目中通常会用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-”。
注意字符串两侧有字符‘-’
相关文章
您阅读本篇文章共花了：
发表评论