测量参数（循环写入）

<< 点击显示目录 >>

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

测量参数（循环写入）

信息：

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

参数

类型

数值范围

说明

循环

非循环

启用

BOOL

0 或 1

启用/禁用功能

W

 

最大搜索次数

USINT

0 至 255

最大测量次数

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 框架的占位符。

 

信息：从理论上讲，"NumResultsMax"（搜索次数最大值）与 "NumResultsMax"（搜索次数最小值）是一致的：

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

偏移量

图像区域内感兴趣区域 (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 the measurement

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 measurement results 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 results to be found.

Data type

Values

Information

USINT

0 to 255

Maximum number of results to be searched 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.

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.

This parameter performs a measurement and displays the results 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.