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の最大4つのCounterを使用できます。

各カウンターには、次の特性があります。

• 0から始まります。
• カウントする前に開始する必要があります。
• 開始すると、特定のタイプのイベント（「イベントソース」）をカウントできます。例えば、露光された画像の数をカウントできます。
• いつでも0にリセットできます。
• 現在の値は、以下のプロパティを取得することで確認できます。 CounterValue パラメータ。
• 最大値は以下の項目で定義されます。 CounterDuration パラメータの値（デフォルト：4 294 967 295）。最大値に達すると、Counterのカウントは停止し、次を行う必要があります。 リセット.
• 現在のステータスは、以下の値を取得することで確認できます。 CounterStatus パラメータ。
• カメラの電源をオフにしてから再度オンにするたびに、この値は0にリセットされます。

Getting the Value of a Counter#

Counterの現在の値を調べるには、次の値を取得します。 CounterValue parameter。このパラメータは読み取り専用です。

Starting a Counter#

カウンターを開始するには次の手順に従います。

1. パラメーターを CounterSelector パラメータを目的のCounterに設定します（例：）。 Counter2.
2. パラメーターを CounterTriggerSource パラメータを、Counterを開始するために使用するソースに設定します（例：）。 Line2.
3. If applicable, set the CounterTriggerActivation パラメーターを次のいずれかの値に設定します。
   • RisingEdge （デフォルト）：信号が次の場合にCounterが開始します。 立ち上がる（つまり、信号ステータスがLowからHighに変化する）ときにトリガーが有効になります。
   • FallingEdge：信号が次の場合にCounterが開始します。 立ち下がる（つまり、信号ステータスがHighからLowに変化する）ときにトリガーが有効になります。
   • AnyEdge：信号が次の場合にCounterが開始します。 立ち下がるまたは立ち上がる.
   • LevelHigh：信号が次の状態になるとCounterが開始します。 High。信号がLowに変化すると、Counterは status が次のように設定されている場合、自動的に無効になります： CounterTriggerWait となり、次の操作が必要です。 開始 する必要があります。
   • LevelLow：信号が次の状態になるとCounterが開始します。 Low。信号がHighに変化すると、Counterは status が次のように設定されている場合、自動的に無効になります： CounterTriggerWait となり、次の操作が必要です。 開始 する必要があります。
4. 選択したカウンタートリガーソースで信号を送信してカウンターを開始します。

開始時、Counterの status が次から変更されます： CounterTriggerWait を CounterActive.

Increasing a Counter#

カウンターが開始されると、カウントを増加させることができます。つまり、カウントできます。

カウンターを増やすには次の手順に従います。

1. パラメーターを CounterSelector パラメータを目的のCounterに設定します（例：）。 Counter2.
2. パラメーターを CounterEventSource パラメータを、Counterを増加させるために使用するソースに設定します（例：）。 Line2.
3. If applicable, set the CounterEventActivation パラメーターを次のいずれかの値に設定します。
   • RisingEdge （デフォルト）：信号が次の場合にCounterがカウントします。 立ち上がる（つまり、信号ステータスがLowからHighに変化する）ときにトリガーが有効になります。
   • FallingEdge：信号が次の場合にCounterがカウントします。 立ち下がる（つまり、信号ステータスがHighからLowに変化する）ときにトリガーが有効になります。
   • AnyEdge：信号が次の場合にCounterがカウントします。 立ち下がるまたは立ち上がる.
4. パラメーターを CounterDuration パラメータを目的の最大値に設定します。
5. 選択したカウンターイベントソースで信号を送信してカウンターを増やします。

選択したソースでカメラが信号を検出すると、タイマーは定義された最大値まで増加します。

Resetting a Counter#

カウンターはいつでも0にリセットできます。

Counterが最大値（以下の値で定義）に達し、再利用する場合は、Counterをリセットする必要があります。 CounterDuration パラメータ値）。

Reset by Software#

ソフトウェアによってCounterをリセットするには、次の操作を実行します。 CounterReset コマンド。

また、ソフトウェア信号をリセットソースとして設定することもできます（以下を参照）。

Reset Using a Reset Source#

イメージ CounterResetSource parameter allows you to specify which source resets the Counter.

リセットソースを使用してカウンターをリセットするには次の手順に従います。

1. パラメーターを CounterSelector パラメータを目的のCounterに設定します（例：）。 Counter2.
2. パラメーターを CounterResetSource parameter to the source that you want to use to reset the Counter, e.g., Line2.
3. If applicable, set the CounterResetActivation パラメーターを次のいずれかの値に設定します。
   • RisingEdge (default): The Counter resets when the signal 立ち上がる（つまり、信号ステータスがLowからHighに変化する）ときにトリガーが有効になります。
   • FallingEdge: The Counter resets when the signal 立ち下がる（つまり、信号ステータスがHighからLowに変化する）ときにトリガーが有効になります。
   • AnyEdge: The Counter resets when the signal 立ち下がるまたは立ち上がる.
4. 選択したカウンターリセットソースで信号を送信してカウンターをリセットします。

When reset, the Counter's status changes to CounterTriggerWait となり、次の操作が必要です。 開始 する必要があります。

Stopping a Counter#

カウンターを停止するには、次のいずれかの操作を行います。

• 選択したイベントソースで信号の送信を停止します。
• パラメーターを CounterEventSource パラメータを Off.
• カウンターをリセットします。

Getting the Status of a Counter#

To get the current status of a Counter, get the value of the CounterStatus parameter。このパラメータは読み取り専用です。

可能な値は次のとおりです。

• CounterTriggerWait: The Counter is waiting to be 開始.
• 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 パラメータ。
• CounterIdle: The Counter is idle. A Counter is in this state whenever the CounterTriggerSource パラメータが次のように設定されていること： Off, i.e., the Counter can't be started.

ラインスキャン GigE カメラでの Counter の使用#

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カメラ#

仕組み#

2つのカウンターを使用できます：Counter 1およびCounter 2

1つの例外（下記参照）を除き、各カウンターには次の特性があります。

• 0から始まります。
• 特定のタイプのイベント（「イベントソース」）をカウントします。例えば、取得された画像の数をカウントします。イベントソースはプリセットされており、変更できません。
• その現在の値は、関連するデータチャンク（例えば、Frame Counterチャンク）を取得することによって判別できます。
• 最大値は4 294 967 295です。最大値に達すると、カウンターは0にリセットされ、カウントが続行されます。
• 手動でリセットできます。
• カメラの電源をオフにしてから再度オンにするたびに、この値は0にリセットされます。

例外：一部のカメラモデルでは、Counter 2は、シーケンサーの制御に使用できます。このカウンターは、その特定の目的のために特性が異なります。

Getting the Value of a Counter#

カウンターの現在の値を判別するには、Data Chunks機能を使用して関連データチャンクを取得します。

Resetting a Counter#

カウンターをリセットするには、次の手順に従います。

パラメーターを CounterSelector パラメータを目的のCounterに設定します（例：）。 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 コマンド。
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、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を使用して、パラメーターを簡単に設定することもできます。