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 參數設為 On.
3. 對所有您想要啟用的事件訊息類型重複步驟 1 和 2。
4. 在您的應用程式中實作事件處理：
   • 如需 C++ 範例實作，請參閱 pylon API Documentation 中的 Grab_CameraEvents (C++) 程式碼範例。
   • 如需 C 與 C .NET 範例實作，請參閱 pylon API Documentation 中的 Events Sample (C) 和 Grab Using Events for USB or GigE Camera (.NET) 程式碼範例。

可用事件#

Action Late Event#

如果可用，Action Late 事件會在相機收到帶有過去 Timestamp 的 scheduled action command 時發生。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Critical Temperature Event#

如果可用，Critical Temperature 事件會在相機的 Temperature State 達到臨界水準時發生。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Event Overrun Event#

如果可用，Event Overrun 事件（也稱為 Overrun 事件）會在相機的內部事件佇列溢位時發生。當事件以極高頻率產生且沒有足夠的頻寬來傳送事件時，就會發生這種情況。

Event Overrun 事件是用於警告事件正在被捨棄。通知中未包含關於已捨棄多少或哪些事件的具體資訊。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Exposure End Event#

Exposure End 事件會在影像完成曝光時發生。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。此外，它還包含一個影格 ID，指出已曝光的影像編號。

Frame Buffer Overrun Event#

如果可用，Frame Buffer Overrun 事件會在因相機內部畫面緩衝區已滿而跳過畫面時發生。

如果主機控制器未能在時限內擷取所取得的影像，相機就會將影像緩衝至其內部畫面緩衝區中。當內部畫面緩衝區滿載時，相機將開始跳過新取得的感測器資料。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Frame Burst Start (= Acquisition Start) Event#

如果可用，Frame Burst Start 事件會在相機產生 Frame Burst Start 觸發（free run）或外部施加觸發（triggered image acquisition）時發生。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

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

如果可用，Frame Burst Start Overtrigger event 會在 Frame Burst Start 觸發超發（overtriggered）時發生。如果您在相機尚未準備好接收訊號時施加 Frame Burst Start 觸發訊號，就會發生這種情況。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

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

如果可用，Frame Burst Start Wait event 會在相機準備好接收 Frame Burst Start 觸發訊號時發生。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Frame Start Event#

Frame Start 事件會在相機產生 Frame Start 觸發（free run）或外部施加觸發（triggered image acquisition）時發生。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。在 Basler ace 2 相機上，它還包含一個影格 ID，指出已曝光的影像編號。

Frame Start Overtrigger Event#

如果可用，Frame Start Overtrigger event 會在 Frame Start 觸發超發（overtriggered）時發生。如果您在相機尚未準備好接收訊號時施加 Frame Start 觸發訊號，就會發生這種情況。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Frame Start Wait Event#

若可用，每當相機準備好接收 Frame Start 觸發訊號時，就會發生 Frame Start Wait 事件。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Frame Trigger Missed Event#

此事件與 Frame Start Overtrigger 事件相同，僅名稱不同。

Line Trigger Missed Event#

若可用，每當您在相機尚未準備好接收訊號時發送行觸發訊號，就會發生 Line Trigger Missed 事件。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Line Timout Event#

如果適用上， Line Timeout 每當由 BslLinetimeout 參數所決定的時間已過，且未收到新的行觸發時，就會發生事件。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Over Temperature Event#

若可用，如果相機的 temperature state 已達到過溫水準，就會發生 Over Temperature 事件。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

Temperature Status Changed Event#

若可用，每當相機的 temperature state 改變時，就會發生 Temperature Status Changed 事件。

當此事件發生時，對應的訊息會包含 EventTemperatureStatusChangedStatus 參數。此參數表示事件引發後適用的新溫度狀態：

• Ok：溫度狀態變更為 Ok。
• Critical：溫度狀態變更為 Critical。
• Error：溫度狀態變更為 Error。

此外，對應的訊息也會包含一個 timestamp，用以指出產生事件的時間。

Test Event#

若可用，Test 事件可讓您測試 Event Notification 功能。

當此事件發生時，對應的訊息會包含一個 Timestamp，指出產生事件的時間。

若要測試事件通知：

1. 執行 TestEventGenerate 命令。
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 來輕鬆設定參數。