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 1、Counter 2、Counter 3 以及Counter 4。

每個計數器皆具備以下特徵：

• 起始值為 0。
• 必須先啟動它，才能開始計數。
• 一旦啟動，它便能統計特定類型的事件（即「事件來源」）。例如，它可以統計曝光過的影像數量。
• 隨時都可以將其重設為 0。
• 其當前值可透過取得 CounterValue 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。
• 其最大值由 CounterDuration 參數值（預設值：4 294 967 295）。達到最大值後，計數器將停止計數，並必須 重設.
• 可透過取得 CounterStatus 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。
• 每當相機關機後再次開機時，該數值便會重設為 0。

取得一個Counter#

若要取得計數器的當前值，請取得 CounterValue 參數。此參數為唯讀。

開始一個Counter#

要啟動計數器：

1. 將相機中的 CounterSelector 將參數設定為所需的計數器，例如： Counter2.
2. 將相機中的 CounterTriggerSource 要作為計數器起始值的來源參數，例如： Line2.
3. 如果適用，請設定 CounterTriggerActivation 參數設定為以下值之一：
   • RisingEdge (預設)：計數器在訊號出現時開始計數 上升時 Timer 即會啟動，亦即信號狀態從低電位變為高電位時。
   • FallingEdge: 計數器會在接收到訊號時開始運作 下降時 Timer 即會啟動，亦即信號狀態從高電位變為低電位時。
   • AnyEdge: 計數器會在接收到訊號時開始運作 下降或上升.
   • LevelHigh: 計數器會在接收到訊號時開始運作 高. 當訊號轉為低電平時，計數器 status 設為 CounterTriggerWait 並且必須是 啟動 。
   • LevelLow: 計數器會在接收到訊號時開始運作 低. 當訊號轉為高電平時，計數器 status 設為 CounterTriggerWait 並且必須是 啟動 。
4. 透過在選定的計數器觸發源上傳送訊號，來啟動計數器。

啟動時，計數器的 status 與以下內容相比的變更： CounterTriggerWait 設為 CounterActive.

增加一個Counter#

計數器一旦啟動，即可進行遞增，也就是說，它可以開始計數。

要增加計數器的數值：

1. 將相機中的 CounterSelector 將參數設定為所需的計數器，例如： Counter2.
2. 將相機中的 CounterEventSource 要設定為計數器增量來源的參數，例如： Line2.
3. 如果適用，請設定 CounterEventActivation 參數設定為以下值之一：
   • RisingEdge (預設)：當訊號出現時，計數器會開始計數 上升時 Timer 即會啟動，亦即信號狀態從低電位變為高電位時。
   • FallingEdge: 當訊號出現時，計數器便開始計數 下降時 Timer 即會啟動，亦即信號狀態從高電位變為低電位時。
   • AnyEdge: 當訊號出現時，計數器便開始計數 下降或上升.
4. 將相機中的 CounterDuration 將該參數設定為所需的最大值。
5. 透過在選定的計數器事件來源上傳送訊號，來增加計數器的數值。

每當攝影機偵測到選定訊源上的訊號時，計時器便會增加，直至達到預設的最大值為止。

重設一個Counter#

您可以隨時將計數器重設為 0。

如果計數器已達到其最大值（由 CounterDuration （參數值），且您希望重複使用它。

透過軟體重設#

若要透過軟體重置計數器，請執行 CounterReset 指令。

此外，您也可以將軟體訊號設定為重置來源（請參閱下文）。

使用重設來源進行重設#

當 CounterResetSource 此參數可讓您指定由哪個來源重置計數器。

若要使用重置來源重置計數器：

1. 將相機中的 CounterSelector 將參數設定為所需的計數器，例如： Counter2.
2. 將相機中的 CounterResetSource 要設定為重置計數器的來源參數，例如： Line2.
3. 如果適用，請設定 CounterResetActivation 參數設定為以下值之一：
   • RisingEdge (預設)：當訊號 上升時 Timer 即會啟動，亦即信號狀態從低電位變為高電位時。
   • FallingEdge: 當訊號出現時，計數器會重置 下降時 Timer 即會啟動，亦即信號狀態從高電位變為低電位時。
   • AnyEdge: 當訊號出現時，計數器會重置 下降或上升.
4. 透過在選定的計數器重置來源上發送訊號，來重置計數器。

重置後，計數器的 status 變更為 CounterTriggerWait 並且必須是 啟動 。

阻止一個Counter#

若要停止計數器，請執行以下任一操作：

• 停止在所選的事件來源上發送訊號。
• 將相機中的 CounterEventSource 參數設為 Off.
• 重置計數器。

查詢某個的狀態Counter#

若要取得計數器的當前狀態，請取得 CounterStatus 參數。此參數為唯讀。

可能的數值包括：

• CounterTriggerWait: 計數器正在等待被 啟動.
• CounterActive: 計數器正等待被選定的數值增加 事件來源 或是目前正在計數中。
• CounterCompleted: 計數器已達到由 CounterDuration 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。
• CounterIdle: 計數器處於閒置狀態。每當 CounterTriggerSource 參數設為 Off，也就是說，無法啟動計數器。

線掃描 GigE 攝影機的計數器應用#

Counter 以及 Data Chunks 功能，結合觸發器設定，可用於指定哪些資料行屬於某個幀，以及哪些幀屬於正確的測試對象。透過觸發器、計數器與資料塊設定的組合，可使記錄的幀與對應的資料塊之間建立一致性。
有關如何使用資料塊與計數器的資訊，請參閱「GigE 線掃描用例說明與圖解」主題。

ace Classic/U/L 相機#

運作原理#

目前有兩個計數器可用：Counter 1 和Counter 2。

除了一項例外（詳見下文）外，每個計數器都具有以下特徵：

• 起始值為 0。
• 它會統計特定類型的事件（即「事件來源」）。例如，它會統計所擷取的影像數量。事件來源是預設的，無法變更。
• 其當前值可透過擷取相關資料區塊來確定，例如 FrameCounter 區塊。
• 其最大值為 4 294 967 295。達到最大值後，計數器會重置為 0，然後繼續計數。
• 可以手動重設。
• 每當相機關機後再次開機時，該數值便會重設為 0。

例外： 在某些相機型號上，可使用Counter 2來控制序列器。由於其特定用途，此計數器的特性有所不同。

取得一個Counter#

若要取得計數器的當前值，請使用 Data Chunks 功能來擷取相關的資料區塊。

重設一個Counter#

要重設計數器：

將相機中的 CounterSelector 將參數設定為所需的計數器，例如： Counter2.

將相機中的 CounterResetSource 將參數傳遞至軟體來源（Software) 或某個硬體來源（例如， Line1)。

根據步驟 2 中選取的來源，請執行以下其中一項操作：

1. 若您設定了軟體來源，請執行 CounterReset 指令。
2. 若您設定了硬體訊源，請向攝影機的其中一條輸入線路施加電訊號。

其他參數#

• 當 CounterEventSource 此參數可讓您取得目前所選計數器的事件來源，也就是說，可確定在何種情況下計數器會增加。
• 當 CounterResetActivation 此參數目前沒有任何功能。其預設值為 RisingEdge. 這表示，若計數器已設定為硬體重置，則當硬體觸發訊號上升時，計數器便會重置。

詳細資料#

顯示所有相機型號

範例程式碼#

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

您也可以 use the pylon Viewer 來輕鬆設定參數。