reflectedControlObject.h

Go to the documentation of this file.

/****************************************************************************
 * Copyright (c) 2017 VT MAK
 * All rights reserved.
 ****************************************************************************/


#pragma once

#include <vrfExtObjects/dllExport.h>
#include <vrfExtObjects/controlObjectRepository.h>
#include <vl/reflectedEnvironmentProcess.h>

// Callback function that takes a DtReflectedControlObject and usr data.
class DtReflectedControlObject;

typedef void (*DtControlObjectCallbackFunction)
(
   DtReflectedControlObject* obj, void* userData
);

class DtExerciseConn;

class DT_DLL_vrfExtObjects DtReflectedControlObject : public DtReflectedEnvironmentProcess
{
public:
#if DtHLA
   // constructor
   DtReflectedControlObject(DtHlaObject* obj, DtExerciseConn* conn);
#elif (DtDIS || DtTENA)
   // constructor
   DtReflectedControlObject
   (
      DtExerciseConn* conn,
      const DtEntityIdentifier& id,
      const DtEntityType& type
   );
#else
#  pragma message ( "No protocol defined." )
#endif

   // destructor
   virtual ~DtReflectedControlObject();

   // Returns ptr to environmentProcessStateRepository --
   // through which you can inspect current state info.
   virtual DtControlObjectRepository* controlObjectStateRep() const;

   // Synonym for environmentStateRep.
   virtual DtControlObjectRepository* cosr() const;

   // Implementation for abstract base class.  Calls cosr().
   virtual DtStateRepository* stateRep() const;

#if DtDIS
   // Process an environment process state PDU.
   // Calls processEnvironmentProcess().
   virtual void processStateMessage(const DtStateMsg& msg);
#endif

   // Get the next and previous elements in the reflected
   // cwenvironment process list.
   virtual DtReflectedControlObject* nextCO() const;
   virtual DtReflectedControlObject* prevCO() const;

   // Get the next and previous elements, wrap at the ends of the list.
   virtual DtReflectedControlObject* wrapNextCO() const;
   virtual DtReflectedControlObject* wrapPrevCO() const;

   // Environment Process callback registration/deregistration.
   virtual void addPostUpdateCallback
   (
      DtControlObjectCallbackFunction cb, void* userData
   );
   virtual void removePostUpdateCallback
   (
      DtControlObjectCallbackFunction cb, void* userData
   );

   static void postUpdateCallback
   (
      DtReflectedControlObject* obj, void* userData
   );

   virtual void processPostUpdateCallback(DtReflectedControlObject* obj);

   // updateExtensions()
   // extracts the extended environmental process state information,
   // if present, from the state repository
   virtual void updateExtensions();

private:
   // not implemented.
   DtReflectedControlObject(const DtReflectedControlObject& orig);
   DtReflectedControlObject& operator=(const DtReflectedControlObject& orig);

};