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

news2024/12/24 3:22:04

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’函数可以将文本绘制到指定的图像或图像区域中，并根据给定的参数设置字体、颜色等属性。它通常用于在创建新的图像时添加标注或注释。