Skip to content

Pylon::CBaslerUniversalConfigurationEventHandler#

Module: Instant Camera / Universal Instant Camera for All Basler Devices

The configuration event handler base class.

#include <pylon/BaslerUniversalConfigurationEventHandler.h>

Public Functions#

Name
virtual void OnAttach(CBaslerUniversalInstantCamera & camera)
This method is called before a Pylon Device (Pylon::IPylonDevice) is attached by calling the Instant Camera object's Attach() method.
virtual void OnAttached(CBaslerUniversalInstantCamera & camera)
This method is called after a Pylon Device (Pylon::IPylonDevice) has been attached by calling the Instant Camera object's Attach() method.
virtual void OnDetach(CBaslerUniversalInstantCamera & camera)
This method is called before the attached Pylon Device is detached from the Instant Camera object.
virtual void OnDetached(CBaslerUniversalInstantCamera & camera)
This method is called after the attached Pylon Device has been detached from the Instant Camera object.
virtual void OnDestroy(CBaslerUniversalInstantCamera & camera)
This method is called before the attached Pylon Device is destroyed.
virtual void OnDestroyed(CBaslerUniversalInstantCamera & camera)
This method is called after the attached Pylon Device has been destroyed.
virtual void OnOpen(CBaslerUniversalInstantCamera & camera)
This method is called before the attached Pylon Device is opened.
virtual void OnOpened(CBaslerUniversalInstantCamera & camera)
This method is called after the attached Pylon Device has been opened.
virtual void OnClose(CBaslerUniversalInstantCamera & camera)
This method is called before the attached Pylon Device is closed.
virtual void OnClosed(CBaslerUniversalInstantCamera & camera)
This method is called after the attached Pylon Device has been closed.
virtual void OnGrabStart(CBaslerUniversalInstantCamera & camera)
This method is called before a grab session is started.
virtual void OnGrabStarted(CBaslerUniversalInstantCamera & camera)
This method is called after a grab session has been started.
virtual void OnGrabStop(CBaslerUniversalInstantCamera & camera)
This method is called before a grab session is stopped.
virtual void OnGrabStopped(CBaslerUniversalInstantCamera & camera)
This method is called after a grab session has been stopped.
virtual void OnGrabError(CBaslerUniversalInstantCamera & camera, const char * errorMessage)
This method is called when an exception has been triggered during grabbing.
virtual void OnCameraDeviceRemoved(CBaslerUniversalInstantCamera & camera)
This method is called when a camera device removal from the PC has been detected.
virtual void OnConfigurationRegistered(CBaslerUniversalInstantCamera & camera)
This method is called when the configuration event handler has been registered.
virtual void OnConfigurationDeregistered(CBaslerUniversalInstantCamera & camera)
This method is called when the configuration event handler has been deregistered.
virtual void DestroyConfiguration()
Destroys the configuration event handler.
CBaslerUniversalConfigurationEventHandler()
Create.
CBaslerUniversalConfigurationEventHandler(const CBaslerUniversalConfigurationEventHandler & )
Copy.
CBaslerUniversalConfigurationEventHandler & operator=(const CBaslerUniversalConfigurationEventHandler & )
Assign.
virtual ~CBaslerUniversalConfigurationEventHandler()
Destruct.
const long & DebugGetEventHandlerRegistrationCount()

Public Functions Documentation#

OnAttach#

inline virtual void OnAttach(
    CBaslerUniversalInstantCamera & camera
)

This method is called before a Pylon Device (Pylon::IPylonDevice) is attached by calling the Instant Camera object's Attach() method.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

This method can not be used for detecting that a camera device has been attached to the PC. The camera's Attach() method must not be called from here or from subsequent calls to avoid infinite recursion.

OnAttached#

inline virtual void OnAttached(
    CBaslerUniversalInstantCamera & camera
)

This method is called after a Pylon Device (Pylon::IPylonDevice) has been attached by calling the Instant Camera object's Attach() method.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

This method can not be used for detecting that a camera device has been attached to the PC. The camera's Attach() method must not be called from here or from subsequent calls to avoid infinite recursion.

OnDetach#

inline virtual void OnDetach(
    CBaslerUniversalInstantCamera & camera
)

This method is called before the attached Pylon Device is detached from the Instant Camera object.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

The camera's Detach() method must not be called from here or from subsequent calls to avoid infinite recursion.

OnDetached#

inline virtual void OnDetached(
    CBaslerUniversalInstantCamera & camera
)

This method is called after the attached Pylon Device has been detached from the Instant Camera object.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

OnDestroy#

inline virtual void OnDestroy(
    CBaslerUniversalInstantCamera & camera
)

This method is called before the attached Pylon Device is destroyed.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

Camera DestroyDevice must not be called from here or from subsequent calls to avoid infinite recursion.

OnDestroyed#

inline virtual void OnDestroyed(
    CBaslerUniversalInstantCamera & camera
)

This method is called after the attached Pylon Device has been destroyed.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

OnOpen#

inline virtual void OnOpen(
    CBaslerUniversalInstantCamera & camera
)

This method is called before the attached Pylon Device is opened.

Parameters:

  • camera The source of the call.

Error Safety:

Exceptions from this call will propagate through. The notification of event handlers stops when an exception is triggered.

Thread Safety:

This method is called inside the lock of the camera object.

OnOpened#

inline virtual void OnOpened(
    CBaslerUniversalInstantCamera & camera
)

This method is called after the attached Pylon Device has been opened.

Parameters:

  • camera The source of the call.

Error Safety:

Exceptions from this call will propagate through. The notification of event handlers stops when an exception is triggered.

Thread Safety:

This method is called inside the lock of the camera object.

OnClose#

inline virtual void OnClose(
    CBaslerUniversalInstantCamera & camera
)

This method is called before the attached Pylon Device is closed.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

Camera Close must not be called from here or from subsequent calls to avoid infinite recursion.

OnClosed#

inline virtual void OnClosed(
    CBaslerUniversalInstantCamera & camera
)

This method is called after the attached Pylon Device has been closed.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

OnGrabStart#

inline virtual void OnGrabStart(
    CBaslerUniversalInstantCamera & camera
)

This method is called before a grab session is started.

Parameters:

  • camera The source of the call.

Error Safety:

Exceptions from this call will propagate through. The notification of event handlers stops when an exception is triggered.

Thread Safety:

This method is called inside the lock of the camera object.

Camera StartGrabbing must not be called from here or from subsequent calls to avoid infinite recursion.

OnGrabStarted#

inline virtual void OnGrabStarted(
    CBaslerUniversalInstantCamera & camera
)

This method is called after a grab session has been started.

Parameters:

  • camera The source of the call.

Error Safety:

Exceptions from this call will propagate through. The notification of event handlers stops when an exception is triggered.

Thread Safety:

This method is called inside the lock of the camera object.

OnGrabStop#

inline virtual void OnGrabStop(
    CBaslerUniversalInstantCamera & camera
)

This method is called before a grab session is stopped.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

Camera StopGrabbing must not be called from here or from subsequent calls to avoid infinite recursion.

OnGrabStopped#

inline virtual void OnGrabStopped(
    CBaslerUniversalInstantCamera & camera
)

This method is called after a grab session has been stopped.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

OnGrabError#

inline virtual void OnGrabError(
    CBaslerUniversalInstantCamera & camera,
    const char * errorMessage
)

This method is called when an exception has been triggered during grabbing.

Parameters:

  • camera The source of the call.
  • errorMessage The message of the exception that signaled an error during grabbing.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object.

An exception has been triggered by a grab thread. The grab will be stopped after this event call.

OnCameraDeviceRemoved#

inline virtual void OnCameraDeviceRemoved(
    CBaslerUniversalInstantCamera & camera
)

This method is called when a camera device removal from the PC has been detected.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored. All event handlers are notified.

Thread Safety:

This method is called inside the lock of the camera object from an additional thread.

The Pylon Device attached to the Instant Camera is not operable after this event. After it is made sure that no access to the Pylon Device or any of its node maps is made anymore the Pylon Device should be destroyed using InstantCamera::DeviceDestroy(). The access to the Pylon Device can be protected using the lock provided by GetLock(), e.g. when accessing parameters.

OnConfigurationRegistered#

inline virtual void OnConfigurationRegistered(
    CBaslerUniversalInstantCamera & camera
)

This method is called when the configuration event handler has been registered.

Parameters:

  • camera The source of the call.

Error Safety:

Exceptions from this call will propagate through.

Thread Safety:

This method is called inside the lock of the camera object.

OnConfigurationDeregistered#

inline virtual void OnConfigurationDeregistered(
    CBaslerUniversalInstantCamera & camera
)

This method is called when the configuration event handler has been deregistered.

Parameters:

  • camera The source of the call.

Error Safety:

C++ exceptions from this call will be caught and ignored.

Thread Safety:

This method is called inside the lock of the camera object.

The configuration event handler is automatically deregistered when the Instant Camera object is destroyed.

DestroyConfiguration#

inline virtual void DestroyConfiguration()

Destroys the configuration event handler.

Error Safety:

C++ exceptions from this call will be caught and ignored.

CBaslerUniversalConfigurationEventHandler#

inline CBaslerUniversalConfigurationEventHandler()

Create.

CBaslerUniversalConfigurationEventHandler#

inline CBaslerUniversalConfigurationEventHandler(
    const CBaslerUniversalConfigurationEventHandler & 
)

Copy.

operator=#

inline CBaslerUniversalConfigurationEventHandler & operator=(
    const CBaslerUniversalConfigurationEventHandler & 
)

Assign.

~CBaslerUniversalConfigurationEventHandler#

inline virtual ~CBaslerUniversalConfigurationEventHandler()

Destruct.

DebugGetEventHandlerRegistrationCount#

inline const long & DebugGetEventHandlerRegistrationCount()

Updated on 5 July 2022 at 15:30:01