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 文档中的“事件示例 (C)”和“使用 USB 或 GigE 相机事件采集 (.NET)”代码示例。

可用事件#

操作延迟事件#

在可用的情况下，如果相机过去接收到带有时间戳的计划操作命令，就会发生动作延迟事件。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

临界温度事件#

在可用的情况下，如果相机的温度状态达到临界水平，就会发生临界温度事件。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

“事件超限”事件#

在可用的情况下，如果相机的内部事件队列已溢出，则会发生“事件溢出”事件（也称为“溢出事件”）。如果事件以很高的频率生成，并且没有足够的带宽来发送事件，就会发生这种情况。

事件超限事件是对事件正被删除的警告。该通知不包含有关删除了多少个事件或哪些事件的特定信息。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

曝光结束事件#

每当曝光图像时，都会发生曝光结束事件。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。而且，它包含指示已曝光图像数量的帧 ID。

帧缓冲区溢出事件#

在可用的情况下，每当由于相机内部帧缓冲区已满而跳过帧时，便会发生帧缓冲区溢出事件。

如果主机控制器未及时检索所获取的图像，则相机会将图像缓存在其内部帧缓冲区中。当内部帧缓冲区已满时，相机将开始跳过新获取的传感器数据。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

帧高速连拍开始（= 采集开始）事件#

在可用的情况下，每当帧连拍开始触发信号由相机生成时（自由运行）或在外部应用时（触发图像采集）时，便会发生帧连拍开始事件。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

帧高速连拍过度触发（= 采集开始过度触发）事件#

在可用的情况下，则每当帧连拍开始触发信号被过度触发时，就会发生帧连拍开始过度触发事件。如果在相机尚未准备好接收信号时应用帧连拍开始触发信号，便会发生这种情况。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

帧高速连拍开始等待（= 采集开始等待）事件#

在可用的情况下，每当相机准备好接收帧连拍开始触发信号时，便会发生帧连拍开始等待事件。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

帧开始事件#

每当相机生成（自由运行）或从外部应用帧开始触发（触发图像采集）时，就会发生帧开始事件。

当此事件发生时，相应的消息会包含一个时间戳，指示事件的生成时间。在 Basler ace 2 相机上，它还包含一个帧 ID，指示已曝光图像的编号。

帧开始过度触发事件#

在可用的情况下，每当帧开始触发信号被过度触发时，便会发生帧开始过度触发事件。如果在相机尚未准备好接收信号时应用帧开始触发信号，便会发生这种情况。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

帧开始等待事件#

在可用的情况下，每当相机准备好接收帧开始触发信号时，便会发生帧开始等待事件。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

缺少帧触发事件#

该事件与帧开始过度触发事件相同，只是名称不同。

超温事件#

在可用的情况下，如果相机的温度状态已达到超温水平，就会发生超温事件。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

温度状态已更改事件#

在可用的情况下，每当相机的温度状态已更改时，便会发生“温度状态已更改”事件。

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:

• 确定：温度状态更改为“确定”。
• 重要：温度状态更改为“重要”。
• 错误：温度状态更改为“错误”。

同样，发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

测试事件#

在可用的情况下，可以使用测试事件来测试 Event Notification 功能。

发生此事件时，相应的消息会包含指示该事件生成时间的时间戳。

要测试 Event Notification：

1. Execute the TestEventGenerate command.
2. 处理您的应用中的测试事件。

详情#

显示所有相机型号

示例代码#

// 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 轻松设置参数。