Event Notification#

Event Notificationカメラ機能を使用すると、カメライベントおよびイベントメッセージを有効にできます。

機能を使用する#

Event Notificationの有効化#

1. パラメーターを EventSelector 次のいずれかの値（使用している場合）に設定します：
   • ActionLate
   • CriticalTemperature
   • EventOverrun または Overrun
   • ExposureEnd
   • FrameBufferOverrun
   • FrameBurstStart
   • FrameBurstStartOvertrigger
   • FrameBurstStartWait
   • FrameStart
   • FrameStartOvertrigger
   • FrameStartWait
   • FrameTriggerMissed
   • OverTemperature
   • TemperatureStatusChanged
   • Test
2. パラメーターを EventNotification parameter to On.
3. 有効にするすべてのタイプのイベント通知に対して、手順1と2を繰り返します。
4. アプリケーションにイベント処理を実装：
   • C++のサンプル実装については、「pylon APIドキュメント」のGrab_CameraEvents (C++)コードサンプルを参照してください。
   • CおよびC .NETのサンプル実装については、「pylon APIドキュメント」のEvents Sample (C)およびGrab Using Events for USB or GigE Camera (.NET)コードサンプルを参照してください。

使用可能なイベント#

Action Late Event#

利用可能な場合、カメラが過去のタイムスタンプ付きのスケジュールされたアクションコマンドを受信すると、Action Lateイベントが発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Critical Temperature Event#

利用可能な場合、カメラの温度状態が危険レベルに達したときに、Critical Temperatureイベントが発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Event Overrun Event#

使用可能な場合、カメラの内部イベントキューがオーバーランしたときに、Event Overrunイベント（Overrunイベントとも呼ばれます）が発生します。これは、イベントが非常に高い頻度で生成され、イベントを送信するのに十分な帯域幅を確保できない場合に発生します。

Event Overrunイベントは、イベントがドロップされていることを示す警告です。通知には、ドロップされたイベントの数やイベントの種類に関する具体的な情報は含まれません。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Exposure End Event#

Exposure Endイベントは、画像が露光されるたびに発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。また、露光された画像の番号を示すフレームIDも含まれます。

Frame Buffer Overrun Event#

使用可能な場合、カメラの内部フレームバッファーがすでに一杯であるためにフレームがスキップされるたびに、Frame Buffer Overrunイベントが発生します。

ホストコントローラーが収集された画像を時間内に取得しない場合、カメラは内部フレームバッファーに画像をバッファリングします。内部フレームバッファーが一杯になると、カメラは新しく取得したセンサーデータをスキップし始めます。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Frame Burst Start (= Acquisition Start) Event#

使用可能な場合、Frame Burst Startトリガーがカメラによって生成されるか（フリーラン）、外部的に適用されたとき（トリガーされた画像収集）に、Frame Burst Startイベントが発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Frame Burst Start Overtrigger (= Acquisition Start Overtrigger) Event#

使用可能な場合、Frame Burst Startトリガーがオーバートリガーされると、Frame Burst Start Overtriggerイベントが発生します。これは、カメラが信号を受信する準備ができていないときにFrame Burst Startトリガー信号を適用した場合に発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Frame Burst Start Wait (= Acquisition Start Wait) Event#

使用可能な場合、カメラがFrame Burst Startトリガー信号を受信する準備が整ったときにFrame Burst Start Waitイベントが発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Frame Start Event#

Frame Startイベントは、カメラによってFrame Startトリガーが生成された場合（フリーラン）、または外部に適用された場合（トリガー画像取得）に発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。Basler ace 2カメラでは、露光された画像の番号を示すフレームIDも含まれます。

Frame Start Overtrigger Event#

使用可能な場合、Frame Startトリガーがオーバートリガーされると、Frame Start Overtriggerイベントが発生します。これは、カメラが信号を受信する準備ができていないときにFrame Startトリガー信号を適用した場合に発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Frame Start Wait Event#

使用可能な場合、カメラがFrame Startトリガー信号を受信する準備が整ったときに、Frame Start Waitイベントが発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Frame Trigger Missed Event#

このイベントは、名前が異なるだけで、Frame Start Overtriggerイベントと同じものです。

Over Temperature Event#

利用可能な場合、カメラの温度状態が過温レベルに達したときに、Over Temperatureイベントが発生します。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

Temperature Status Changed Event#

使用可能な場合、カメラの温度状態が変化すると、Temperature Status Changedイベントが発生します。

When this event occurs, the corresponding message contains the EventTemperatureStatusChangedStatus parameter. This parameter indicates the new temperature status that applies after the event was raised:

• Ok：温度ステータスがOkに変わりました。
• Critical：温度ステータスがCriticalに変わりました。
• Error：温度ステータスがErrorに変わりました。

また、このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

イベントのテスト#

使用可能な場合は、イベントのテストを使用してEvent Notification機能をテストできます。

このイベントが発生すると、対応するメッセージには、イベントが生成された時刻を示すタイムスタンプが含まれます。

イベント通知をテストするには：

1. Execute the TestEventGenerate command.
2. アプリケーションでイベントのTestを処理します。

特性#

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

サンプルコード#

// Enable the Exposure End event notification
camera.EventSelector.SetValue(EventSelector_ExposureEnd);
camera.EventNotification.SetValue(EventNotification_On);
// Enable the Critical Temperature event notification
camera.EventSelector.SetValue(EventSelector_CriticalTemperature);
camera.EventNotification.SetValue(EventNotification_On);
// Now, you must implement event handling in your application.
// For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and
// "Events" code samples in the pylon API Documentation

INodeMap& nodemap = camera.GetNodeMap();
// Enable the Exposure End event notification
CEnumParameter(nodemap, "EventSelector").SetValue("ExposureEnd");
CEnumParameter(nodemap, "EventNotification").SetValue("On");
// Enable the Critical Temperature event notification
CEnumParameter(nodemap, "EventSelector").SetValue("CriticalTemperature");
CEnumParameter(nodemap, "EventNotification").SetValue("On");
// Now, you must implement event handling in your application.
// For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and
// "Events" code samples in the pylon API Documentation

// Enable the Exposure End event notification
camera.Parameters[PLCamera.EventSelector].SetValue(PLCamera.EventSelector.ExposureEnd);
camera.Parameters[PLCamera.EventNotification].SetValue(PLCamera.EventNotification.On);
// Enable the Critical Temperature event notification
camera.Parameters[PLCamera.EventSelector].SetValue(PLCamera.EventSelector.CriticalTemperature);
camera.Parameters[PLCamera.EventNotification].SetValue(PLCamera.EventNotification.On);
// Now, you must implement event handling in your application.
// For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and
// "Events" code samples in the pylon API Documentation

/* 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 */
/* Enable the Exposure End event notification */
errRes = PylonDeviceFeatureFromString(hdev, "EventSelector", "ExposureEnd");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "EventNotification", "On");
CHECK(errRes);
/* Enable the Critical Temperature event notification */
errRes = PylonDeviceFeatureFromString(hdev, "EventSelector", "CriticalTemperature");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "EventNotification", "On");
CHECK(errRes);
/* Now, you must implement event handling in your application. */
/* For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and */
/* "Events" code samples in the pylon API Documentation */

# Enable the Exposure End event notification
camera.EventSelector.Value = "ExposureEnd"
camera.EventNotification.Value = "On"
# Enable the Critical Temperature event notification
camera.EventSelector.Value = "CriticalTemperature"
camera.EventNotification.Value = "On"
# Now, you must implement event handling in your application.
# For C++, C, and .NET sample implementations, see the "Grab_CameraEvents" and
# "Events" code samples in the pylon API Documentation

pylon Viewerを使用して、パラメーターを簡単に設定することもできます。