Counter#

相机的 Counter 功能允许您计算部分相机事件的数量，例如，采集的图像数量。

该功能的使用#

The implementation of this feature varies depending on the camera:

• ace 2, boost R, dart M/R, and racer 2 Cameras
• ace Classic/U/L 相机

ace 2, boost R, dart M/R, and racer 2 Cameras#

运作原理#

Depending on your camera model, up to three counters are available: Counter 1, Counter 2, and Counter 3.

每个计数器都具有以下特征：

• 从 0 开始。
• 必须先启动才能计数。
• 一旦启动，就可以对特定类型的事件（即“事件源”）进行计数。例如，它可以对已曝光的图像数量进行计数。
• 可以随时重置为 0。
• 可以通过获取 CounterValue 参数的值来确定其当前值。
• 其最大值由 CounterDuration 参数值来定义（默认值：4 294 967 295）。达到最大值后，计数器会停止计数，必须将其重置。
• 可以通过获取 CounterStatus 参数的值来确定其当前状态。
• 每次关闭相机电源后再次打开电源时，它将重置为 0。

获取计数器值#

若要确定计数器的当前值，请获取 CounterValue 参数的值。此为只读参数。

启动计数器#

要启动计数器，请执行以下操作：

1. 将 CounterSelector 参数设置为所需的计数器，例如 Counter2。
2. 将 CounterTriggerSource 参数设置为要用于启动计数器的源，例如 Line2。
3. 如果适用，请设置 CounterTriggerActivation 参数设置为以下值：
   • RisingEdge（默认值）：当信号上升时，即信号状态从低变高时，计数器开始计数。
   • FallingEdge：当信号下降时，即信号状态从高变低时，计数器启动。
   • AnyEdge：当信号下降或上升时，计数器启动。
   • LevelHigh：当信号为高电平时，计数器启动。当信号变为低电平时，计数器状态设为 CounterTriggerWait，必须重新启动。
   • LevelLow：当信号为低电平时，计数器启动。当信号变为高电平时，计数器状态设为 CounterTriggerWait，必须重新启动。
4. 通过在选定的计数器触发源上发送信号来启动计数器。

启动后，计数器的状态从 CounterTriggerWait 更改为 CounterActive。

增加计数器计数#

计数器一旦启动，就可以开始增加计数器的数字，也就是可以开始计数。

要增加计数器，请执行以下操作：

1. 将 CounterSelector 参数设置为所需的计数器，例如 Counter2。
2. 将 CounterEventSource 参数设置为要用于增加计数器的源，例如 Line2。
3. 如果适用，请设置 CounterEventActivation 参数设置为以下值：
   • RisingEdge（默认值）：当信号上升时，即信号状态从低变高时，计数器开始计数。
   • FallingEdge：当信号下降时，即信号状态从高变低时，计数器开始计数。
   • AnyEdge：当信号下降或上升时，计数器开始计数。
4. 将 CounterDuration 参数设置为所需的最大值。
5. 通过在选定的计数器事件源上发送信号来增加计数器。

只要相机在所选信号源上检测到信号，计时器就会增加，直至达到定义的最大值。

重置计数器#

您可以随时将计数器重置为 0。

如果计数器已达到最大值（由 CounterDuration 参数值定义），并且您想重复使用它，则必须将其重置。

通过软件重置#

要通过软件重置计数器，请执行 CounterReset 命令。

您也可以将软件信号设置为重置源（请参见下文）。

使用重置源重置#

CounterResetSource 参数允许您指定由哪个源重置计数器。

要使用重置源重置计数器，请执行以下操作：

1. 将 CounterSelector 参数设置为所需的计数器，例如 Counter2。
2. 将 CounterResetSource 参数设置为要用于重置计数器的源，例如 Line2。
3. 如果适用，请设置 CounterResetActivation 参数设置为以下值：
   • RisingEdge（默认值）：当信号上升时，即信号状态从低变高时，计数器重置。
   • FallingEdge：当信号下降时，即信号状态从高变低时，计数器重置。
   • AnyEdge：当信号下降或上升时，计数器重置。
4. 通过在选定的计数器重置源上发送信号来重置计数器。

重置后，计数器的状态变为 CounterTriggerWait，且必须重新启动。

停止计数器#

要停止计数器，请执行以下任一操作：

• 停止在选定的事件源上发送信号。
• 将 CounterEventSource 参数设置为 Off。
• 重置计数器。

获取计数器状态#

要获取计数器的当前状态，请获取 CounterStatus 参数的值。此为只读参数。

可能的值包括：

• CounterTriggerWait：计数器正在等待启动。
• CounterActive：计数器正在等待由选定事件源增加其计数或当前正在计数。
• CounterCompleted：计数器已达到由 CounterDuration 参数定义的最大值。
• CounterIdle：计数器处于空闲状态。每当将 CounterTriggerSource 参数设置为 Off 时，计数器就处于此状态，即无法启动计数器。

Using Counters for Line Scan GigE Cameras#

The Counter and the Data Chunks features, in combination with the trigger settings, can be used to specify which lines belong to a frame and which frames belong to the correct test object. The combination of trigger, counter, and data chunks settings makes it possible to create a coherence between the frames recorded and the corresponding chunk data.
For information about how to use data chunks and counters, see the GigE Line Scan Use Case Descriptions and Diagrams topic.

ace Classic/U/L 相机#

运作原理#

有两个计数器可用：Counter 1 和 Counter 2。

除一种例外情况（见下文）以外，每个计数器都具有以下特征：

• 从 0 开始。
• 对特定类型的事件（即“事件源”）进行计数。例如，它会对所获取的图像数量进行计数。事件源是预设的，无法更改。
• 可以通过检索相关数据块（例如帧 Counter 块）来确定其当前值。
• 其最大值为 4 294 967 295。达到最大值后，计数器将重置为 0，然后继续计数。
• 可以手动重置。
• 每次关闭相机电源后再次打开电源时，它将重置为 0。

例外：在部分相机机型上，Counter 2 可用于控制定序器。该计数器由于其特定用途而具有不同的特征。

获取计数器值#

要确定计数器的当前值，使用 Data Chunks 功能获取相关数据块。

重置计数器#

重置计数器：

将 CounterSelector 参数设置为所需的计数器，例如 Counter2。

将 CounterResetSource 参数设置为软件源 (Software) 或硬件源（例如 Line1）。

根据在步骤 2 中选择的源，执行以下操作：

1. 如果设置了软件源，请执行 CounterReset 命令。
2. 如果设置了硬件信号源，则向相机的任一输入线路施加电信号。

附加参数#

• CounterEventSource 参数允许您获取当前所选计数器的事件源，即确定在哪种情况下增加计数器的数字。
• CounterResetActivation 参数当前不起作用。该参数预设为 RisingEdge。也就是说，如果将计数器配置为硬件重置，则在硬件触发信号上升时，计数器会重置。

详情#

显示所有相机型号

示例代码#

ace 2, boost R, dart M/R, and racer 2 Cameras#

// Select Counter 1
camera.CounterSelector.SetValue(CounterSelector_Counter1);
// Specify that the counter starts when a software signal is sent via channel 1
camera.CounterTriggerSource.SetValue(CounterTriggerSource_SoftwareSignal1);
// Specify that the counter increases whenever a rising signal is detected on Line 1
camera.CounterEventSource.SetValue(CounterEventSource_Line1);
camera.CounterEventActivation.SetValue(CounterEventActivation_RisingEdge);
// Specify that the counter is reset whenever a falling signal is detected on Line 2
camera.CounterResetSource.SetValue(CounterResetSource_Line2);
camera.CounterResetActivation.SetValue(CounterEventActivation_FallingEdge);
// Set the maximum value of the counter to 1000
camera.CounterDuration.SetValue(1000);
// Manually reset the counter
camera.CounterReset.Execute();
// Get the current status of the counter
CounterStatusEnums counterStatus = camera.CounterStatus.GetValue();
// Get the current value of the counter
int64_t i = camera.CounterValue.GetValue();

INodeMap& nodemap = camera.GetNodeMap();
// Select Counter 1
CEnumParameter(nodemap, "CounterSelector").SetValue("Counter1");
// Specify that the counter starts when a software signal is sent via channel 1
CEnumParameter(nodemap, "CounterTriggerSource").SetValue("SoftwareSignal1");
// Specify that the counter increases whenever a rising signal is detected on Line 1
CEnumParameter(nodemap, "CounterEventSource").SetValue("Line1");
CEnumParameter(nodemap, "CounterEventActivation").SetValue("RisingEdge");
// Specify that the counter is reset whenever a falling signal is detected on Line 2
CEnumParameter(nodemap, "CounterResetSource").SetValue("Line2");
CEnumParameter(nodemap, "CounterResetActivation").SetValue("FallingEdge");
// Set the maximum value of the counter to 1000
CIntegerParameter(nodemap, "CounterDuration").SetValue(1000);
// Manually reset the counter
CCommandParameter(nodemap, "CounterReset").Execute();
// Get the current status of the counter
String_t counterStatus = CEnumParameter(nodemap, "CounterStatus").GetValue();
// Get the current value of the counter
int64_t i = CIntegerParameter(nodemap, "CounterValue").GetValue();

// Select Counter 1
camera.Parameters[PLCamera.CounterSelector].SetValue(PLCamera.CounterSelector.Counter1);
// Specify that the counter starts when a software signal is sent via channel 1
camera.Parameters[PLCamera.CounterTriggerSource].SetValue(PLCamera.CounterTriggerSource.SoftwareSignal1);
// Specify that the counter increases whenever a rising signal is detected on Line 1
camera.Parameters[PLCamera.CounterEventSource].SetValue(PLCamera.CounterEventSource.Line1);
camera.Parameters[PLCamera.CounterEventActivation].SetValue(PLCamera.CounterEventActivation.RisingEdge);
// Specify that the counter is reset whenever a falling signal is detected on Line 2
camera.Parameters[PLCamera.CounterResetSource].SetValue(PLCamera.CounterResetSource.Line2);
camera.Parameters[PLCamera.CounterResetActivation].SetValue(PLCamera.CounterEventActivation.FallingEdge);
// Set the maximum value of the counter to 1000
camera.Parameters[PLCamera.CounterDuration].SetValue(1000);
// Manually reset the counter
camera.Parameters[PLCamera.CounterReset].Execute();
// Get the current status of the counter
string counterStatus = camera.Parameters[PLCamera.CounterStatus].GetValue();
// Get the current value of the counter
Int64 i = camera.Parameters[PLCamera.CounterValue].GetValue();

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
size_t len = 0;
char counterStatus_str[64] = {0};
int64_t i = 0;
/* Select Counter 1 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterSelector", "Counter1");
CHECK(errRes);
/* Specify that the counter starts when a software signal is sent via channel 1 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterTriggerSource", "SoftwareSignal1");
CHECK(errRes);
/* Specify that the counter increases whenever a rising signal is detected on Line 1 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterEventSource", "Line1");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "CounterEventActivation", "RisingEdge");
CHECK(errRes);
/* Specify that the counter is reset whenever a falling signal is detected on Line 2 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterResetSource", "Line2");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "CounterResetActivation", "FallingEdge");
CHECK(errRes);
/* Set the maximum value of the counter to 1000 */
errRes = PylonDeviceSetIntegerFeature(hdev, "CounterDuration", 1000);
CHECK(errRes);
/* Manually reset the counter */
errRes = PylonDeviceExecuteCommandFeature(hdev, "CounterReset");
CHECK(errRes);
/* Get the current status of the counter */
len = sizeof(counterStatus_str);
errRes = PylonDeviceFeatureToString(hdev, "CounterStatus", counterStatus_str, &len);
CHECK(errRes);
/* Get the current value of the counter */
errRes = PylonDeviceGetIntegerFeature(hdev, "CounterValue", &i);
CHECK(errRes);

# Select Counter 1
camera.CounterSelector.Value = "Counter1"
# Specify that the counter starts when a software signal is sent via channel 1
camera.CounterTriggerSource.Value = "SoftwareSignal1"
# Specify that the counter increases whenever a rising signal is detected on Line 1
camera.CounterEventSource.Value = "Line1"
camera.CounterEventActivation.Value = "RisingEdge"
# Specify that the counter is reset whenever a falling signal is detected on Line 2
camera.CounterResetSource.Value = "Line2"
camera.CounterResetActivation.Value = "FallingEdge"
# Set the maximum value of the counter to 1000
camera.CounterDuration.Value = 1000
# Manually reset the counter
camera.CounterReset.Execute()
# Get the current status of the counter
counterStatus = camera.CounterStatus.Value
# Get the current value of the counter
i = camera.CounterValue.Value

ace Classic/U/L 相机#

// Reset Counter 1 via software command
camera.CounterSelector.SetValue(CounterSelector_Counter1);
camera.CounterResetSource.SetValue(CounterResetSource_Software);
camera.CounterReset.Execute();
// Get the event source of Counter 1
camera.CounterSelector.SetValue(CounterSelector_Counter1);
CounterEventSourceEnums e = camera.CounterEventSource.GetValue();

INodeMap& nodemap = camera.GetNodeMap();
// Reset Counter 1 via software command
CEnumParameter(nodemap, "CounterSelector").SetValue("Counter1");
CEnumParameter(nodemap, "CounterResetSource").SetValue("Software");
CCommandParameter(nodemap, "CounterReset").Execute();
// Get the event source of Counter 1
CEnumParameter(nodemap, "CounterSelector").SetValue("Counter1");
String_t e = CEnumParameter(nodemap, "CounterEventSource").GetValue();

// Reset Counter 1 via software command
camera.Parameters[PLCamera.CounterSelector].SetValue(PLCamera.CounterSelector.Counter1);
camera.Parameters[PLCamera.CounterResetSource].SetValue(PLCamera.CounterResetSource.Software);
camera.Parameters[PLCamera.CounterReset].Execute();
// Get the event source of Counter 1
camera.Parameters[PLCamera.CounterSelector].SetValue(PLCamera.CounterSelector.Counter1);
string e = camera.Parameters[PLCamera.CounterEventSource].GetValue();

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
size_t len = 0;
char e_str[64] = {0};
/* Reset Counter 1 via software command */
errRes = PylonDeviceFeatureFromString(hdev, "CounterSelector", "Counter1");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "CounterResetSource", "Software");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "CounterReset");
CHECK(errRes);
/* Get the event source of Counter 1 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterSelector", "Counter1");
CHECK(errRes);
len = sizeof(e_str);
errRes = PylonDeviceFeatureToString(hdev, "CounterEventSource", e_str, &len);
CHECK(errRes);

# Reset Counter 1 via software command
camera.CounterSelector.Value = "Counter1"
camera.CounterResetSource.Value = "Software"
camera.CounterReset.Execute()
# Get the event source of Counter 1
camera.CounterSelector.Value = "Counter1"
e = camera.CounterEventSource.Value

您也可以使用 pylon Viewer 轻松设置参数。