格式化

格式化模块主要用于将数据整合并格式化成字符串输出。该模块支持三种数据来源,分别为自定义输入的数据、前序模块的模块结果、自定义的数组。通常在需要对模块数据进行整合的时候使用。例如进行通信输出前,会使用该模块整理数据。

使用方法

该模块可与较多模块配合使用,可以订阅前序模块输出的各类数据用于数据整合;也可将整合后的数据供后续模块订阅并使用。

下图展示使用快速匹配模块检测图像中的圆,并通过格式化模块将快速匹配模块检测后输出的模块状态、分数和匹配点的信息整合后输出的效果。

图 1 使用效果示意图

参数配置

此处仅对该模块的基本参数进行介绍,结果显示各模块大同小异,此处不再赘述,具体参见结果显示

该模块基本参数如下图所示。

图 2 基本参数

该模块基本参数各区域的说明参见下表。

表 1 格式化模块基本参数介绍

序号

名称

描述

1

添加数据

点击可在配置数据规则添加一条新的数据。

2

数据类型

每条数据均支持插入自定义文本、订阅前序模块的模块结果、自定义数组。

  • 插入文本:配置数据规则区域中选择某条数据,点击后可自定义添加需显示的文本内容。
  • 插入订阅:配置数据规则区域中选择某条数据,点击后选择需订阅的数据即可添加到数据中。

  • 插入数组:配置数据规则区域中选择某条数据,点击后在插入数组页签中完成相关参数(分隔符、数组下标、数组列表)设置即可添加到数据中。

    说明:

    数组输出成组数据。数组配置内包含多个数据时,按照多个数据的顺序组合输出。

    • 分隔符:可设置数组列表中每个数据之间的分隔符。

    • 数组下标:可设置输出多少个数组或第几个数组,可订阅int型数据或自定义输入。仅支持int型数据或*,该参数设置为*时,输出全部数组;该参数设置为int型数据时,仅输出对应的那组数组。假设该参数设置为0,则输出第一组数组数据,依次类推。

    • 数组列表:点击可添加需要组装为数组的数据内容,通过内容订阅模块结果或自定义输入即可。

    说明:

    假设数组列表由2个数据组成,分别为中心点X和中心点Y,订阅的模块共输出3个中心点,分隔符为;,数组下标为*,数组间分隔符为(),则输出的数组数据为(X1;Y1)(X2;Y2)(X3;Y3)。

3

配置数据规则

可预览并配置每条数据的规则。通过左侧的序号选中某条数据,右键单击可进行删除或清空内容操作。

  • 删除:删除整条数据。

  • 清空内容:将整条数据的内容清空,但数据保留。

4

调整排序

可调整数据规则区域的每条数据以及数据之间的顺序。

  • 选择某条数据时,可点击调整上下顺序。

  • 选择数据中的某一部分时,可点击调整前后顺序。

5

结束符&分隔符

可设置数据规则区域以及数组间的结束符或分隔符。

  • 输入结束符:可设置配置数据规则区域中每条数据之间的结束符,可选\r(回车)、\n(换行)、\r\n(回车换行)。

  • 分隔符:可设置配置数据规则区域中各个数据之间的分隔符。可下拉选择,也可自定义修改。

    说明:

    该参数仅在数据未设置输入结束符时有效。

  • 数组间分隔符:可设置每个数组时间的分隔符。可下拉选择,也可自定义修改。

6

删除

可删除配置数据规则区域中已设置的所有内容。

模块结果

该模块的模块结果涉及参数请参见格式化