Blob 参数(循环写入)

<< 点击显示目录 >>

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

Blob 参数(循环写入)

信息:

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

参数

类型

数值范围

说明

循环

非循环

启用

BOOL

0 或 1

启用/禁用功能

W

 

最大搜索次数

USINT

0 至 255

要搜索的 Blob 的最大数量

W

 

区域特征

BOOL

0 或 1

启用几何排除程序

W

 

增强球状信息

BOOL

0 或 1

0 = 传输附加信息(默认值)。

1 = 不传输附加信息。

意味着函数处理时间增加

W

 

对齐

USINT

0 至 2

0 = "无

1 = "设置参照

2 = "GenerateAlignmentData" (生成对齐数据

W

 

偏移量

DINT

-2622400 至 2622400

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

W

 

偏移量

数字

-2622400 至 2622400

ROI 在 Y 方向上的偏移量,以 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

显示采集图像中发现的 Blob。

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

W

 

启用

启用/禁用视觉功能。

数据类型

信息

BOOL

0

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

1

启用图像处理功能。

NumSearchMax

最大搜索对象数量参数。

该值不应大于可查找对象的实际数量,否则将不必要地延长图像处理例程的运行时间。

数据类型

信息

USINT

0 至 255

搜索对象的最大数量

信息:

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

 

信息:

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

区域特征

用于启用几何排除程序的参数。在用户教学过程中,会有专门的操作员在后台检查几何形状的参数模型。

例如,在对圆形球体进行示教过程中,不会检测到灰度级和区域值相似的其他几何形状。

将对圆形、矩形和异形进行检查。

激活的 RegionFeatures 会增加执行时间。

数据类型

信息

BOOL

0

禁用(默认值)

1

已启用

增强球状信息

如果禁用 EnhancedBlobInformation,则只有参数 PositionX、PositionY 和 Orientation 会循环填充数据。但是,如果定义的输出与上述输出不一致,则这些输出将被填充为 0。

启用该参数会增加 POWERLINK 帧的大小,因为额外的参数也会循环传输。

数据类型

信息

BOOL

0

禁用 EnhancedBlobInformation(默认值)

1

执行 EnhancedBlobInformation。这会增加函数处理时间。

对齐

信息:

易变参数:

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

在对齐(1 或 2)期间,NumResultsMax 会自动设置为 1(内部)。对齐参考数据存储在视觉功能数据中。但只有当参数 Alignment 设置为 1 至 2 时才会这样做。当然,对齐时只能教导 1 个模型(作为参考)。

有关对齐功能的更多信息,请参阅视觉功能 - 对齐。

数据类型

信息

USINT

0

无。无对齐

1

设置参照

2

生成对齐数据

偏移 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 像素之间的位置。

测试执行

信息:

易失性参数:

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

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

数据类型

信息

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 blobs to be searched for

W

 

RegionFeatures

BOOL

0 or 1

Enables the geometric exclusion procedure

W

 

EnhancedBlobInformation

BOOL

0 or 1

0 = Additional information is transferred (default).

1 = Additional information is not transferred.

Means an increase of FunctionProcessingTime

W

 

Alignment

USINT

0 to 2

0 = "None"

1 = "SetReference"

2 = "GenerateAlignmentData"

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 y-direction in increments of 1/100 pixel.

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 blobs 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 objects to be found.

The value should not be greater than the actual number of findable objects; otherwise, the runtime of the image processing routine will be unnecessarily extended.

Data type

Values

Information

USINT

0 to 255

Maximum number of objects to search

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.

RegionFeatures

Parameter for enabling the geometric exclusion procedure. During teach-in by the user, a special operator checks the parameter models for a geometric shape in the background.

During the teach-in process for circular blobs, for example, other geometric shapes that have similar gray levels and area values are not detected.

Circularity, rectangularity and anisometry are checked.

An active RegionFeatures increases the execution time.

Data type

Values

Information

BOOL

0

Disabled (default value)

1

Enabled

EnhancedBlobInformation

If EnhancedBlobInformation is disabled, only parameters PositionX, PositionY and Orientation are cyclically filled with data. If outputs are defined that do not correspond to those described above, however, then these are filled with 0.

Enabling this parameter increases the size of the POWERLINK frame since additional parameters are also transferred cyclically.

Data type

Values

Information

BOOL

0

EnhancedBlobInformation disabled (default value)

1

Execute EnhancedBlobInformation. This increases FunctionProcessingTime.

Alignment

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.

NumResultsMax is automatically set to 1 (internally) during Alignment (1 or 2). Alignment reference data is stored in the vision function data. Only if parameter Alignment is set from 1 to 2, however. Of course, only 1 model (as reference) can be taught for Alignment.

For additional information about function Alignment, see Vision functions - Alignment.

Data type

Values

Information

USINT

0

None. No alignment

1

SetReference

2

GenerateAlignmentData

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

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.

The parameter performs a blob search and displays the found regions (area of the found blobs) 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.