formationState.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2015 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/


#pragma once

#include "vrfobjcore/formationRecord.h"
#include <vlutil/vlString.h>
#include <vector>
#include <map>
#include "vrfobjcore/orgViewManagedObjectList.h"
#include "vrfobjcore/vrfObjectReference.h"

class DtFormation;
class DtFormationRecord;
class DtFormationQueryResult;
class DtFormationState;
class DtVrfObject;
class DtFormationQueryResultList;

typedef void (*DtFormationStateCallbackFcn)(
   const DtFormationState& formationState, void* usr);

struct DtFormationStateCallbackInfo
{
   DtFormationStateCallbackFcn myCallbackFunction;
   void* myUserData;
};

#include "vrfobjcore/vrfobjcoreDefines.h"
class DT_DLL_vrfobjcore DtFormationState
{
public:
   
   DtFormationState();

   DtFormationState(const DtFormationState& orig);
   
   DtFormationState& operator=(const DtFormationState& orig);
   
   virtual ~DtFormationState();

   virtual void setFormation(const DtFormation& formation);
   virtual void setFormation(const std::vector<DtFormationRecord*>& formation);

   virtual void addFormationRecord(const DtFormationRecord& formationRecord,
      int positionIndex);

   virtual void removeFormationRecord(int positionIndex);
      
   virtual void setEntityList(const std::vector<DtUUID>& entityList);

   virtual void setEntityListAndFormation(const std::vector<DtUUID>& entityList,
      const DtFormation& formation, const std::list<int>& formationPositions);

   virtual void setEntityListAndFormation(DtOrgViewManagedObjectListConstPtr entityList,
      const DtFormation& formation, const std::list<int>& formationPositions);

   virtual const DtRwVrfObjectReferenceList& entityList() const;

   virtual void clearEntityList();
   
   virtual bool lookup(const DtUUID& subordinate, DtFormationQueryResult& result) const;

   virtual int lookupPromotionIndexByName(const DtUUID& subordinate) const;

   virtual void queryAll(DtFormationQueryResultList& resultList) const;

   virtual DtUUID formationLeader() const;

   virtual double formationHalfLength() const;

   virtual void print();

   virtual void addFormationStateChangedCallback(
      DtFormationStateCallbackFcn fcn, void* userData);

   virtual void removeFormationStateChangedCallback(
      DtFormationStateCallbackFcn fcn, void* userData);

   virtual void enableFormationCallbacks();
   virtual void disableFormationCallbacks();

   virtual bool isAvailableForFormation(const DtVrfObject*) const;

protected:

   virtual const DtFormationRecord* lookupFormationRecord(int positionIndex) const;

   virtual DtVector lookupFollowOffset(const DtUUID& subordinate) const;

   virtual DtUUID lookupLeader(const DtUUID& subordinate) const;

   virtual void rebuildEntityToPositionMap();

   virtual DtFormationRecord* generateAdditionalFormationRecord(int positionIndex) const;

   void emptyPositionIndexToFormationRecordMap();

   virtual DtVector positionOffsetForPositionIndex(int positionIndex);

   virtual void invokeFormationStateChangedCallbacks() const;

protected:

   DtRwVrfObjectReferenceList myEntityList;
   mutable std::map<int, const DtFormationRecord*> myPositionIndexToFormationRecordMap;
   std::map<DtUUID, DtVector> myEntityToPositionMap;
   std::map<int, DtUUID> myPositionIndexToEntityMap;
   std::map<DtUUID, int> myEntityToPositionIndexMap;
   std::vector<DtFormationStateCallbackInfo> myFormationStateChangedCallbackList;

   bool myCallbacksAreEnabled;
};