输入和输出说明

<< 点击显示目录 >>

主页  mappVision帮助助手 > 机器视觉帮助 > mapp Vision  > 编程 > > 核心库 > ViBase  > 功能块
> 功能块 ViBaseGetImage  >

输入和输出说明

输入/输出

名称

数据类型

说明

输入

MpLink

指向ViComponentType的指针

应从视觉组件获取图像的指针。

IN

执行

BOOL

在该输入的上升沿开始执行功能块。

输入

类型

ViBaseImageTypeEnum(基本图像类型枚举

确定提供图像数据的图像格式。

输入

质量等级

USINT

JPG 压缩质量级别。如果 Type = viBASE_IMAGE_TYPE_BMP,则忽略。有效值范围:1 - 100.

超时

超时

时间

执行功能块的最长时间。值 0 时无时间限制。不允许使用负值。

缓冲区

缓冲区

UDINT

指向复制图像数据的内存区域的指针。

IN

缓冲区大小

UDINT

指定数据区域的长度(要复制的字节数)。必须至少为 512 字节。

输出

完成

BOOL

执行成功。功能块执行完毕。

BOOL

功能块处于活动状态,必须继续调用。

激活

BOOL

表示已开始从摄像机传输图像数据。

错误

错误

BOOL

执行过程中出错。

输出

状态 ID

DINT

状态信息。

输出

缓冲区长度

UDINT

实际复制的字节数。

输出

网络时间

DINT

拍摄图像时的净时间。

表:功能块 ViBaseGetImage 的输入和输出


I/O

Name

Data type

Description

IN

MpLink

Pointer to ViComponentType

Pointer to the vision component from which the image should be retrieved.

IN

Execute

BOOL

Execution of the function block begins on a rising edge of this input.

IN

Type

ViBaseImageTypeEnum

Determines the image format in which the image data is provided.

IN

QualityLevel

USINT

JPG compression quality level. Ignored if Type = viBASE_IMAGE_TYPE_BMP. Valid range of values: 1 - 100.

IN

Timeout

TIME

Maximum time to execute the function block. No time limit is active for value 0. Negative values are not permitted.

IN

Buffer

UDINT

Pointer to a memory area to which the image data is copied.

IN

BufferSize

UDINT

Length of the specified data area (number of bytes to be copied). Must be at least 512 bytes.

OUT

Done

BOOL

Execution successful. The function block is finished.

OUT

Busy

BOOL

The function block is active and must continue to be called.

OUT

Active

BOOL

Indicates that data transfer of the image from the camera has started.

OUT

Error

BOOL

Error during execution.

OUT

StatusID

DINT

Status information.

OUT

BufferLen

UDINT

Number of bytes actually copied.

OUT

Nettime

DINT

NetTime when the image was taken.

Table: Inputs and outputs of function block ViBaseGetImage