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 four counters are available: Counter 1, Counter 2, Counter 3, and Counter 4.

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

• 从 0 开始。
• 必须先启动才能计数。
• 一旦启动，就可以对特定类型的事件（即“事件源”）进行计数。例如，它可以对已曝光的图像数量进行计数。
• 可以随时重置为 0。
• Its current value can be determined by getting the value of the CounterValue parameter.
• Its maximum value is defined by the CounterDuration parameter value (default: 4 294 967 295). After reaching the maximum value, the counter stops counting and must be 重置.
• Its current status can be determined by getting the value of the CounterStatus parameter.
• 每次关闭相机电源后再次打开电源时，它将重置为 0。

获取计数器值#

To determine the current value of a counter, get the value of the CounterValue parameter. This parameter is read-only.

启动计数器#

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

1. 设置 CounterSelector parameter to the desired counter, e.g., Counter2.
2. 设置 CounterTriggerSource parameter to the source that you want to use to start the counter, e.g., Line2.
3. 如果适用，请设置 CounterTriggerActivation 参数设置为以下值：
   • RisingEdge (default): The counter starts when the signal rises, i.e., when the signal status changes from low to high.
   • FallingEdge: The counter starts when the signal falls, i.e., when the signal status changes from high to low.
   • AnyEdge: The counter starts when the signal falls or rises.
   • LevelHigh: The counter starts when the signal is high. When the signal changes to low, the counter status is set to CounterTriggerWait and must be started again.
   • LevelLow: The counter starts when the signal is low. When the signal changes to high, the counter status is set to CounterTriggerWait and must be started again.
4. 通过在选定的计数器触发源上发送信号来启动计数器。

When started, the counter's status changes from CounterTriggerWait to CounterActive.

增加计数器计数#

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

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

1. 设置 CounterSelector parameter to the desired counter, e.g., Counter2.
2. 设置 CounterEventSource parameter to the source that you want to use to increase the counter, e.g., Line2.
3. 如果适用，请设置 CounterEventActivation 参数设置为以下值：
   • RisingEdge (default): The counter counts when the signal rises, i.e., when the signal status changes from low to high.
   • FallingEdge: The counter counts when the signal falls, i.e., when the signal status changes from high to low.
   • AnyEdge: The counter counts when the signal falls or rises.
4. 设置 CounterDuration parameter to the desired maximum value.
5. 通过在选定的计数器事件源上发送信号来增加计数器。

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

重置计数器#

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

You must reset the counter if it has reached its maximum value (defined by the CounterDuration parameter value) and you want to reuse it.

通过软件重置#

To reset a counter by software, execute the CounterReset command.

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

使用重置源重置#

即： CounterResetSource parameter allows you to specify which source resets the counter.

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

1. 设置 CounterSelector parameter to the desired counter, e.g., Counter2.
2. 设置 CounterResetSource parameter to the source that you want to use to reset the counter, e.g., Line2.
3. 如果适用，请设置 CounterResetActivation 参数设置为以下值：
   • RisingEdge (default): The counter resets when the signal rises, i.e., when the signal status changes from low to high.
   • FallingEdge: The counter resets when the signal falls, i.e., when the signal status changes from high to low.
   • AnyEdge: The counter resets when the signal falls or rises.
4. 通过在选定的计数器重置源上发送信号来重置计数器。

When reset, the counter's status changes to CounterTriggerWait and must be started again.

停止计数器#

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

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

获取计数器状态#

To get the current status of a counter, get the value of the CounterStatus parameter. This parameter is read-only.

可能的值包括：

• CounterTriggerWait: The counter is waiting to be started.
• CounterActive: The counter is waiting to be increased by the selected event source or is currently counting.
• CounterCompleted: The counter has reached its maximum value defined by the CounterDuration parameter.
• CounterIdle: The counter is idle. A counter is in this state whenever the CounterTriggerSource parameter is set to Off, i.e., the counter can't be started.

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 parameter to the desired counter, e.g., Counter2.

设置 CounterResetSource parameter to a software source (Software) or to a hardware source (e.g., Line1).

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

1. If you set a software source, execute the CounterReset command.
2. 如果设置了硬件信号源，则向相机的任一输入线路施加电信号。

附加参数#

• 即： CounterEventSource parameter allows you to get the event source of the currently selected counter, i.e., determine in which case the counter increases.
• 即： CounterResetActivation parameter currently serves no function. It is preset to RisingEdge. This means that if the counter is configured for hardware reset, the counter resets when the hardware trigger signal rises.

详情#

显示所有相机型号

示例代码#

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 轻松设置参数。