Counter#

Counterカメラ機能を使用すると、取得した画像の数など、特定のカメライベントをカウントできます。

機能を使用する#

The implementation of this feature varies by camera series:

• 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にリセットできます。
• Its current value can be determined by getting the value of the CounterValue parameter.
• Its maximum value is defined by the CounterDuration parameter value (default: 4 294 967 295). After reaching the maximum value, the counter stops counting and must be reset.
• Its current status can be determined by getting the value of the CounterStatus parameter.
• カメラの電源をオフにしてから再度オンにするたびに、この値は0にリセットされます。

Getting the Value of a Counter#

To determine the current value of a counter, get the value of the CounterValue parameter. This parameter is read-only.

Starting a Counter#

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

1. パラメーターを CounterSelector parameter to the desired counter, e.g., Counter2.
2. パラメーターを CounterTriggerSource parameter to the source that you want to use to start the counter, e.g., Line2.
3. If applicable, set the CounterTriggerActivation パラメーターを次のいずれかの値に設定します。
   • RisingEdge (default): The counter starts when the signal rises, i.e., when the signal status changes from low to high.
   • FallingEdge: The counter starts when the signal falls, i.e., when the signal status changes from high to low.
   • AnyEdge: The counter starts when the signal falls or rises.
   • LevelHigh: The counter starts when the signal is high. When the signal changes to low, the counter status is set to CounterTriggerWait and must be started again.
   • LevelLow: The counter starts when the signal is low. When the signal changes to high, the counter status is set to CounterTriggerWait and must be started again.
4. 選択したカウンタートリガーソースで信号を送信してカウンターを開始します。

When started, the counter's status changes from CounterTriggerWait to CounterActive.

Increasing a Counter#

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

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

1. パラメーターを CounterSelector parameter to the desired counter, e.g., Counter2.
2. パラメーターを CounterEventSource parameter to the source that you want to use to increase the counter, e.g., Line2.
3. If applicable, set the CounterEventActivation パラメーターを次のいずれかの値に設定します。
   • RisingEdge (default): The counter counts when the signal rises, i.e., when the signal status changes from low to high.
   • FallingEdge: The counter counts when the signal falls, i.e., when the signal status changes from high to low.
   • AnyEdge: The counter counts when the signal falls or rises.
4. パラメーターを CounterDuration parameter to the desired maximum value.
5. 選択したカウンターイベントソースで信号を送信してカウンターを増やします。

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

Resetting a Counter#

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

You must reset the counter if it has reached its maximum value (defined by the CounterDuration parameter value) and you want to reuse it.

Reset by Software#

To reset a counter by software, execute the CounterReset command.

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

Reset Using a Reset Source#

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

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

1. パラメーターを CounterSelector parameter to the desired counter, e.g., 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 rises, i.e., when the signal status changes from low to high.
   • FallingEdge: The counter resets when the signal falls, i.e., when the signal status changes from high to low.
   • AnyEdge: The counter resets when the signal falls or rises.
4. 選択したカウンターリセットソースで信号を送信してカウンターをリセットします。

When reset, the counter's status changes to CounterTriggerWait and must be started again.

Stopping a Counter#

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

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

Getting the Status of a Counter#

To get the current status of a counter, get the value of the CounterStatus parameter. This parameter is read-only.

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

• CounterTriggerWait: The counter is waiting to be started.
• 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 parameter.
• CounterIdle: The counter is idle. A counter is in this state whenever the CounterTriggerSource parameter is set to Off, i.e., the counter can't be started.

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 parameter to the desired counter, e.g., Counter2.

パラメーターを CounterResetSource parameter to a software source (ソフトウェア) or to a hardware source (e.g., Line1).

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

1. If you set a software source, execute the CounterReset command.
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, 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を使用して、パラメーターを簡単に設定することもできます。