vrfObject.h

Go to the documentation of this file.

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

#pragma once




#include "vrfobjcore/objFactory.h"
#include "vrfobjcore/simObjCbInfo.h"
#include "vrfobjcore/obsAreaCompat.h"
#include "vrfobjcore/vrfObjPredCbInfo.h"
#include "vrfobjcore/luaScriptInterfaceExtension.h"
#include "geometry/tdbextent.h"

#include "vrfutil/rdrWritr.h"
#include "vrfutil/rwString.h"
#include "vrfutil/rwObjType.h"
#include "vrfutil/rwBoolean.h"
#include "vrfutil/lclVtxList.h"
#include "vrfutil/rwVector.h"
#include "vrfutil/callbackList.h"

#include <vl/hostStructs.h>
#include <vlpi/appearance.h>
#include <vlutil/vlList.h>

class DtVrfObjectStateRepository;
class DtSimObjectStateRepository;
class DtSimObjectNetInterface;
class DtStateRepository;
class DtVrfObjectParameters;
class DtVrfObjectSubComponentTypes;
class DtSimObjectCallbackInfo;
class DtVrfObjectMessage;
class DtVrfObjectManager;
class DtSimManager;
class DtVrfObjectSubComponentTypes;
class DtSimTaskManager;
class DtSimBaseRadio;
class DtSimComponentManager;
class DtVrfObjectPlanManager;
class DtIfCreateVrfObject;
class DtIfModifyVrfObject;
class DtIfVrfObjectCreated;
class DtReflectedEntity;
class DtReflectedExtAggregate;
class DtReflectedEnvironmentProcess;
class DtVrfObject;
class DtVrfObjectPredicate;
class DtLclVerticesNotEqualPredicate;
class Coordinate_System;
class DtAttachedTerrain;
class DtPhysicalWorld;
class DtObjectConsole;
class DtSetDataManager;
class DtVrfObjectCommunicationInterface;
class DtRadioDescriptorList;
class DtSettingsObject;
class DtVrfObjectTerrainPreloadManager;

typedef void (*DtVrfObjectCallbackFunction)(DtVrfObject* obj, void* userData);

typedef DtCallbackList<DtVrfObject*> DtVrfObjectCallbackList;

#include "vrfobjcore/vrfobjcoreDefines.h"
class DT_DLL_vrfobjcore DtVrfObject : public DtReaderWriter
{
public:

   typedef std::pair<DtVrfObjectCallbackFunction, void*> DtVrfObjectCallbackDataPair;
   typedef std::pair<DtVrfObject*, DtVrfObjectCallbackDataPair> DtVrfObjectCallbackDataPair2;
   typedef std::list<DtLuaScriptInterfaceExtension::CreatorUserPair> ScriptInterfaceExtensions;

protected:

   DtVrfObject();

public:

   DtVrfObject(
      const DtObjectType & objectType, 
      DtVrfObjectManager* vrfObjectManager,
      bool createLocalObject = true,
      bool publishLocalObject = true,
      const DtEntityIdentifier& objectIdentifier = DtEntityIdentifier::nullId(),
      const DtGlobalObjectDesignator* globalId = 0,
      DtReflectedObject* reflectedObject = 0,
      const DtString & objectName = DtString::nullString(),
      const DtString & objectLabel = DtString::nullString(),
      DtForceType forceType = DtForceOther,
      const DtList* vertices = 0,
      const DtTaitBryan* orientation = 0,
      bool projection = false,
      bool closedFigure = false,
      const DtAppearance& appearance = DtAppearance::nullAppearance(),
      const DtString & readerWriterName = "vrf-object", 
      DtReaderWriterRegistry* parentRegistry = 0);

   virtual ~DtVrfObject();

   virtual bool create();
   virtual void createCommunicationsInterface();

   virtual void createCommunicationsInterface(const DtRadioDescriptorList& descList);

   virtual void createSetDataManager();

   virtual bool init();


   virtual void tick();
   virtual bool createRepository(DtVrfObjectParameters* parameterEntry);
   virtual bool createTaskManager();
   virtual bool createComponentManager();
   virtual bool createVrfObjectPlanManager();
   virtual bool createRadio();

   virtual const DtSimManager* simManager() const;
   virtual DtSimManager* simManager();

   virtual DtSimTaskManager* taskManager() const;
   virtual DtSimComponentManager* componentManager() const;
   virtual DtVrfObjectPlanManager* vrfObjectPlanManager() const;
   virtual DtSimBaseRadio* radio() const;

   virtual DtVrfObjectStateRepository* vrfState() const;

   virtual DtExtent extent() const;

   virtual void expandExtent(DtExtent& extent) const;
   
   virtual void sendVrfObjectCreated(unsigned long requestId = 0);
   
   virtual void setupFromMessageContent(DtIfModifyVrfObject* ifModVrfObject);

   virtual bool isVrfSimulatedObject();
   virtual void setIsVrfSimulatedObject(bool b);

   virtual bool isSimulatingComponents() const;

   virtual void putSelf(FILE* fp, int indentLevel = 0, bool writeUnspecified = true,
      const DtFilename& path = DtReaderWriter::appPath());

   virtual void getSelf(DtlObjPtr args, const DtFilename& searchPath,
      const DtVariableBindingsList& variableBindings);  

   virtual bool setObjectName(const DtString & name, bool rename = true);

   virtual void addNameAlias(const DtString& name);

   virtual void unregisterAliases();

   virtual void addVrfObjectChangedCallback(
      DtVrfObjectCallbackFunction function, void* userData);
   virtual void removeVrfObjectChangedCallback(
      DtVrfObjectCallbackFunction function, void* userData);

   virtual void addVerticesChangedCallback(
      DtVrfObjectCallbackFunction function, void* userData);
   virtual void removeVerticesChangedCallback(
      DtVrfObjectCallbackFunction function, void* userData);

   virtual void addRelativeVerticesChangedCallback(
      DtVrfObjectCallbackFunction function, void* userData);
   virtual void removeRelativeVerticesChangedCallback(
      DtVrfObjectCallbackFunction function, void* userData);

   virtual void addVrfObjectPredicateCallback(
      DtVrfObjectPredicateCallbackFunction function, 
      const DtVrfObjectPredicate& predicate, DtTime evaluationPeriod = 0, 
      void* userData = 0);
   virtual void removeVrfObjectPredicateCallback(
      DtVrfObjectPredicateCallbackFunction function, 
      const DtVrfObjectPredicate& predicate, DtTime evaluationPeriod = 0, 
      void* userData = 0);

   virtual int predicateCallbackCount() const;

   virtual void invokeVrfObjectPredicateCallbacks();

   virtual void setCoordinateSystem(const Coordinate_System* coordinateSystem);

   virtual const DtVrfObjectManager* simObjectManager() const;
   virtual DtVrfObjectManager* simObjectManager();
   virtual void setSimObjectManager(DtVrfObjectManager* simObjectManager);

   virtual bool createNetInterface();

   virtual void setGlobalId(const DtGlobalObjectDesignator & id);
   virtual const DtGlobalObjectDesignator & globalId() const;

   virtual bool baseSetObjectName(const DtString & name);
   virtual const DtString & objectName() const;

   virtual const DtString & objectLabel() const;
   virtual void setObjectLabel(const DtString & objectLabel);

   virtual const DtString & overlayParent() const;
   virtual void setOverlayParent(const DtString & overlayParent);

   virtual DtStateRepository* netState();
   virtual const DtStateRepository* netState() const;

   virtual DtSimObjectNetInterface* netInterface();
   virtual const DtSimObjectNetInterface* netInterface() const;
   virtual void setNetInterface(DtSimObjectNetInterface* netInterface);

   virtual void setObjectIdentifier(const DtEntityIdentifier & objectId);
   virtual const DtEntityIdentifier & objectIdentifier() const;

   virtual bool isLocal() const;


   virtual void setPublishObject(bool publishObject);
   virtual bool publishObject() const;

   virtual DtString type() const;

   virtual DtString objectClassType() const; 
   virtual void setObjectClassType(const DtString & objectClassType);

   virtual void clearVerticesChangedCallbacks();

   virtual void clearRelativeVerticesChangedCallbacks();

   virtual void clearPredicateCallbacks();

   static void addSimObjectCreatorFcn(const DtString & type, 
      DtSimObjectCreatorFcn fcn);

   static DtSimObjectFactory* factory();
   static void setFactory(DtSimObjectFactory* factory);

   virtual DtSimObjectStateRepository* simState();
   virtual const DtSimObjectStateRepository* simState() const;
   virtual void setSimState(DtVrfObjectStateRepository* simState);

   void setEntityType(const DtEntityType & entityType);
   const DtEntityType & entityType() const;

   void setDestroyed(bool destroyed);
   bool isDestroyed() const;

   virtual void place(const DtVector& location, bool* dataAvailable = 0, 
      bool requireAllData = false);

   virtual void place(const DtReal heading, bool* dataAvailable = 0, 
      bool requireAllData = false);

   virtual void place(const DtVector& location, const DtReal heading, 
      bool* dataAvailable = 0, bool requireAllData = false);

   const DtString & echelonIdString() const;

   virtual DtVrfObject* leadEntity() const;

   virtual const DtString& firstSubordinate() const;

   virtual const DtString& lastSubordinate() const;

   virtual const DtString& firstHealthySubordinate() const;

   virtual void echelonIdChanged() {}

   virtual const DtObjectId & objectId() const;
   virtual const DtObjectType& objectType() const;

   virtual bool isEmbarked() const;

   virtual bool isEmbarkedOn(const DtString& parent) const;

   DtAttachedTerrain* terrainAttachedTo();
   const DtAttachedTerrain* terrainAttachedTo() const;

   virtual const DtPhysicalWorld* physicalWorld() const;
   virtual DtPhysicalWorld* physicalWorld();

   void setAboutToBeRemoved(bool);
   bool aboutToBeRemoved() const;

   virtual DtOutputStream& objectConsoleDebug() const;
   virtual DtOutputStream& objectConsoleVerbose() const;
   virtual DtOutputStream& objectConsoleInfo() const;
   virtual DtOutputStream& objectConsoleWarn() const;
   virtual DtOutputStream& objectConsoleError() const;

   virtual DtObjectConsole* objectConsole();
   virtual const DtObjectConsole* objectConsole() const;

   virtual DtSetDataManager* setDataManager();

   virtual DtVrfObjectCommunicationInterface* communicationInterface();

   virtual DtVrfObjectTerrainPreloadManager* terrainPreloadManager();

   DtVrfObjectSubComponentTypes* vrfSubComponentTypes() const;

   virtual bool hasPlan() const;

   virtual bool executingPlan() const;

   virtual bool isCurrentlyTasked() const;

   virtual void addPostInitFromParamsCallback(DtVrfObjectCallbackFunction fcn,
      void* usr);
   virtual void removePostInitFromParamsCallback(DtVrfObjectCallbackFunction fcn,
      void* usr);

   virtual DtU8 getNextEmitterSystemId();

   static void setDefaultNotifyLevel(DtNotifyLevelType level);
   static DtNotifyLevelType defaultNotifyLevel();

   virtual void addScriptExtension(DtLuaScriptInterfaceExtension::CreatorFcn extension, void* usr);
   virtual void removeScriptExtension(DtLuaScriptInterfaceExtension::CreatorFcn extension, void* usr);
   virtual const ScriptInterfaceExtensions& scriptExtensions() const;

public:

   static DtVrfObject* creator(
      const DtObjectType& objectType,
      DtVrfObjectManager* simObjectManager, 
      bool createLocalObject = true,
      bool publishLocalObject = true,
      const DtEntityIdentifier& objectIdentifier = DtEntityIdentifier::nullId(),
      const DtGlobalObjectDesignator* globalId = 0,
      DtReflectedObject* reflectedObject = 0,
      const DtString & objectName = DtString::nullString(),
      const DtString & objectLabel = DtString::nullString(),
      DtForceType forceType = DtForceOther,
      const DtList* vertices = 0,
      const DtTaitBryan* orientation = 0,
      bool projection = false,
      bool closedFigure = false,
      const DtAppearance& appearance = DtAppearance::nullAppearance(),
      const DtString & readerWriterName = DtString::nullString(), 
      DtReaderWriterRegistry* parentRegistry = 0);

   static DtVrfObject* createObject(
      const DtObjectType& objectType,
      DtVrfObjectManager* vrfObjectManager, 
      const DtString & classType, 
      bool createLocalObject = true,
      bool publishLocalObject = true,
      const DtEntityIdentifier& objectIdentifier = DtEntityIdentifier::nullId(),
      const DtGlobalObjectDesignator* globalId = 0,
      DtReflectedObject* reflectedObject = 0,
      const DtString & objectName = DtString::nullString(),
      const DtString & objectLabel = DtString::nullString(),
      DtForceType forceType = DtForceOther,
      const DtList* vertices = 0,
      const DtTaitBryan* orientation = 0,
      bool projection = false,
      bool closedFigure = false,
      const DtAppearance& appearance = DtAppearance::nullAppearance(),
      const DtString & readerWriterName = DtString::nullString(), 
      DtReaderWriterRegistry* parentRegistry = 0);

   static DtVrfObject* createObject(
      const DtObjectType & objectType,
      DtVrfObjectManager* vrfObjectManager, 
      const DtString & classType, 
      bool createLocalObject = true,
      bool publishLocalObject = true,
      const DtEntityIdentifier& objectIdentifier = DtEntityIdentifier::nullId(),
      const DtGlobalObjectDesignator* globalId = 0,
      DtReflectedObject* reflectedObject = 0,
      const DtString & objectName = DtString::nullString(),
      const DtString & objectLabel = DtString::nullString(),
      DtForceType forceType = DtForceOther,
      const DtVector& location = DtVector::zero(),
      const DtTaitBryan* orientation = 0,
      bool projection = false,
      bool closedFigure = false,
      const DtAppearance& appearance = DtAppearance::nullAppearance(),
      const DtString & readerWriterName = DtString::nullString(), 
      DtReaderWriterRegistry* parentRegistry = 0);

   static DtVrfObject* createAndInit(
      DtVrfObjectManager* vrfObjectManager, DtlObjPtr mtlStream);

   static void verticesChangedCallback(DtVrfObject* obj, 
      DtVrfObjectPredicateEvaluator* predicateEval, void* userData);

   static void relativeVerticesChangedCallback(DtVrfObject* obj, 
      DtVrfObjectPredicateEvaluator* predicateEval, void* userData);

   static void postInitFromParamsCallback(DtVrfObjectStateRepository& stateRepository, void* usr);


   static void readDRThresholdSettingsCallback(
      const DtSettingsObject* settings, void* usr);
   virtual void processReadDRThresholdSettings(const DtSettingsObject* settings);


   virtual void addObjectAboutToBeRemovedCallback(
      DtVrfObjectCallbackList::DtCallbackFunctionType fcn, void* usr);
   virtual void removeObjectAboutToBeRemovedCallback(
      DtVrfObjectCallbackList::DtCallbackFunctionType fcn, void* usr);
   virtual void invokeVrfObjectAboutToBeRemovedCallbacks();


   virtual void addSetLocationCompleteCallback(
      DtVrfObjectCallbackList::DtCallbackFunctionType fcn, void* usr);
   virtual void removeSetLocationCompleteCallback(
      DtVrfObjectCallbackList::DtCallbackFunctionType fcn, void* usr);
   virtual void invokeSetLocationCompleteCallbacks();

protected:

   DtVrfObject(const DtVrfObject& orig);

   DtVrfObject& operator=(const DtVrfObject& orig);


   virtual void setupStateRepository();

   virtual void setupNetInterface();

   void emptyVertexList();

   void copyVertexList(const DtList& orig);

   virtual void validateObjectType();

   virtual void processPostInitFromParamsCallback(DtVrfObjectCallbackFunction fcn, void* usr);

   virtual void initializeCommunicationInterfaceCallbacks();
   static void setOverlayLayerTaskCallback(const DtVrfObjectMessage* msg, void* usr);
   virtual void processSetOverlayLayerTask(const DtVrfObjectMessage* msg);

protected:

   DtRwString                    myObjectClassType;

   static DtSimObjectFactory*    theFactory;

   DtEntityIdentifier            myObjectIdentifier;

   DtRwObjectType                myObjectType;

   DtRwString                    myObjectName;
   DtRwString                    myObjectLabel;
   DtRwString                    myOverlayParent;

   DtGlobalObjectDesignator      myGlobalId;

   DtVrfObjectManager*           mySimObjectManager;

   DtVrfObjectStateRepository*   mySimState;

   DtSimObjectNetInterface*      myNetInterface;

   DtRwBoolean                   myPublishObject;

   bool                          myCreateLocalObject;

   bool                          myIsVrfSimulatedObject;

   DtReflectedObject*            myReflectedObject;
   DtForceType                   myForceType;
   DtList                        myVertices;
   DtTaitBryan                   myOrientation;
   bool                          myProjection;
   bool                          myClosedFigure;
   DtAppearance                  myAppearance;

   DtVrfObjectSubComponentTypes* mySubComponentTypes;

   DtSimManager*                 mySimManager;

   DtSimTaskManager*             myTaskManager;
   DtSimBaseRadio*               myRadio;
   DtSimComponentManager*        myComponentManager;
   DtVrfObjectPlanManager*       myVrfObjectPlanManager;

   DtLocalVertexList             myOvlVertices;
   DtRwVector                    myOvlTargetLocation;
   DtRwVector                    myOvlStartPoint;
   DtRwVector                    myOvlEndPoint;
   DtObstacleAreaCompatilibility myOvlObstacleArea;
   DtRwBoolean                   myOvlObstacleIsBreached;

   DtList myPredicateCallbackList;

   DtList myVerticesChangedCallbackList;

   DtList myRelativeVerticesChangedCallbackList;

   DtVrfObjectCallbackList myAboutToBeRemovedCallbackList;
   DtVrfObjectCallbackList mySetLocationCompleteCallbackList;

   DtList myNameAliasList;

   bool  myAboutToBeRemoved;

   DtObjectConsole* myObjectConsole;

   DtSetDataManager* mySetDataManager;

   DtVrfObjectCommunicationInterface* myCommunicationInterface;

   DtU8 myNextEmitterSystemId;

   DtVrfObjectTerrainPreloadManager* myTerrainPreloadManager;

   ScriptInterfaceExtensions myScriptInterfaceExtensions;
   
   static int theDefaultNotifyLevel;
};

inline void DtVrfObject::setAboutToBeRemoved(bool b)
{
   myAboutToBeRemoved = b;
}

inline bool DtVrfObject::aboutToBeRemoved() const
{
   return myAboutToBeRemoved;
}