Event Notification#

Event Notification camera feature를 사용하면 카메라 이벤트 및 이벤트 메시지를 활성화할 수 있습니다.

기능 사용법#

Event Notification 활성화#

1. 다음 값 중 하나로 EventSelector parameter를 설정하십시오(사용 가능한 경우):
   • 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) 코드 샘플을 참조하십시오.

사용 가능한 Events#

Action Late Event#

사용 가능한 경우, 과거의 Timestamp가 포함된 scheduled action command를 카메라가 수신하면 Action Late 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Critical Temperature Event#

사용 가능한 경우, 카메라의 Temperature State가 임계 수준에 도달하면 Critical Temperature 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 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 트리거가 생성되거나(free run) 외부에서 적용될 때(triggered image acquisition) Frame Burst Start 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

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

사용 가능한 경우, Frame Burst Start 트리거가 오버트리거될 때마다 Frame Burst Start Overtrigger 이벤트가 발생합니다. 이는 카메라가 신호를 수신할 준비가 되지 않은 상태에서 Frame Burst Start 트리거 신호를 적용할 때 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

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

사용 가능한 경우, 카메라가 Frame Burst Start 트리거 신호를 수신할 준비가 될 때마다 Frame Burst Start Wait 이벤트가 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Frame Start Event#

Frame Start 이벤트는 카메라에 의해 Frame Start 트리거가 생성되거나(free run) 외부에서 적용될 때(triggered image acquisition) 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다. Basler ace 2 카메라의 경우 노출된 이미지의 번호를 나타내는 프레임 ID도 포함됩니다.

Frame Start Overtrigger Event#

사용 가능한 경우, Frame Start 트리거가 오버트리거될 때마다 Frame Start Overtrigger 이벤트가 발생합니다. 이는 카메라가 신호를 수신할 준비가 되지 않은 상태에서 Frame Start 트리거 신호를 적용할 때 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Frame Start Wait Event#

사용 가능한 경우, Frame Start Wait 이벤트는 카메라가 Frame Start 트리거 신호를 수신할 준비가 될 때마다 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 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#

사용 가능한 경우, Over Temperature 이벤트는 카메라의 Temperature State이(가) 과온 수준에 도달했을 때 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 이벤트가 생성된 시간을 나타내는 Timestamp가 포함됩니다.

Temperature Status Changed Event#

사용 가능한 경우, Temperature Status Changed 이벤트는 카메라의 Temperature State이(가) 변경될 때마다 발생합니다.

이 이벤트가 발생하면 해당 메시지에는 다음이 포함됩니다. 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를 사용하여 파라미터를 손쉽게 설정할 수 있습니다.