VisualApplets
Operator Reference

This parameter defines the number of lines omitted at the beginning of a frame.

Specifies the number of lines per frame, i.e., the image height.

If ImgTriggerMode is set to ExternSw_Gate and MaxGatedHeight is set to unrestricted, this parameter is ignored. In that case, the frame height is determined by the duration of the external Image Gate signal (see description of ImgTriggerMode).

控制当 ImgTriggerMode 设置为 ExternSw_Gate 时是否限制最大图像高度。

当设置为 restricted 时，即使门控信号保持打开，图像高度也会被限制为 YLength 中指定的值。任何额外的行都将被丢弃，并且算子会等待门控信号的下一个上升沿来开始新的一帧。

当设置为 unrestricted 时，图像高度完全由门保持打开的时间决定。换句话说，它取决于外部图像触发信号的脉冲宽度，或者软件触发保持在值 1 的时间长短。如果门保持打开很长时间，生成的图像可能会变得非常大。

	可能违反 Link Property
	在 unrestricted 模式下使用此参数可能会违反 VisualApplets link 协议。图像高度可能会超过算子输出 link 中定义的最大允许图像高度。请谨慎使用 unrestricted 模式。 有关 link properties 的更多信息，请参阅 'Link Properties'。 随后的 SplitImage 算子可以将大图像分割成较小的块。

选择内部 Exsync 信号发生器的 Operating Mode。当使用外部触发模式时，触发源由 LineTrgInSourceA 和 LineTrgInSourceB 定义。

Enables or disables the Exsync output to the camera.

此参数指定用于触发 Exsync 信号发生器的信号源。此参数仅在 LineTriggerMode 设置为 Extern_Trigger 或 Extern_Trigger_Gated_by_Img 时相关。

此参数指定用于触发 Exsync 信号发生器的信号源。此参数仅在 EncoderABMode 设置为 A/B 模式之一（Signal_AB_Filter、Signal_ABx2_Filter 或 Signal_ABx4_Filter）时相关，此外还需满足：

选择是仅将触发输入 A 还是同时将触发输入 A 和 B 用于 Exsync 生成。

A/B 信号支持使算子能够确定旋转编码器的旋转方向，并抑制反向移动或进行补偿：

启用 A/B 支持时的相关参数：

要重置轴编码器状态和 EncoderCompensationCount，请将 EncoderABMode 设置为 Signal_A_Only。

定义哪个信号超前，以识别轴编码器的正向旋转方向：

使用参数 EncoderCompensation，您可以将轴编码器反向运动补偿切换为 ON 或 OFF。

此参数仅在将 EncoderABMode 参数设置为 A/B 支持时才相关。

开启

如果设置为 ON，算子将监控轴编码器的反向运动。当发生反向运动时，算子会计算反向移动了多少个编码器步数。一旦轴编码器再次开始正向移动，这些已计数的步数（现在按正向计算）将不会作为外部触发信号传输。只有当传送带返回到开始反向运动的位置时，正向的编码器步数才会再次作为外部触发信号传输。

参数 EncoderCompensation = ON：

OFF

如果设置为 OFF，则当传送带反向移动时，算子不会传输任何触发信号。一旦传送带再次开始正向移动，算子就会恢复传输轴编码器步数（按正向）作为触发信号。

参数 EncoderCompensation = OFF：

要将 EncoderCompensationCount 参数重置为值 0，请将 EncoderCompensation 参数设置为 OFF。

此参数指定可分配给 EncoderCompensationCount 的值范围。

只有当 EncoderCompensation 参数设为 ON 且 EncoderABMode 参数设为 A/B 支持时，此参数才有效。

此参数用于指定输送带向前移动的偏移量。如果输送带停止和/或向后移动，这会特别有用。

您可以使用 EncoderCompensationCountBits 参数为 EncoderCompensationCount 参数定义特定的值范围。

若要重置轴编码器和 EncoderCompensationCount 参数，请将 EncoderABMode 参数设为 Signal_A_Only 值。

或者，您可以通过将 EncoderCompensation 参数设为 OFF，将 EncoderCompensationCount 参数重置为 0 值。

基本条件

如果将 EncoderCompensation 参数设为 ON，内部计数器将对输送带向后移动时的轴编码器步数进行计数。这样，当输送带再次开始向前移动时，您可以精确补偿相应的轴编码器步数：

只要输送带向后移动，内部计数器就会向前计数。在上图中：从 0 到 8。

当输送带向前移动时，内部计数器会向后计数。在上图中：从 8 到 0。

当内部计数器保持 0 值时，轴编码器步数将作为触发信号传输。

内部计数器在给定时刻保持的值即为 EncoderCompensationCount 参数的值。只有当该值为 0 时，编码器步数才会作为触发信号传输。如果 EncoderCompensationCount 参数的值 ≠0，则轴编码器步数不会作为触发信号传输，并且该值会随着每个编码器步数不断变化，直至再次达到 0 值。

读取参数

EncoderCompensationCount 参数是一个读/写参数。因此，您可以随时读取计数器当前保持的值。

定义偏移量

另一方面，由于您在采集期间拥有写权限，因此可以随时修改参数值。如果您需要为标准编码器补偿定义偏移量，可以使用此参数输入所需的偏移步数。

只要您为 EncoderCompensationCount 输入一个值，该值就会覆盖该参数之前保持的值。

以下示例展示了如何修改 EncoderCompensationCount 的现有值：

示例 1： 输送带正在向前移动，轴编码器步数作为触发信号传输，并且 EncoderCompensationCount 的值为 0。然后，将 EncoderCompensationCount 的值 0 覆盖为值 4。结果：有 4 个轴编码器步数不作为触发信号传输。

示例 2： 输送带正在向后移动，（向后的）轴被抑制，并且 EncoderCompensationCount 的值为 ≠0。然后，在输送带向后移动期间，将 EncoderCompensationCount 的值 5 覆盖为值 7。结果：2 个轴编码器步数的偏移量。

示例 3： 输送带在补偿期间向前移动，（向前的）轴编码器步数被抑制，并且 EncoderCompensationCount 的值为 ≠0。然后，在输送带进行补偿性向前移动期间，将 EncoderCompensationCount 的值 4 覆盖为值 9。结果：5 个轴编码器步数的偏移量。

示例 4： 输送带在补偿期间向前移动，（向前的）轴编码器步数被抑制，并且 EncoderCompensationCount 的值为 ≠0。然后，在输送带进行补偿性向前移动期间，将 EncoderCompensationCount 的值 4 覆盖为一个较小的值，在我们这里是值 3。结果：-1 个轴编码器步数的负偏移量。

此参数用于定义外部输入触发信号 LineTrgInSourceA 和 LineTrgInSourceB 的极性。当设为 LowActive 时，Exsync 发生器在指定的行触发源（LineTrgInSourceA / LineTrgInSourceB）的下降沿启动。否则，Exsync 生成将在上升沿启动。只有当 LineTriggerMode 设为 Extern_Trigger 或 Extern_Trigger_Gated_by_Img 时，此参数才有效。

此参数用于指定生成 Exsync 所需的外部输入触发信号数量。只有当 LineTriggerMode 设为外部触发模式时，此参数才有效。

此参数用于指定生成一帧图像的第一个 Exsync 所需的外部输入触发信号数量。只有当 LineTriggerMode 设为 Extern_Trigger_Gated_by_Img 时，此参数才有效。

此参数指定 Exsync 信号的周期。因此，在使用采集卡控制模式触发所连接的相机时，它定义了行频。

此参数的范围和允许的步长取决于设计中配置的 FPGA 时钟频率。允许的步长为 1/DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 设计中 FPGA 的时钟频率，单位为 MHz。

此参数指定 Exsync 信号的脉冲宽度，许多相机可以利用该宽度来指定曝光时间。因此，即使在采集过程中，也可以通过软件调整曝光时间。

此参数的范围和允许的步长取决于设计中配置的 FPGA 时钟频率。允许的步长为 1/DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 设计中 FPGA 的时钟频率，单位为 MHz。

此参数指定生成的 Exsync 信号相对于外部触发输入的延迟。因此，Exsync2 信号是 Exsync 的延迟克隆：其极性、周期等与 Exsync 相同。

此参数的范围和允许的步长取决于设计中配置的 FPGA 时钟频率。允许的步长为 1/DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 设计中 FPGA 的时钟频率，单位为 MHz。

此参数将 Exsync 信号发生器的极性调整为所连接相机接受的极性。如果相机在下降沿打开快门，请使用 LowActive，否则使用 HighActive。

此参数选择内部图像门（Image Gate）的操作模式。

图像触发输入信号可以由外部（即外围）设备（如旋转编码器）或软件产生。您可以通过 ImgTrgInSource 参数选择外部图像触发输入的源，见下文。

ImgTriggerMode 参数的值会导致以下行为：

此参数用于指定触发图像采集的信号源。这仅在 ImgTriggerMode 设置为 ExternSw_Trigger 或 ExternSw_Gate 时相关。

此参数用于定义外部输入触发信号的极性。

此参数可将图像触发信号延迟指定的行数。

启用或禁用闪光灯输出。闪光灯信号的脉冲宽度等于一个行周期。

此参数用于定义生成的 Flash 信号的极性。

此参数用于指定相对于外部触发输入，生成的 Flash 信号所延迟的行数。因此，可以将 Flash 与外部触发输入同步。

Flash 信号的脉冲宽度等于一个行周期。

将此参数设置为 1 将生成一个软件触发。只有在 ImgTriggerMode 设置为外部触发模式且 ImgTrgInSource 设置为 SoftwareTrigger 时，此设置才有效。

通过此参数，可以为图像触发模式 ExternSw_Gate 生成软件门信号。

ImgTrgIsBusy 参数指示图像触发的忙碌状态。当图像触发处于忙碌状态时，该参数设置为 1，表示当前正在捕获图像。当设置为 0 时，图像触发不处于忙碌状态。

此参数指定在 CC1 线路（相机控制 1）上可用的信号。

此参数指定在 CC2 线路（相机控制 2）上可用的信号。

此参数指定在 CC3 线路（相机控制 3）上可用的信号。

此参数指定在 CC4 线路（相机控制 4）上可用的信号。

此参数定义了 ImgTrgDebouncingTime 参数的最大值。较小的最大值可减少实现去抖动 Timer 所需的 FPGA 资源。

此参数的有效范围和允许的步长取决于设计中配置的 FPGA 时钟频率。允许的步长为 1 / DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 设计中 FPGA 的时钟频率，单位为 MHz。

此参数指定去抖动时间，输入图像触发信号必须在此时间内保持不变才能被识别为有效。去抖动时间内的快速信号变化将被滤除。

此参数的有效范围和允许的步长取决于设计中配置的 FPGA 时钟频率。允许的步长为 1 / DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 设计中 FPGA 的时钟频率，单位为 MHz。

此参数指定 LineTrgDebouncingTime 参数的最大时间。较小的最大值可减少实现去抖动 Timer 所需的 FPGA 资源。

此参数的有效范围和允许的步长取决于设计中配置的 FPGA 时钟频率。允许的步长为 1 / DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 设计中 FPGA 的时钟频率，单位为 MHz。

此参数指定去抖动时间，输入行触发信号必须在此时间内保持不变才能被识别为有效。去抖动时间内的快速信号变化将被滤除。

此参数的有效范围和允许的步长取决于设计中配置的 FPGA 时钟频率。允许的步长为 1 / DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 设计中 FPGA 的时钟频率，单位为 MHz。