scriptInterface.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2012 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
#pragma once

#include <vrfobjcore/vrfobjcoreDefines.h>

#include "vlutil/vlString.h"
#include "vrfobjcore/scriptVrfObject.h"
#include "vrfutil/rwVariableBindings.h"
#include <deque>
#include <vrfobjcore/scriptTaskControllerInterface.h>

class DtVrfObject;


class DT_DLL_vrfobjcore DtScriptInterface
{
protected:
   DtScriptInterface();
   DtScriptInterface(const DtScriptInterface& other);
   DtScriptInterface& operator=(const DtScriptInterface& other);

public:
   virtual ~DtScriptInterface();

   virtual bool invokeInit() = 0;
   virtual void invokeSuspend() = 0;
   virtual bool invokeResume() = 0;

   virtual void invokeTick() = 0;

   virtual bool loadScript(bool reload = false) = 0;

   virtual void invokeCheckInit() = 0;
   virtual bool invokeCheck() = 0;

   virtual DtString type() const = 0;

   virtual void setTaskId(int taskId) { myTaskId = taskId; }
   virtual int taskId() const { return myTaskId; }

   virtual void setScriptId(const DtString& scriptId) { myScriptId = scriptId; }
   virtual const DtString& scriptId() const { return myScriptId; }

   virtual void setScriptPath(const DtFilename& scriptPath) { myScriptPath = scriptPath; }
   virtual const DtFilename& scriptPath() const { return myScriptPath; }

   virtual void setEntity(DtVrfObject* entity) { myEntity = entity; }
   virtual DtVrfObject* entity() const { return myEntity; }

   virtual void init() { }


   virtual void setTaskVariables(const DtRwVariableBindings& variables) { myTaskVariables = variables; }
   virtual const DtRwVariableBindings& taskVariables() const { return myTaskVariables; }
   virtual bool updateTaskVariables();

   virtual DtReaderWriter* saveState() = 0;

   virtual bool loadState(const DtReaderWriter* savedState) = 0;

   virtual void processClearForReuse();

   virtual void setTaskStarting(bool v);
   virtual bool taskStarting() const;


   virtual void setTaskResuming(bool v);
   virtual bool taskResuming() const;

   virtual void setController(DtScriptTaskControllerInterface* controller) { myControllerInterface = controller; }
   virtual DtScriptTaskControllerInterface* controller() { return myControllerInterface; }

   double scriptGetExerciseTime();

   double scriptGetTimeOfDay();

   double scriptGetWindSpeed();

   double scriptGetWindDirection();

   DtScriptVrfObject scriptGetVrfObjectByName(const std::string name);
   void printError(const std::string message);
   void printWarn(const std::string message);
   void printInfo(const std::string message);
   void printVerbose(const std::string message);
   void printDebug(const std::string message);
   bool entityTypeMatches(const std::string&, const std::string&);

   void setTickPeriod(double);

   double getTerrainAltitude(const double lat, const double lon,
      bool& dataAvailable, std::string &surface) const;

   double getGroundAltitude(const double lat, const double lon,
      bool&isWater, bool& dataAvailable);
   
   void chordIntersectionDebug(const DtLocation3D& startLoc,
      const DtLocation3D& endLoc);

   bool doesChordHitTerrain(const DtLocation3D &pt1, 
      const DtLocation3D & pt2, 
      bool& dataAvailable
      ) const;

   DtLocation3D findClosestPointToRoad(const DtLocation3D& point, double searchRadius, bool& dataAvailable, bool& success) const;

   std::string getForceName(int forceType);
   bool forcesHostile(std::string force1, std::string force2);

protected:
   virtual void scriptTaskComplete(bool success);

   virtual void scriptTaskError();

   virtual bool scriptText(DtString& text);

   virtual const DtReaderWriter* getTaskParam(const DtString& paramName);

   virtual bool getParamMetaDataType(const DtString& paramName, DtString& typeName);

   int myTaskId;
   DtString myScriptId;
   DtFilename myScriptPath;
   DtScriptTaskControllerInterface* myControllerInterface;
   DtVrfObject* myEntity;
   DtRwVariableBindings myTaskVariables;
   bool myTaskStarting;
   bool myTaskResuming;
};



typedef DtScriptInterface* (*DtScriptInterfaceCreatorFunc)();

class DT_DLL_vrfobjcore DtScriptInterfaceFactory
{
protected:
   DtScriptInterfaceFactory();
   DtScriptInterfaceFactory(const DtScriptInterfaceFactory& other);
   DtScriptInterfaceFactory& operator=(const DtScriptInterfaceFactory& other);

public:
   virtual ~DtScriptInterfaceFactory();

   static DtScriptInterfaceFactory* instance();

   virtual DtScriptInterface* createInstance(const DtString& type);

   virtual void registerCreator(const DtString& type, DtScriptInterfaceCreatorFunc func);

   static void setFactory(DtScriptInterfaceFactory* factory);
   static DtScriptInterfaceFactory* create();

protected:
   std::map<DtString, DtScriptInterfaceCreatorFunc> myCreators;
   static DtScriptInterfaceFactory* theFactoryInstance;
};