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

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

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

Getting the Value of a Counter#

カウンターの現在の値を判別するには、CounterValueパラメーターの値を取得します。このパラメーターは読み取り専用です。

Starting a Counter#

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

1. CounterSelectorパラメーターを目的のカウンターに設定します（例：Counter2）。
2. CounterTriggerSourceパラメーターを、カウンターの開始に使用するソース（Line2など）に設定します。
3. If applicable, set the CounterTriggerActivation パラメーターを次のいずれかの値に設定します。
   • RisingEdge（デフォルト）：信号が上昇したとき（信号ステータスが低から高に変化したとき）にカウンターが開始されます。
   • FallingEdge：信号が下降したとき（信号ステータスが高から低に変化したとき）にカウンターが開始されます。
   • AnyEdge：信号が下降または上昇するとカウンターが開始されます。
   • LevelHigh：信号が高になるとカウンターが開始します。信号が低に変わると、カウンターのステータスはCounterTriggerWaitに設定されるため、再度開始する必要があります。
   • LevelLow：信号が低になるとカウンターが開始されます。信号が高に変化すると、カウンターのステータスはCounterTriggerWaitに設定されるため、再度開始する必要があります。
4. 選択したカウンタートリガーソースで信号を送信してカウンターを開始します。

開始すると、カウンターのステータスがCounterTriggerWaitからCounterActiveに変わります。

Increasing a Counter#

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

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

1. CounterSelectorパラメーターを目的のカウンターに設定します（例：Counter2）。
2. CounterEventSourceパラメーターを、カウンターを増やすのに使用するソース（Line2など）に設定します。
3. If applicable, set the CounterEventActivation パラメーターを次のいずれかの値に設定します。
   • RisingEdge（デフォルト）：信号が上昇したとき（信号ステータスが低から高に変化したとき）にカウンターはカウントします。
   • FallingEdge：信号が下降したとき（信号ステータスが高から低に変化したとき）にカウンターはカウントします。
   • AnyEdge：信号が下降または上昇するとカウンターはカウントします。
4. CounterDurationパラメーターを目的の最大値に設定します。
5. 選択したカウンターイベントソースで信号を送信してカウンターを増やします。

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

Resetting a Counter#

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

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

Reset by Software#

ソフトウェアによってカウンターをリセットするには、CounterResetコマンドを実行します。

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

Reset Using a Reset Source#

CounterResetSourceパラメーターを使用すると、カウンターをリセットするソースを指定できます。

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

1. CounterSelectorパラメーターを目的のカウンターに設定します（例：Counter2）。
2. CounterResetSourceパラメーターを、カウンターのリセットに使用するソース（Line2など）に設定します。
3. If applicable, set the CounterResetActivation パラメーターを次のいずれかの値に設定します。
   • RisingEdge（デフォルト）：信号が上昇したとき（信号ステータスが低から高に変化したとき）にカウンターがリセットされます。
   • FallingEdge：信号が下降したとき（信号ステータスが高から低に変化したとき）にカウンターがリセットされます。
   • AnyEdge：信号が下降または上昇するとカウンターがリセットされます。
4. 選択したカウンターリセットソースで信号を送信してカウンターをリセットします。

リセットすると、カウンターのステータスがCounterTriggerWaitに変わるので、再度開始する必要があります。

Stopping a Counter#

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

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

Getting the Status of a Counter#

カウンターの現在のステータスを取得するには、CounterStatusパラメーターの値を取得します。このパラメーターは読み取り専用です。

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

• CounterTriggerWait：カウンターは開始を待機しています。
• CounterActive：カウンターは、選択したイベントソースによって増加するのを待っているか、現在カウント中です。
• CounterCompleted：カウンターはCounterDurationパラメーターで定義された最大値に達しました。
• CounterIDLE：カウンターはアイドル状態です。CounterTriggerSourceパラメーターがOffに設定されている場合（つまり、カウンターを開始できない場合）、カウンターはこの状態になります。

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

仕組み#

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パラメーターを目的のカウンターに設定します（例：Counter2）。

CounterResetSourceパラメーターをソフトウェアソース（Software）またはハードウェアソース（Line1など）に設定します。

手順2で選択したソースに応じて、次のいずれかの操作を行います。

1. ソフトウェアソースを設定した場合は、CounterResetコマンドを実行します。
2. ハードウェアソースを設定した場合は、カメラのいずれかの入力ラインに電気信号を適用します。

追加パラメーター#

• CounterEventSourceパラメーターを使用すると、現在選択されているカウンターのイベントソースを取得できます。つまり、カウンターが増加するケースを決判別できます。
• CounterResetActivationパラメーターは現在機能していません。これは、RisingEdgeにプリセットされています。つまり、カウンターがハードウェアリセット用に設定されている場合、ハードウェアトリガー信号が上昇するとカウンターがリセットされます。

特性#

すべてのカメラモデルを表示します

サンプルコード#

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を使用して、パラメーターを簡単に設定することもできます。