数据类型

<< 点击显示目录 >>

主页  mappVision帮助助手 > 机器视觉帮助 > mapp Vision  > 编程 > > 核心库 > ViBase  > 数据类型和常量 >

数据类型

ViComponentType

数据类型为 ViComponentType 的变量是内部变量。在创建视觉组件时,将自动创建一个相关的 "ViComponentType "变量。可以通过视觉组件的名称来引用该变量。

ViBaseAxBsdAcqAcqParType

参数

数据类型

描述

采集位置

LREAL[8]

以[测量单位]表示的在定义的 "周期 "或轴周期内应采集图像的位置。

注:

索引 > 0 时,值 0.0 定义为非活动位置。

从第一个非活动位置开始,后面的所有数组条目也必须定义为非活动。

所有活动位置必须严格单调递增。

周期

LREAL

如果使用非周期性轴或使用与定义轴周期不同的轴周期,则以[测量单位]为单位的周期。

定义采集位置的定义周期或重复采集位置的周期。

注意

只允许大于 0 且小于 231 * 轴的 "测量分辨率 "的值。

起始位置

LREAL

以 [测量单位] 为单位的周期起始位置。

非周期轴:该值对应一个绝对位置值,采集位置的周期从该值开始。如果已经超过该位置,则从 "StartPosition(起始位置)"+"Period(周期)"的下一个倍数开始执行功能。

周期轴:该值对应于轴周期内的一个位置值,功能应在该轴周期内启动。如果指定的值不是 "0","Period"(周期)的起始位置将相对于轴周期的起始位置移动。可能的取值范围:[0,轴周期]。

表:ViBaseAxBsdAcqAcqParType

ViBaseAxBsdAcqAdvParType

参数

数据类型

数据类型

禁用负方向

BOOL

如果为 TRUE,则仅在轴的位置值增加时才触发图像采集。

添加位置补偿

真实

此处配置的时间值 [s] 将添加到自动确定的位置补偿时间(请参阅 ViBasedAxBsdAcqAddInfoType 的 DefaultPositionCompensation)。

必要时,可用于补偿从位置评估到 PLC 接收位置之间的时间。

也允许使用负值。

注意

如果使用轴的位置设定值,内部会自动确定正确的位置补偿时间。如果使用实际位置值(例如来自外部编码器轴的位置值),则还必须考虑以下时间:

编码器的评估时间

计数器模块的评估时间

网络周期时间(X2X、POWERLINK 等)

另请参阅自动化帮助:

X2X 链接 - 延迟时间

POWERLINK - 输入延迟

添加输出补偿

LREAL

此处配置的时间值 [s] 将添加到自动确定的输出补偿时间(请参阅 ViBasedAxBsdAcqAddInfoType 的 DefaultOutputCompensation)。

如有必要,可以用它来补偿将时间戳传输到摄像机模块所需的时间。

也允许使用负值。

注意

在默认设置下,内部会自动确定正确的输出补偿时间。

表:ViBaseAxBsdAcqAdvParType

ViBaseAxBsdAcqAddInfoType

参数

数据类型

数据类型

默认位置补偿

真实

自动确定的位置补偿时间 [s]。

默认输出补偿

真实

自动确定的输出补偿时间 [秒]。

时间戳计数

SINT

当为图像采集计算出新的时间戳值时,该值将发生变化。

注意:

如果设置了 "PauseAcquisition(暂停采集)",则不会设置该值。

计算的时间戳

DINT

转发给视觉组件的最后计算时间戳值。

请注意:

如果设置了 "PauseAcquisition(暂停采集)",则不会设置该值。

表格:ViBaseAxBsdAcqAddInfoType


ViComponentType

Variables of data type ViComponentType are internal variables. During the creation of a vision component, an associated "ViComponentType" variable will be automatically created. This can be referenced by the name of the vision component.

ViBaseAxBsdAcqAcqParType

Parameter

Data type

Description

AcquisitionPositions

LREAL[8]

Positions in [measurement units] within the defined "Period" or axis period in which images should be acquired.

Notes:

For index > 0, value 0.0 defines an inactive position.

Starting from the first inactive position, all following array entries must also be defined as inactive.

All active positions must be strictly monotonically increasing.

Period

LREAL

Period in [measurement units] if a non-periodic axis is used or a different axis period than the one defined should be used.

Defines the period within which the acquisition positions are defined or after which they are repeated.

Note:

Only values greater than 0 and less than 231 * the "measuring resolution" of the axis are permitted.

StartPosition

LREAL

Start position in [measurement units] of the period.

Notes:

Non-periodic axis: The value corresponds to an absolute position value at which the period for the acquisition positions is started. If this position has already been exceeded, the function is started at the next multiple of "StartPosition" + "Period".

Periodic axis: The value corresponds to a position value within the axis period at which the function should be started. If a value other than "0" is specified, the start of "Period" is shifted with respect to the start of the axis period. Range of possible values: [0, axis period].

Table: ViBaseAxBsdAcqAcqParType

ViBaseAxBsdAcqAdvParType

Parameter

Data type

Description

DisableNegativeDirection

BOOL

If TRUE, the image acquisition is only triggered when the position value of the axis increases.

AddPositionCompensation

REAL

The time value [s] configured here is added to the automatically determined position compensation time (see DefaultPositionCompensation for ViBasedAxBsdAcqAddInfoType).

If necessary, this can be used to compensate for the duration between the position evaluation and the reception of the position on the PLC.

Negative values are also permitted.

Note:

If a position setpoint of an axis is used, the correct position compensation time is automatically determined internally. If actual position values are used (e.g. from an external encoder axis), the following times must also be taken into account:

Evaluation time of the encoder

Evaluation time of the counter module

Network cycle time (X2X, POWERLINK, etc.)

See also Automation Help:

X2X Link - Latency times

POWERLINK - Input latency

AddOutputCompensation

LREAL

The time value [s] configured here is added to the automatically determined output compensation time (see DefaultOutputCompensation for ViBasedAxBsdAcqAddInfoType).

If necessary, this can be used to compensate for the duration required to transfer the timestamp to the camera module.

Negative values are also permitted.

Note:

With a default setting, the correct output compensation time is automatically determined internally.

Table: ViBaseAxBsdAcqAdvParType

ViBaseAxBsdAcqAddInfoType

Parameter

Data type

Description

DefaultPositionCompensation

REAL

Automatically determined position compensation time [s].

DefaultOutputCompensation

REAL

Automatically determined output compensation time [s].

TimestampCount

SINT

The value is changed when a new timestamp value is calculated for the image acquisition.

Note:

The value is not set if "PauseAcquisition" is set.

CalculatedTimestamp

DINT

Last calculated timestamp value forwarded to the vision component.

Note:

The value is not set if "PauseAcquisition" is set.

Table: ViBaseAxBsdAcqAddInfoType