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. 針對您要啟用的所有類型的 event notification 重複步驟 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 事件會在 Frame Burst Start 觸發過度觸發時發生。如果您在相機尚未準備好接收訊號時套用 Frame Burst Start 觸發訊號，就會發生這種情況。

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

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

若適用，Frame Burst Start Wait 事件會在相機準備好接收 Frame Burst Start 觸發訊號時發生。

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

Frame Start Event#

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

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

Frame Start Overtrigger Event#

若適用，只要 Frame Start 觸發遭到過度觸發（overtriggered），就會發生 Frame Start Overtrigger 事件。如果您在相機尚未準備好接收訊號時套用 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

您也可以 use the pylon Viewer 來輕鬆設定參數。