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.

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