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。

每個 Counter 都具備下列特性：

• 它從 0 開始。
• 必須先啟動它，然後才能開始計數。
• 一旦啟動，它就可以計算特定類型的事件（即「event source」）。例如，它可以計算已曝光的影像數量。
• 隨時都可以將其重設為 0。
• 可以透過取得下列項目的值來判定其目前的值： CounterValue 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。
• 其最大值是由下列項目所定義： CounterDuration 參數值（預設值：4 294 967 295）。達到最大值後，Counter 會停止計數，且必須被 重設.
• 可以透過取得下列項目的值來判定其目前的狀態： CounterStatus 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。
• 只要將相機關閉電源然後重新開啟，它就會重設為 0。

取得 Counter 的值#

若要判定 Counter 的目前值，請取得下列項目的值： CounterValue 參數。此參數為唯讀。

啟動 Counter#

若要啟動 Counter：

1. 將相機中的 CounterSelector 參數設為所需的 Counter，例如： Counter2.
2. 將相機中的 CounterTriggerSource 參數設為您要用來啟動 Counter 的來源，例如： Line2.
3. 如果適用，請設定 CounterTriggerActivation 參數設定為以下值之一：
   • RisingEdge （預設值）：當訊號發生時，Counter 即會啟動 上升時 Timer 即會啟動，亦即信號狀態從低電位變為高電位時。
   • FallingEdge：當訊號發生時，Counter 即會啟動 下降時 Timer 即會啟動，亦即信號狀態從高電位變為低電位時。
   • AnyEdge：當訊號發生時，Counter 即會啟動 下降或上升.
   • LevelHigh：當訊號為以下狀態時，Counter 即會啟動 高。當訊號變更為低電位時，Counter status 設為 CounterTriggerWait 且必須 啟動 。
   • LevelLow：當訊號為以下狀態時，Counter 即會啟動 低。當訊號變更為高電位時，Counter status 設為 CounterTriggerWait 且必須 啟動 。
4. 透過在選定的 Trigger Source 上發送訊號來啟動 Counter。

啟動時，Counter 的 status 從 CounterTriggerWait 設為 CounterActive.

增加 Counter#

一旦 Counter 啟動後，它就可以遞增，亦即它可以進行計數。

若要增加 Counter：

1. 將相機中的 CounterSelector 參數設為所需的 Counter，例如： Counter2.
2. 將相機中的 CounterEventSource 參數設為您要用來增加 Counter 的來源，例如： Line2.
3. 如果適用，請設定 CounterEventActivation 參數設定為以下值之一：
   • RisingEdge （預設）：當信號為 上升時 Timer 即會啟動，亦即信號狀態從低電位變為高電位時。
   • FallingEdge：當信號為 下降時 Timer 即會啟動，亦即信號狀態從高電位變為低電位時。
   • AnyEdge：當信號為 下降或上升.
4. 將相機中的 CounterDuration 參數設為所需的最大值。
5. 透過在選定的 Counter event source 上發送信號來增加 Counter。

每當相機在選定的來源上偵測到信號時，Timer 就會增加，直到達到定義的最大值為止。

重設 Counter#

您可以隨時將 Counter 重設為 0。

如果 Counter 已達到其最大值（由 CounterDuration 參數值定義）且您想要重複使用它，則必須將其重設。

透過軟體重設#

若要透過軟體重設 Counter，請執行 CounterReset 指令。

或者，您可以將軟體信號設為重設來源（請參見下文）。

使用重設來源重設#

當 CounterResetSource 參數允許您指定哪個來源會重設 Counter。

若要使用重設來源重設 Counter：

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

重設時，Counter 的 status 變更為 CounterTriggerWait 且必須 啟動 。

停止 Counter#

若要停止 Counter，請執行以下任一操作：

• 停止在選定的 event source 上傳送訊號。
• 將相機中的 CounterEventSource 參數設為 Off.
• 重設 Counter。

取得 Counter 的狀態#

若要取得 Counter 的目前狀態，請取得以下項目的值： CounterStatus 參數。此參數為唯讀。

可能的數值包括：

• CounterTriggerWait：Counter 正在等待 啟動.
• CounterActive：Counter 正在等待選定的 event source 使其遞增，或者目前正在計數。
• CounterCompleted：Counter 已達到所定義的最大值，該值由 CounterDuration 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。
• CounterIdle：Counter 處於閒置狀態。只要 CounterTriggerSource 參數設為 Off，亦即無法啟動 Counter 時，Counter 就會處於此狀態。

針對線掃描 GigE 相機使用 Counter#

Counter 與 Data Chunks 功能結合觸發設定，可用於指定哪些行屬於一個畫框（frame），以及哪些畫框屬於正確的測試物件。透過結合觸發、Counter 與 Data Chunks 設定，能夠建立所錄製畫框與對應 chunk 資料之間的關聯。
如需如何使用 Data Chunks 與 Counter 的資訊，請參閱 GigE Line Scan Use Case Descriptions and Diagrams 主題。

ace Classic/U/L 相機#

運作原理#

提供兩個 Counter：Counter 1 與 Counter 2。

除了一個例外（見下文），每個 Counter 都具有以下特性：

• 它從 0 開始。
• 它會計算特定類型的事件（「event source」）。例如，它會計算所擷取的影像數量。event source 是預設的，無法變更。
• 其目前值可以透過擷取 related data chunk 來決定，例如 Frame Counter chunk。
• 其最大值為 4 294 967 295。達到最大值後，Counter 會重設為 0，然後繼續計數。
• 它可以手動重設。
• 只要將相機關閉電源然後重新開啟，它就會重設為 0。

例外：在某些相機型號上，Counter 2 可用於控制 Sequencer。由於其特定用途，此 Counter 具有不同的特性。

取得 Counter 的值#

若要決定 Counter 的目前值，請使用 Data Chunks 功能擷取 related data chunk。

重設 Counter#

若要重設 Counter：

將相機中的 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

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