Basler|CImageEventHandler类

//C:\Program Files\Basler\pylon 5\Development\include\pylon\ImageEventHandler.h//-----------------------------------------------------------------------------//  Basler pylon SDK//  Copyright (c) 2010-2016 Basler AG//  http://www.baslerweb.com//  Author:  Andreas Gau//-----------------------------------------------------------------------------/**\file\brief Contains the image event handler base class.*/#ifndef INCLUDED_IMAGEEVENTHANDLER_H_8866388#define INCLUDED_IMAGEEVENTHANDLER_H_8866388#include <pylon/stdinclude.h>#ifdef _MSC_VER#   pragma pack(push, PYLON_PACKING)#endif /* _MSC_VER */#include <pylon/GrabResultPtr.h>#if _MSC_VER#   pragma warning( push)#   pragma warning( disable : 4100) //warning C4100: 'identifier' : unreferenced formal parameter#endifnamespace Pylon{    class CInstantCamera;    /** \addtogroup Pylon_InstantCameraApiGeneric     * @{     */    /**    \class  CImageEventHandler    \brief  The image event handler base class.    */    class CImageEventHandler    {    public:        /**        \brief This method is called when images have been skipped using the GrabStrategy_LatestImageOnly strategy or the GrabStrategy_LatestImages strategy.        \param[in]  camera The source of the call.        \param[in]  countOfSkippedImages The number of images skipped. This \c countOfSkippedImages does not include the number of images lost in the case of a buffer under run in the driver.        \error            Exceptions from this call will propagate through. The notification of event handlers stops when an exception is triggered.        \threading            This method is called outside the lock of the camera object but inside the lock of the image event handler registry.        */        virtual void OnImagesSkipped( CInstantCamera& camera, size_t countOfSkippedImages)        {        }        /**        \brief This method is called when an image has been grabbed.        The grab result smart pointer passed does always reference a grab result data object.        The status of the grab needs to be checked before accessing the grab result data.        See CGrabResultData::GrabSucceeded(), CGrabResultData::GetErrorCode() and        CGrabResultData::GetErrorDescription() for more information.        \param[in]  camera The source of the call.        \param[in]  grabResult The grab result data.        \error            Exceptions from this call will propagate through. The notification of event handlers stops when an exception is triggered.        \threading            This method is called outside the lock of the camera object but inside the lock of the image event handler registry.        */        virtual void OnImageGrabbed( CInstantCamera& camera, const CGrabResultPtr& grabResult)        {        }        /**        \brief This method is called when the image event handler has been registered.        \param[in]  camera The source of the call.        \error            Exceptions from this call will propagate through.        \threading            This method is called inside the lock of the image event handler registry.        */        virtual void OnImageEventHandlerRegistered( CInstantCamera& camera)        {        }        /**        \brief This method is called when the image event handler has been deregistered.        The image event handler is automatically deregistered when the Instant Camera object        is destroyed.        \param[in]  camera The source of the call.        \error            C++ exceptions from this call will be caught and ignored.        \threading            This method is called inside the lock of the image event handler registry.        */        virtual void OnImageEventHandlerDeregistered( CInstantCamera& camera)        {        }        /*!        \brief Destroys the image event handler.        \error            C++ exceptions from this call will be caught and ignored.        */        virtual void DestroyImageEventHandler()        {            //If runtime errors occur here during delete, check the following:            //Check that the cleanup procedure is correctly set when registering.            //Ensure that the registered object has been allocated on the heap using new.            //Ensure that the registered object has not already been deleted.            delete this;        }        /// Create.        CImageEventHandler()            : m_eventHandlerRegistrationCount(0)        {        }        /// Copy.        CImageEventHandler(const CImageEventHandler&)            : m_eventHandlerRegistrationCount(0)        {        }        /// Assign.        CImageEventHandler& operator=(const CImageEventHandler&)        {            return *this;        }        /// Destruct.        virtual ~CImageEventHandler()        {            PYLON_ASSERT2( DebugGetEventHandlerRegistrationCount() == 0, "Error: The event handler must not be destroyed while it is registered.");        }        // Internal use only. Subject to change without notice.        const long& DebugGetEventHandlerRegistrationCount()        {            return m_eventHandlerRegistrationCount;        }    private:        long m_eventHandlerRegistrationCount; // Counts how many times the event handler is registered.    };    /**     * @}     */}#if _MSC_VER#   pragma warning( pop)#endif#ifdef _MSC_VER#   pragma pack(pop)#endif /* _MSC_VER */#endif /* INCLUDED_IMAGEEVENTHANDLER_H_8866388 */