信息：

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

参数

类型

数值范围

说明

循环

非循环

图像处理错误	UINT	0 至 65535	错误类别寄存器	R
图像处理激活	BOOL	0 或 1	图像处理执行状态	R
图像定时	DINT	-2,147,483,648 至 2,147,483,647	以 1 μs 为单位的净时间	R
结果数	USINT	0 至 255	找到的匹配次数	R
函数处理时间	UINT	0 至 65535	视觉功能的处理时间（微秒	R
模型编号（n）	USINT	0 至 255	学习到的模型（与命中匹配）的 ID/编号	R
得分（n）	USINT	0 至 100	匹配结果相对于模型的等级（质量分数），取值范围为 0.0 至 1.0。	R
比例（n）	USINT	1 至 255	用于基于形状的匹配。缩放因子从 0.01 到 2.55，增量为 0.01。	R
位置 X(n)	数字	-2622400 至 2622400	图像中（找到的对象）的 X 位置，以 1/100 像素为增量	R
位置 Y(n)	数字	-2622400 至 2622400	图像中（找到的对象）的 Y 位置，增量为 1/100 像素	R
方向（n）	INT	-17999 至 18000	-179.99°到+180°，增量为 1/100 度	R
旋转中心 X	DINT	-2622400 至 2622400	此处输出偏离指定的教导对齐模型的值。以 1/100 像素为单位。	R
旋转中心 Y	DINT	-2622400 至 2622400	此处输出偏离指定的教导对齐模型的值。以 1/100 像素为单位。	R

图像处理错误

错误类别寄存器。

数据类型	值	信息
UINT	0x0001	vision_os_error：保留，当前未设置
	0x0002	VISION_OS_xxx：保留，当前未设置
	0x0004	vision_runtime_error：VisionServiceManager 发生异常。
	0x0008	VISION_LIBRARY_ERROR：Vision 函数返回的 ErrorID < 10000。
	0x0010	VISION_FUNCTION_ERROR：Vision 函数正在返回 ErrorID > 10000。
	0x0020	VISION_FILE_ERROR：保存当前图像出错
	0x0040	INVALID_VISION_FUNCTION：视觉函数出现异常
	0x0080 至 0x8000	当前未使用

信息：

带有错误 ID 的错误信息将在 AS 软件日志记录器 "Vision "下输出。

图像处理激活

状态位指示当前是否正在执行图像处理。

数据类型	值	信息
BOOL	0	图像处理未激活
BOOL	1	图像处理中

图像净时间

指定图像采集的净时间（多路采集 > 1 时为第一幅图像的净时间），图像处理结果在此时间内有效。

时间戳也会成为图像文件的名称。

数据类型	值	信息
数据	-2,147,483,648 至 2,147,483,647	NetTime 时间戳，从 1 µs 到 4294 s，增量为 1 µs（绝对 NetTime）。

结果数

找到的对象数量。该值与计数器变量 n 的最大值相对应。

数据类型	值	信息
USINT	0 至 255	找到的对象数量

功能处理时间

该参数用于指定视觉功能的处理时间，因此与处理器忙于图像处理的时间相对应。

数据类型	值	信息
UINT	0 至 65535	处理时间为 1 ms 至 65.5 s 的值，以 1 ms 为单位。

型号（n）

找到的对象的型号。根据参数NumResults 的计算值，该参数（指数为 01、02 等）会出现 n 次。参数 ModelNumber 在 I/O 映射中引入了一个新的参数块，并具有相应的索引 (n)。

ModelNumber 通过 mapp Vision 人机界面应用程序传入。

数据类型	值	信息
USINT	0 至 255	已学习模型（与命中匹配）的 ID/编号

信息：

根据参数 NumSearchMax 的计算值，该参数（指数为 01、02 等）会出现 n 次。

得分（n）

返回相应结果的得分值。得分是对找到的匹配结果与搜索所教模型匹配程度的评估。

以下参数对结果有很大影响：MinScore、MaxOverlap、ShapeSearchGreediness和ModelNumLevels。

数据类型	值	信息
USINT	0 到 100	相对于教入模型的匹配结果的等级（质量分数）。系数 0.0 至 1.0，以 0.01 为单位

数据类型

值

信息

USINT

0 到 100

相对于教入模型的匹配结果的等级（质量分数）。

系数 0.0 至 1.0，以 0.01 为单位

信息：

根据参数 NumSearchMax 的计算值，该参数（指数为 01、02 等）会出现 n 次。

缩放（n）

根据模型参数 ModelScaleMin 和 ModelScaleMax 以及 SearchScaleMin 和 SearchScaleMax 确定的极限值定义的找到的匹配的缩放因子。

对基于形状的匹配起决定性作用。如果选择了基于相关性的匹配（使用参数Type），则永久设置为 1.0。

数据类型	值	信息
USINT	1 至 255	缩放因子从 0.01 到 2.55，增量为 0.01。

信息：

根据参数 NumSearchMax 的计算值，该参数（指数为 01、02 等）会出现 n 次。

位置 X(n)

图像中（被搜索对象）的 X 位置。左上角 = 0

数据类型	值	信息
数据	-2622400 至 2622400	以 1/100 像素为增量的 X 位置。因此可以选择 -26224.00 至 26223.99 像素的位置。 2622400 = 超出范围

数据类型

值

信息

数据

-2622400 至 2622400

以 1/100 像素为增量的 X 位置。因此可以选择 -26224.00 至 26223.99 像素的位置。

2622400 = 超出范围

信息：

根据参数 NumSearchMax 的计算值，该参数（索引 01、02 等）会出现 n 次。

位置 Y(n)

图像中（被搜索对象）的 Y 位置。左上角 = 0

数据类型	值	信息
数据	-2622400 至 2622400	以 1/100 像素为增量的 Y 位置。因此可以选择 -26224.00 至 26223.99 像素的位置。 2622400 = 超出范围

数据类型

值

信息

数据

-2622400 至 2622400

以 1/100 像素为增量的 Y 位置。因此可以选择 -26224.00 至 26223.99 像素的位置。

2622400 = 超出范围

信息：

根据参数 NumSearchMax 的计算值，该参数（索引 01、02 等）会出现 n 次。

方向（n）

此处输出的是已教入模型的偏移量。教入模型定义了对齐的 0 位置。

方向以 1/100 度的增量指定。

对于 -17999 至 18000 的数值范围，可使用的角度范围为 -179.99° 至 +180.00°。小于 -17999 和大于 18000 的值被解释为 +180 度。

数据类型	数值	信息
INT	-17999至18000	以 1/100 度为增量的方向。

信息：

根据参数 NumSearchMax 的计算值，该参数（指数为 01、02 等）会出现 n 次。

旋转中心 X

图像中旋转中心（找到的物体）的 X 位置。左上角 = 0。仅与对齐相关。

数据类型	值	信息
UDINT	-2622400 至 2622400	此处输出偏离指定的教导对齐模型的值。以 1/100 像素为单位。

数据类型

值

信息

UDINT

-2622400 至 2622400

此处输出偏离指定的教导对齐模型的值。

以 1/100 像素为单位。

旋转中心 Y

图像中（找到的对象）旋转中心的 Y 位置。左上角 = 0。仅与对齐相关。

数据类型	值	信息
UDINT	-2622400 至 2622400	此处输出偏离指定的教导对齐模型的值。以 1/100 像素为单位。

数据类型

值

信息

UDINT

-2622400 至 2622400

此处输出偏离指定的教导对齐模型的值。

以 1/100 像素为单位。

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

ImageProcessingError	UINT	0 to 65535	Register of error classes	R
ImageProcessingActive	BOOL	0 or 1	Status of image processing execution	R
ImageNettime	DINT	-2,147,483,648 to 2,147,483,647	NetTime in 1 μs steps	R
NumResults	USINT	0 to 255	Number of matches found	R
FunctionProcessingTime	UINT	0 to 65535	Processing time of the vision function in microseconds	R
ModelNumber(n)	USINT	0 to 255	ID/Number of the learned model (which matches the hit)	R
Score(n)	USINT	0 to 100	Grade (quality score) of the Matching result with respect to the model in the range of values from 0.0 to 1.0.	R
Scale(n)	USINT	1 to 255	For shape-based Matching. Scaling factor from 0.01 to 2.55 in increments of 0.01.	R
PositionX(n)	DINT	-2622400 to 2622400	X-position (of the found object) in the image in increments of 1/100 pixel	R
PositionY(n)	DINT	-2622400 to 2622400	Y-position (of the found object) in the image in increments of 1/100 pixel	R
Orientation(n)	INT	-17999 to 18000	-179.99° to +180° in increments of 1/100 degree	R
RotCenterX	DINT	-2622400 to 2622400	The value deviating from the specified taught-in Alignment model is output here. In 1/100 pixel steps.	R
RotCenterY	DINT	-2622400 to 2622400	The value deviating from the specified taught-in Alignment model is output here. In 1/100 pixel steps.	R

ImageProcessingError

Data type	Values	Information
UINT	0x0001	VISION_OS_ERROR: Reserved, currently not set
	0x0002	VISION_OS_xxx: Reserved, currently not set
	0x0004	VISION_RUNTIME_ERROR: An exception has occurred in VisionServiceManager.
	0x0008	VISION_LIBRARY_ERROR: The vision function is returning an ErrorID < 10000.
	0x0010	VISION_FUNCTION_ERROR: The vision function is returning an ErrorID > 10000.
	0x0020	VISION_FILE_ERROR: Error saving the current image
	0x0040	INVALID_VISION_FUNCTION: Exception by the vision function
	0x0080 to 0x8000	Currently not in use

Information:

Error messages with an error ID are output in the Automation Studio Logger under "Vision".

ImageProcessingActive

The status bit indicates whether image processing is currently being performed or not.

Data type	Values	Information
BOOL	0	Image processing inactive
BOOL	1	Image processing in progress

ImageNettime

Specifies the NetTime of the image acquisition (with MultiCapture > 1 that of the first image) for which the results of the image processing are valid.

The timestamp also becomes the name of the image file.

Data type	Values	Information
DINT	-2,147,483,648 to 2,147,483,647	NetTime timestamp from 1 µs to 4294 s in increments of 1 µs (absolute NetTime).

NumResults

Number of objects found. The value then corresponds to the maximum value of counter variable n.

Data type	Values	Information
USINT	0 to 255	Number of objects found

FunctionProcessingTime

This parameter specifies the processing time for the vision function, and thus corresponds to the time in which the processor is busy for image processing.

Data type	Values	Information
UINT	0 to 65535	Value for a processing time of 1 ms to 65.5 s in 1 ms steps.

ModelNumber(n)

Model number of the object found. Depending on the calculated value of parameter NumResults , this parameter (with indices 01, 02, etc.) occurs n times. Parameter ModelNumber introduces a new block of parameters in the I/O mapping with the corresponding index (n).

ModelNumber is taught-in via the mapp Vision HMI application.

Data type	Values	Information
USINT	0 to 255	ID/Number of the learned model (which matches the hit)

Information:

Depending on the calculated value of parameter NumSearchMax, this parameter (with indices 01, 02, etc.) occurs n times.

Score(n)

Returns the score value for the respective result. Score is an assessment of how well a found Matching result matches the model taught-in for the search.

The following parameters have a strong influence on the result: MinScore, MaxOverlap, ShapeSearchGreediness and ModelNumLevels.

Data type	Values	Information
USINT	0 to 100	Grade (quality score) of the matching result with respect to the taught-in model. Factor 0.0 to 1.0 in 0.01 steps

Data type

Values

Information

USINT

0 to 100

Grade (quality score) of the matching result with respect to the taught-in model.

Factor 0.0 to 1.0 in 0.01 steps

Information:

Depending on the calculated value of parameter NumSearchMax, this parameter (with indices 01, 02, etc.) occurs n times.

Scale(n)

Scaling factor of the found match defined by the determined limits of model parameters ModelScaleMin and ModelScaleMax as well as SearchScaleMin and SearchScaleMax.

Decisive for shape-based Matching. Set permanently to 1.0 if correlation-based Matching is selected (using parameter Type).

Data type	Values	Information
USINT	1 to 255	Scaling factor from 0.01 to 2.55 in increments of 0.01.

Information:

Depending on the calculated value of parameter NumSearchMax, this parameter (with indices 01, 02, etc.) occurs n times.

PositionX(n)

X-position (of the found object) in the image. Top left = 0

Data type	Values	Information
DINT	-2622400 to 2622400	X position in increments of 1/100 pixel. A position from -26224.00 to 26223.99 pixels can therefore be selected. 2622400 = Out of range

Data type

Values

Information

DINT

-2622400 to 2622400

X position in increments of 1/100 pixel. A position from -26224.00 to 26223.99 pixels can therefore be selected.

2622400 = Out of range

Information:

Depending on the calculated value of parameter NumSearchMax, this parameter (with indices 01, 02, etc.) occurs n times.

PositionY(n)

Y-position (of the found object) in the image. Top left = 0

Data type	Values	Information
DINT	-2622400 to 2622400	Y position in increments of 1/100 pixel. A position from -26224.00 to 26223.99 pixels can therefore be selected. 2622400 = Out of range

Data type

Values

Information

DINT

-2622400 to 2622400

Y position in increments of 1/100 pixel. A position from -26224.00 to 26223.99 pixels can therefore be selected.

2622400 = Out of range

Information:

Depending on the calculated value of parameter NumSearchMax, this parameter (with indices 01, 02, etc.) occurs n times.

Orientation(n)

The offset to the already taught-in model is output here. The taught-in model defines the 0 position of the alignment.

The orientation is specified in increments of 1/100 degrees.

For the range of values -17999 to 18000, this results in a usable range of angles from -179.99° to +180.00°. Values less than -17999 and greater than 18000 are interpreted as +180 degrees.

Data type	Values	Information
INT	-17999 to 18000	Orientation in increments of 1/100 degrees.

Information:

Depending on the calculated value of parameter NumSearchMax, this parameter (with indices 01, 02, etc.) occurs n times.

RotCenterX

X-position of the center of rotation (of the found object) in the image. Top left = 0. Only relevant for Alignment.

Data type	Values	Information
UDINT	-2622400 to 2622400	The value deviating from the specified taught-in Alignment model is output here. In 1/100 pixel steps.

Data type

Values

Information

UDINT

-2622400 to 2622400

The value deviating from the specified taught-in Alignment model is output here.

In 1/100 pixel steps.

RotCenterY

Y-position of the center of rotation (of the found object) in the image. Top left = 0. Only relevant for Alignment.

Data type	Values	Information
UDINT	-2622400 to 2622400	The value deviating from the specified taught-in Alignment model is output here. In 1/100 pixel steps.

Data type

Values

Information

UDINT

-2622400 to 2622400

The value deviating from the specified taught-in Alignment model is output here.

In 1/100 pixel steps.

匹配数据（循环读取）

匹配数据（循环读取）

图像处理错误

图像净时间

结果数

功能处理时间

型号（n）

得分（n）

缩放（n）

位置 X(n)

位置 Y(n)

方向（n）

旋转中心 X

旋转中心 Y

ImageProcessingError

ImageNettime

NumResults

FunctionProcessingTime

ModelNumber(n)

Score(n)

Scale(n)

PositionX(n)

PositionY(n)

Orientation(n)

RotCenterX

RotCenterY