Counter#

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

该功能的使用#

此功能具体取决于不同的相机型号：

• ace 2、boost R、dart M/R 和 racer 2 相机
• ace Classic/U/L 相机

ace 2、boost R、dart M/R 和 racer 2 相机#

运作原理#

根据 您的相机型号，最多可提供四个 Counter：Counter 1、Counter 2、Counter 3 和 Counter 4。

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

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

获取计数器值#

要确定 Counter 的当前值，请获取以下参数的值： CounterValue 参数。此参数为只读。

启动计数器#

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

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

启动时，Counter 的 状态 从 CounterTriggerWait 变为 CounterActive.

增加计数器计数#

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

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

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

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

重置计数器#

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

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

通过软件重置#

若要通过软件重置 Counter，请执行 CounterReset 命令。

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

使用重置源重置#

即： CounterResetSource 参数允许您指定哪个源用于重置 Counter。

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

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

重置时，Counter 的 状态 变为 CounterTriggerWait 且必须 重新启动 。

停止计数器#

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

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

获取计数器状态#

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

可能的值包括：

• CounterTriggerWait的值：Counter 正在等待 重新启动.
• CounterActive：Counter 正在等待所选的 事件源将其递增 或者当前正在计数。
• CounterCompleted：Counter 已达到由以下项定义的最大值： CounterDuration 参数。
• CounterIdle：Counter 处于空闲状态。当发生以下情况时，Counter 会处于此状态： CounterTriggerSource 参数设置为 Off，即无法启动 Counter。

在线扫描 GigE 相机中使用 Counter#

结合触发设置，Counter 和 Data Chunks 功能可用于指定哪些行属于一帧，以及哪些帧属于正确的测试对象。通过组合触发、Counter 和 Data Chunks 设置，可以建立所录制帧与相应 chunk 数据之间的连贯性。
有关如何使用 Data Chunks 和 Counter 的信息，请参阅 GigE Line Scan Use Case Descriptions and Diagrams 主题。

ace Classic/U/L 相机#

运作原理#

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

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

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

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

获取计数器值#

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

重置计数器#

重置计数器：

设置 CounterSelector 参数设置为所需的 Counter，例如： Counter2.

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

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

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

附加参数#

• 即： CounterEventSource 参数允许您获取当前所选 Counter 的事件源，即确定 Counter 在哪种情况下递增。
• 即： CounterResetActivation 参数当前不起作用。它预设为 RisingEdge。这意味着如果将 Counter 配置为硬件重置，则当硬件触发信号上升时，Counter 将重置。

详情#

显示所有相机型号

示例代码#

ace 2、boost R、dart M/R 和 racer 2 相机#

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