测量数据(循环读取)

<< 点击显示目录 >>

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

测量数据(循环读取)

信息:

本节指定的参数是硬件模块 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)

DINT

-2,147,483,648 至 2,147,483,647

测量值。根据操作符的不同,可以在数组中返回角度、方向、长度或距离值,或这些值的组合。

R

 

操作标识

USINT

0 至 255

在机器视觉 HMI 应用程序中配置的与结果匹配的 OperationId。

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

图像处理未激活

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)

测量值。根据操作符的不同,可返回角度、方向、长度或距离值,或以数组形式返回这些值的组合。

信息:

如果运算符角度应用于无效模型(例如圆和圆心模型),则返回值为-999。

 

信息:

从 mapp Vision 5.21 版开始,如果在当前图像中无法检测到任何模型,Result(n) 不再返回错误信息。

数据类型

信息

数据

-2,147,483,648至2,147,483,647

测量值。

信息:

根据参数 NumSearchMax 的计算值,该参数(指数为 01、02 等)会出现 n 次。

操作标识

该参数输出与结果匹配的 OperationId,该 OperationId 由用户配置(在机器视觉 HMI 应用程序中)。

数据类型

信息

USINT

0 至 255

操作标识

信息:

如果配置了该参数,结果的处理方式将发生变化,部分结果也会输出。因此,不一定要找到所有操作才能得到结果。

例如,如果已教授的四个测量操作中只有三个可以测量,那么现在就可以只输出这些部分结果。


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 measurements

R

 

FunctionProcessingTime

UINT

0 to 65535

Processing time of the vision function in microseconds

R

 

Result(n)

DINT

-2,147,483,648 to 2,147,483,647

Measurement values. Depending on the operator, it is possible to return angle, orientation, length or distance values, or a combination of any of these in an array.

R

 

OperationId

USINT

0 to 255

OperationId configured in machine vision HMI application that matches the result.

R

 

ImageProcessingError

Register of error classes.

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

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 measurements. The value then corresponds to the maximum value of counter variable n.

Data type

Values

Information

USINT

0 to 255

Number of measurements

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.

Result(n)

Measurement values. Depending on the operator, it is possible to return angle, orientation, length or distance values, or a combination of any of these in an array.

Information:

If the operator angle is applied to an invalid model (e.g. a circle and a center model), the value -999 is returned.

 

Information:

Starting with mapp Vision 5.21, Result(n) no longer returns an error if no models can be detected in the current image.

Data type

Values

Information

DINT

-2,147,483,648 to 2,147,483,647

Measurement values.

Information:

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

OperationId

This parameter outputs the OperationId that matches the result and was configured by the user (in the machine vision HMI application).

Data type

Values

Information

USINT

0 to 255

OperationId

Information:

If this parameter is configured, the handling of the results is changed and partial results are also output. All operations therefore do not have to be found to get results.

If only three of the four measurement operations that have been taught can be measured, for example, it is now possible to output just these partial results.