OCR 参数(循环写入)

<< 点击显示目录 >>

主页  mappVision帮助助手 > 机器视觉帮助 > mapp Vision  > 编程 > 视觉功能 > OCR  >

OCR 参数(循环写入)

信息:

本节指定的参数是硬件模块 I/O 映射的一部分,可通过 AS 软件访问。

参数

类型

数值范围

说明

循环

非循环

启用

BOOL

0 或 1

启用/禁用功能

W

 

最大搜索次数

USINT

0 至 255

要搜索的字符串的最大数量

W

 

超时

UINT

0 至 65535

以 1 ms 为增量的搜索时间限制

W

 

参数模式

USINT

0 至 1

选择预定义参数集

W

 

分级

BOOL

0 或 1

启用/禁用读取字符的质量分级。

W

 

偏移量

DINT

-2622400 至 2622400

ROI 在 x 方向上的偏移量,以 1/100 像素为增量。

W

 

偏移量

数字

-2622400 至 2622400

ROI 在 x 方向上的偏移量,以 1/100 像素为增量。

W

 

偏移方向

INT

-17999至18000

从 -179.99° 到 +180° 的 ROI 方向偏移,以 1/100 度为单位。

W

 

偏移 ROIRotCenterX

DINT

-2622400 至 2622400

旋转中心在 X 方向上的偏移量,以 1/100 像素为增量。

W

 

偏移ROIRotCenterY

DINT

-2622400 至 2622400

旋转中心在 Y 方向上的偏移量,以 1/100 像素为增量。

W

 

测试执行

BOOL

0 或 1

显示采集图像中的字符。

通过 mapp Vision HMI 应用程序进行操作。

W

 

启用

启用/禁用视觉功能。

数据类型

信息

BOOL

0

禁用图像处理(默认值)。

1

启用图像处理功能。

NumSearchMax

查找代码/字符集的最大数量参数。

该值不应大于实际可查找的代码/字符集数量,否则可能会不必要地延长图像处理例程的运行时间。

数据类型

信息

USINT

0 至 255

要搜索的代码/字符集的最大数量。

信息:

该值不必与配置变量 NumResultsMax 相同,因为它只是 POWERLINK 框架的占位符。

 

信息:

理论上也可以设置 "NumSearchMax = 0"(不单独检查),这将在执行视觉功能时触发搜索 0 个结果。

超时

使用该参数可限制搜索对象的时间。在时间结束前获得的所有结果都将可用。

计算时间时,请务必考虑图像采集所需的时间和其他处理时间。从触发时刻到提供结果的确切处理时间将作为FunctionProcessingTime 返回。

数据类型

信息

UINT

0 至 65535

搜索对象的时间限制,从 1 ms 到 6.55 s,增量为 1 ms。

0 = 禁用超时(默认值)

信息:

如果 SymbolsType = 0 (IdentifySymbolType),则搜索符号类型时不使用超时。

信息:

从 mapp Vision 5.19 开始,参数 Timeout 在设定时间过后不会在日志中生成状态条目。在 mapp Vision 5.18 之前(包括 5.18),每次都会在日志中创建一个条目。

参数模式

信息:

易失性参数:

更改该参数会导致内部参数更改,从而延长后续首次运行视觉功能时的处理时间。

摄像机上预装了最大字符识别率的配置参数集(非循环写入)。用户也可以定义一组参数。

对参数集的更改仅在图像采集后生效。

数据类型

信息

USINT

0

预定义参数集(默认值):

参数值为最大目标识别率配置(以牺牲识别速度为代价)。

1

手动设置参数(专家模式):

参数值由用户独立设置。

初始值为上次选择的参数组值。

信息:

使用 "手动设置参数 "选项需要专业知识。设置不正确的值可能会导致摄像机的全部功能无法使用。这只能通过重设为预定义的参数集来纠正。

手动设置参数 "的初始值始终是上次选择的参数集的值。这意味着一旦修改了 "手动参数集 "参数,只有在选择该模式时才有效。如果改为预先配置的参数集,然后再返回 "手动参数集",则之前对参数集 "手动参数集" 所做的任何更改都将失效。

如果要保存修改后的 "手动参数集 "参数或加载以前保存的配方,必须在选择 "手动参数集" 模式时进行。有关配方更改的其他信息,请参阅用例 使用参数模式 "用户定义 "处理配方。

分级

该参数根据识别质量对一行中的所有分段字符进行分级。质量分级的结果存储在参数GradingValue(n) 中。

该值根据教入字符输出一个质量值。该值提供了关于所选 OCR 分类器找到已教入字符的可能性的信息。

启用分级后,会对运行时间和内部内存消耗产生影响。

数据类型

信息

BOOL

0

禁用分段字符分级(默认值)

1

启用分级

偏移量 ROIX

图像区域内感兴趣区域 (ROI) 在 x 方向上的偏移量。

数据类型

信息

二进制

-2622400 至 2622400

ROI 在 x 方向上的偏移量,以 1/100 像素为增量。因此可以选择 -26224.00 至 26224.00 像素的位置。

偏移量

感兴趣区域 (ROI) 在图像区域内沿 Y 方向的偏移量。

数据类型

信息

二进制

-2622400 至 2622400

ROI 在 Y 方向上的偏移量,以 1/100 像素为增量。因此可以选择 -26224.00 至 26224.00 像素的位置。

方向偏移

感兴趣区域(ROI)的方向偏移。方向以 1/100 度的增量指定。

对于 -179.99° 至 +180.00° 的角度范围,可使用的数值范围为 -17999 至 18000。超出此值范围的值将被解释为 +180°。

数据类型

数值

信息

INT

-17999 至 18000

-179.99°至 180.00°,增量为 1/100 度。

偏移ROIRotCenterX

数据类型

信息

数字

-2622400 至 2622400

旋转中心在 x 方向上的偏移量,以 1/100 像素为增量。因此可以选择 -26224.00 至 26224.00 像素之间的位置。

偏移ROIRotCenterY

数据类型

信息

数据

-2622400 至 2622400

旋转中心在 Y 方向上的偏移量,增量为 1/100 像素。因此可以选择 -26224.00 至 26224.00 像素之间的位置。

测试执行

该参数用于执行字符搜索,并在 mapp Vision HMI 应用程序中显示找到的区域(找到字符的轮廓)。

数据类型

信息

BOOL

0

禁用 TestExecute(默认值)

1

执行 TestExecute

信息:

该参数在 I/O 映射中不可见。操作通过 mapp Vision HMI 应用程序进行。


Information:

The parameters specified in this section are part of the I/O mapping of the hardware module that can be accessed via Automation Studio.

Parameters

Type

Range of values

Description

Cyclic

Acyclic

Enable

BOOL

0 or 1

Enables/Disables the function

W

 

NumSearchMax

USINT

0 to 255

Maximum number of character strings to be searched for

W

 

Timeout

UINT

0 to 65535

Time limit for the search time in increments of 1 ms

W

 

ParameterMode

USINT

0 to 1

Selects predefined parameter sets

W

 

Grading

BOOL

0 or 1

Enables/Disables quality grading of the characters read.

W

 

OffsetROIX

DINT

-2622400 to 2622400

Offset of the ROI in the x-direction in 1/100 pixel increments.

W

 

OffsetROIY

DINT

-2622400 to 2622400

Offset of the ROI in the x-direction in 1/100 pixel increments.

W

 

OffsetROIOrientation

INT

-17999 to 18000

Offset to orient the ROI from -179.99° to +180° in 1/100 degree steps

W

 

OffsetROIRotCenterX

DINT

-2622400 to 2622400

Offset of the center of rotation in the x-direction in 1/100 pixel increments.

W

 

OffsetROIRotCenterY

DINT

-2622400 to 2622400

Offset of the rotation center in the y-direction in increments of 1/100 pixel.

W

 

TestExecute

BOOL

0 or 1

Displays characters found in the acquired image.

Operation takes place via the mapp Vision HMI application.

W

 

Enable

Enables/Disables the vision function.

Data type

Values

Information

BOOL

0

Image processing disabled (default value).

1

Image processing function enabled.

NumSearchMax

Parameter for the maximum number of codes / character sets to be found.

The value should not be greater than the actual locatable number of codes / character sets; otherwise, the runtime of the image processing routine could be unnecessarily extended.

Data type

Values

Information

USINT

0 to 255

Maximum number of codes / character sets to search for.

Information:

This value does not have to be identical to configuration variable NumResultsMax since it only serves as a placeholder for the POWERLINK frame.

 

Information:

Theoretically, "NumSearchMax = 0" can also be set (it is not checked separately), which triggers a search for 0 results when the vision function is executed.

Timeout

The search for objects is limited in time using this parameter. All results obtained up to the end of the time are then available.

When calculating times, be sure to account for the time required for image acquisition and other processing times. The exact processing time from the trigger moment to the provision of the result is returned as FunctionProcessingTime.

Data type

Values

Information

UINT

0 to 65535

Time limit for searching for objects from 1 ms to 6.55 s in increments of 1 ms.

0 = Timeout disabled (default)

Information:

If SymbolsType = 0 (IdentifySymbolType), Timeout is not used to search for the symbol type.

Information:

Starting with mapp Vision 5.19, parameter Timeout does not generate a status entry in the logbook when the set time has elapsed. Up to and including mapp Vision 5.18, an entry was created in the logbook each time.

ParameterMode

Information:

Volatile parameter:

Changing this parameter results in an internal parameter change, which results in longer processing time during the first subsequent run of the vision function.

A configured parameter set (acyclic write) for a maximum character recognition rate is preinstalled on the camera. A set of parameters can also be defined by the user.

A change made to the parameter set only takes effect after an image acquisition.

Data type

Values

Information

USINT

0

Predefined set of parameters (default value):

Parameter values are configured for maximum object recognition rate (at the expense of recognition speed).

1

Manual set of parameters (expert mode):

Parameter values are set independently by the user.

Initial values are the values of the last previously selected parameter set.

Information:

Using selection "Manual set of parameters" requires expert knowledge. Setting incorrect values may render complete camera functions unusable. This may only be corrected by resetting to a predefined parameter set.

The initial values of "Manual set of parameters" are always the values of the last previously selected parameter set. This means that once modified "Manual set of parameters" parameters are only valid as long as this mode is selected. If changed to a preconfigured parameter set and then back to "Manual set of parameters", any changes that were previously made to parameter set "Manual set of parameters" are no longer available.

If modified "Manual set of parameters" parameters should be saved or a previously saved recipe should be loaded, this must be done with mode "Manual set of parameters" selected. For additional information about recipe changes, see use case Handling recipes with ParameterMode "User-defined".

Grading

This parameter grades all segmented characters in a line with regard to recognition quality. The result of the quality grade is stored in parameter GradingValue(n).

This value outputs a quality value based on the taught-in characters. This value provides information about the likelihood of finding the already taught-in characters of the selected OCR classifier.

When enabled, grading has an influence on runtime and internal memory consumption.

Data type

Values

Information

BOOL

0

Disables grading of segmented characters (default value)

1

Grading enabled

OffsetROIX

Offset of the region of interest (ROI) within the image area in the x-direction.

Data type

Values

Information

DINT

-2622400 to 2622400

Offset of the ROI in the x-direction in 1/100 pixel increments. A position from -26224.00 to 26224.00 pixels can therefore be selected.

OffsetROIY

Offset of the region of interest (ROI) within the image area in the y-direction.

Data type

Values

Information

DINT

-2622400 to 2622400

Offset of the ROI in the y-direction in increments of 1/100 pixel. A position from -26224.00 to 26224.00 pixels can therefore be selected.

OffsetROIOrientation

Offset to the orientation of the region of interest (ROI). The orientation is specified in increments of 1/100 degrees.

For the angle range of -179.99° to +180.00°, this results in a usable range of values of -17999 to 18000. Values outside this range of values are interpreted as +180°.

Data type

Values

Information

INT

-17999 to 18000

-179.99° to 180.00° in increments of 1/100 degree.

OffsetROIRotCenterX

Data type

Values

Information

DINT

-2622400 to 2622400

Offset of the center of rotation in the x-direction in 1/100 pixel increments. A position from -26224.00 to 26224.00 pixels can therefore be selected.

OffsetROIRotCenterY

Data type

Values

Information

DINT

-2622400 to 2622400

Offset of the rotation center in the y-direction in increments of 1/100 pixel. A position from -26224.00 to 26224.00 pixels can therefore be selected.

TestExecute

The parameter performs a character search and displays the found regions (contour of the found character) in the mapp Vision HMI application.

Data type

Values

Information

BOOL

0

TestExecute disabled (default)

1

Execute TestExecute

Information:

This parameter is not visible in the I/O mapping. Operation takes place via the mapp Vision HMI application.