<< 点击显示目录 >> 主页  mappVision帮助助手 > 机器视觉帮助 > mapp Vision  > 编程 > 视觉功能 > 图像采集 > 图像采集数据（循环读取）

信息：

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

UndervoltageError/欠压错误

电源报警。状态位，指示是否至少维持了电源下限。

SensorTemperature/传感器温度

摄像机当前的温度（°C）。

DigitalInput01/数字输入01

Status bit of the digital input (trigger input).

ImageAcquisitionReady/图像采集就绪

状态位指示摄像机是准备好进行图像处理（Ready）还是忙（Busy）。在以下情况下，摄像机处于忙碌状态；因此状态位 ImageAcquisitionReady = 0。

•在摄像机启动和初始化期间。

•将视觉程序传输到摄像机后。

•保存训练数据时。

•使用参数 SearchAcquisitionSettings 自动确定采集图像的积分时间和焦点期间。

•手动调整焦距设置直至达到位置设定点时。

•对于重新配置传感器行为的参数。

•在无法触发传感器的活动中（如连续图像采集）。

信息：

只要摄像机处于忙碌状态，就无法启动触发器或图像处理。

CameraStatus/摄像机状态

此参数指定摄像机的状态。其范围包括图像采集的各个方面，以及摄像机操作系统、视觉应用程序或 mapp Vision HMI 应用程序的状态。

在运行过程中，必须检查应用程序中该参数是否为 0。

信息：

例如，0x00001080 表示图像传感器尚未准备就绪，因为目前仍在重新调整焦距。

信息：

位 MAPPVISION_HMI_ACTIVE 对 ImageAcquisitionReady 的值没有影响。

相机处理时间

此参数指定从开始图像处理到提供结果的时间。这相当于处理器忙于执行图像处理的时间（更多信息，请参阅图像采集和后续图像处理 - 时序图一节）。

图像采集和传输到图像处理处理器内存区域的时间取决于相机型号（图像传感器）和所选的图像采集参数。该参数还包含来自摄像机操作系统的抖动，抖动程度取决于应用。

 

ImageProcessingError/图像处理错误

位模式，用于显示图像处理过程中出现的错误和警告。

如果出现警告或错误，所有结果值都将重置为 0。

ReadGainLevel/读取增益等级

该参数返回一个值，表示参数 GainLevel（增益等级）中设置的当前增益因数（有关增益因数的更多信息，请参阅参数说明）。

ReadFocus/读聚焦

信息：

不适用于 C 卡口相机！

此参数仅适用于内置镜头的相机型号。

该参数指定当前使用的对焦设置，可以在参数 SetFocus 中手动设置，也可以由 SearchAcquisitionSettings 自动确定。

可使用的数值范围取决于所使用的光学器件。此外，非循环参数 FocusScale 允许以 1 毫米或 1/100 毫米增量的原始数据步长或分辨率设置聚焦值范围的缩放。

信息：

如果摄像机的焦点是自动设置的（请参阅参数 SearchAcquisitionSettings），则只有当摄像机状态位 ImageAcquisitionReady 再次为 1 时才会使用焦点搜索确定的值。

ReadExposureTime/读取曝光时间

该参数指定当前使用的积分时间，该时间在参数 ExposureTime(n)中设置。.

信息：

如果摄像机的积分时间是自动设置的（请参阅参数 SearchAcquisitionSettings），则此处确定的最佳积分时间值仅在搜索程序完成且摄像机状态位 ImageAcquisitionReady 再次为 1 时使用。

AcceptedAcquisitionCnt/已接受采集计数

已接受图像采集的计数器。

信息：

在评估图像采集计数器时必须考虑潜在的数值溢出！

CompletedAcquisitionCnt/已完成采集计数

已执行图像采集的计数器。

信息：

在评估图像采集计数器时必须考虑潜在的数值溢出！

FailedAcquisitionCnt/失败采集次数

图像采集失败或无效的计数器，例如采集时间不正确。CompletedAcquisitionCnt 仍可向上计数。

信息：

在评估图像采集计数器时必须考虑潜在的数值溢出！

LightWarningCnt/灯光警告计数

与照明有关的错误或警告计数器。在下列情况下，该参数值会增加：

•曝光时间过长。

•功率太小。

•如果未保持采样行为。

ImageNettime/图像时间

获取图像的净时间。

每个触发的图像采集都有一个 ImageNettime。如果是多幅图像采集 MultiCapture，则返回第一幅图像的净时间。因此，每个视觉应用程序只有一个 ImageNettime。

图像的净时间也可用作位图文件名。

DigitalOutputStatus01/数字输出状态01

摄像机数字输出的状态位。

---

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.

UndervoltageError

Power supply alarm. Status bit that indicates whether at least the lower limit of the power supply is maintained.

SensorTemperature

Current temperature in the camera in °C.

DigitalInput01

Status bit of the digital input (trigger input).

ImageAcquisitionReady

The status bit indicates whether the camera is ready for image processing (Ready) or busy (Busy). In the following cases, the camera is busy; therefore, status bit ImageAcquisitionReady = 0.

•During Startup and initialization of the camera.

•After transferring a vision program to the camera.

•While saving training data.

•During the automatic determination of the integration time and focus of the acquired image using parameter SearchAcquisitionSettings.

•When manually adjusting the focus setting until the position setpoint is reached.

•For parameters that reconfigure the sensor behavior.

•During activities in which the sensor cannot be triggered (e.g. continuous image acquisition).

Information:

As long as the camera is busy, neither a trigger nor image processing can be started.

CameraStatus

This parameter specifies the status of the camera. This ranges from various aspects of image acquisition to states of the camera's operating system, the vision application or mapp Vision HMI application.

This parameter must be checked for 0 in the application during operation.

Information:

Not only one status can be displayed at a time, but also a combination of several, e.g. 0x00001080 can indicate that the image sensor is not ready yet because the focus is currently still being readjusted.

Information:

Bit MAPPVISION_HMI_ACTIVE has no effect on the value of ImageAcquisitionReady.

CameraProcessingTime

This parameter specifies the time from the start of image processing to when the results are provided. This corresponds to the time during which the processor is busy executing image processing (for additional information, see section Image acquisition and subsequent image processing - Timing diagram).

The image acquisition and transfer to the memory area of the image processing processor depends on the camera model (image sensor) and selected image acquisition parameters. This parameter also contains jitter from the camera operating system, the extent of which depends on the application.

ImageProcessingError

Bit pattern for displaying errors and warnings that occurred during image processing.

If a warning or an error occurs, all result values are reset to 0.

ReadGainLevel

This parameter returns a value that represents the current gain factor set in parameter GainLevel (more information about the gain factor is specified in the parameter description).

ReadFocus

Information:

Not for C mount cameras!

This parameter is only available for camera variants with a built-in lens.

This parameter specifies the currently used focus setting, which can either be set manually in parameter SetFocus manually or is determined automatically by SearchAcquisitionSettings.

The usable range of values depends on the optics used. In addition, acyclic parameter FocusScale permits the scaling of the focus range of values to be set in raw data steps or resolutions of 1 mm or 1/100 mm increments.

Information:

If the focus of the camera is set automatically (see parameter SearchAcquisitionSettings), the value determined from the focus search is only used when camera status bit ImageAcquisitionReady is 1 again.

ReadExposureTime

This parameter specifies the currently used integration time that is set in parameter ExposureTime(n).

Information:

If the integration time of the camera is set automatically (see parameter SearchAcquisitionSettings), the value determined here for the optimal integration time is only used when the search procedure is completed and camera status bit ImageAcquisitionReady is 1 again.

AcceptedAcquisitionCnt

Counter for accepted image acquisitions.

Information:

A potential value overflow must be taken into account when evaluating the image acquisition counter!

CompletedAcquisitionCnt

Counter for performed image acquisitions.

Information:

A potential value overflow must be taken into account when evaluating the image acquisition counter!

FailedAcquisitionCnt

Counter for failed or invalid image acquisitions, e.g. acquisitions with incorrect timing. CompletedAcquisitionCnt can still count up.

Information:

A potential value overflow must be taken into account when evaluating the image acquisition counter!

LightWarningCnt

Counter for errors or warnings that have occurred related to lighting. The value of this parameter is increased in the following cases:

•If the exposure was too long.

•If there is too little power.

•If the sampling behavior is not maintained.

ImageNettime

NetTime of the acquired image.

Each triggered image acquisition has an ImageNettime. In the event of multiple image acquisition MultiCapture, the NetTime of the 1st image is returned. Each vision application therefore only has one ImageNettime.

The NetTime of an image is also used as its bitmap filename.

DigitalOutputStatus01

Status bit of the digital output of the camera.