src/Scripting/NasalSys.hxx

   1 #ifndef __NASALSYS_HXX
   2 #define __NASALSYS_HXX
   3
   4 #include <simgear/misc/sg_path.hxx>
   5 #include <simgear/structure/subsystem_mgr.hxx>
   6 #include <simgear/misc/sg_dir.hxx>
   7 #include <simgear/nasal/cppbind/NasalHash.hxx>
   8 #include <simgear/nasal/nasal.h>
   9 #include <simgear/threads/SGQueue.hxx>
  10 #include <simgear/props/props.hxx>
  11
  12 // Required only for MSVC
  13 #ifdef _MSC_VER
  14 #   include <Scripting/NasalModelData.hxx>
  15 #endif
  16
  17 #include <map>
  18
  19
  20 class FGNasalScript;
  21 class FGNasalListener;
  22 class SGCondition;
  23 class FGNasalModelData;
  24 class NasalCommand;
  25 class FGNasalModuleListener;
  26
  27 namespace simgear { class BufferedLogCallback; }
  28
  29 SGPropertyNode* ghostToPropNode(naRef ref);
  30 SGCondition* conditionGhost(naRef r);
  31
  32 class FGNasalSys : public SGSubsystem
  33 {
  34 public:
  35     FGNasalSys();
  36     virtual ~FGNasalSys();
  37     virtual void init();
  38     virtual void shutdown();
  39
  40     virtual void update(double dt);
  41
  42     // Loads a nasal script from an external file and inserts it as a
  43     // global module of the specified name.
  44     bool loadModule(SGPath file, const char* moduleName);
  45
  46     // Simple hook to run arbitrary source code.  Returns a bool to
  47     // indicate successful execution.  Does *not* return any Nasal
  48     // values, because handling garbage-collected objects from C space
  49     // is deep voodoo and violates the "simple hook" idea.
  50     bool parseAndRun(const char* sourceCode);
  51
  52     // Slightly more complicated hook to get a handle to a precompiled
  53     // Nasal script that can be invoked via a call() method.  The
  54     // caller is expected to delete the FGNasalScript returned from
  55     // this function.  The "name" argument specifies the "file name"
  56     // for the source code that will be printed in Nasal stack traces
  57     // on error.
  58  //   FGNasalScript* parseScript(const char* src, const char* name=0);
  59
  60     // Implementation of the settimer extension function
  61     void setTimer(naContext c, int argc, naRef* args);
  62
  63     // Implementation of the setlistener extension function
  64     naRef setListener(naContext c, int argc, naRef* args);
  65     naRef removeListener(naContext c, int argc, naRef* args);
  66
  67     // Returns a ghost wrapper for the current _cmdArg
  68     naRef cmdArgGhost();
  69
  70     void setCmdArg(SGPropertyNode* aNode);
  71
  72     /**
  73      * create Nasal props.Node for an SGPropertyNode*
  74      * This is the actual ghost, wrapped in a Nasal sugar class.
  75      */
  76     naRef wrappedPropsNode(SGPropertyNode* aProps);
  77
  78     // Callbacks for command and timer bindings
  79     virtual bool handleCommand( const char* moduleName,
  80                                 const char* fileName,
  81                                 const char* src,
  82                                 const SGPropertyNode* arg = 0 );
  83     virtual bool handleCommand(const SGPropertyNode* arg);
  84
  85     bool createModule(const char* moduleName, const char* fileName,
  86                       const char* src, int len, const SGPropertyNode* cmdarg=0,
  87                       int argc=0, naRef*args=0);
  88
  89     void deleteModule(const char* moduleName);
  90
  91     void addCommand(naRef func, const std::string& name);
  92     void removeCommand(const std::string& name);
  93
  94     /**
  95      * Set member of specified hash to given value
  96      */
  97     void hashset(naRef hash, const char* key, naRef val);
  98
  99     /**
 100      * Set member of globals hash to given value
 101      */
 102     void globalsSet(const char* key, naRef val);
 103
 104     naRef call(naRef code, int argc, naRef* args, naRef locals);
 105     naRef callWithContext(naContext ctx, naRef code, int argc, naRef* args, naRef locals);
 106
 107     naRef callMethod(naRef code, naRef self, int argc, naRef* args, naRef locals);
 108     naRef callMethodWithContext(naContext ctx, naRef code, naRef self, int argc, naRef* args, naRef locals);
 109
 110     naRef propNodeGhost(SGPropertyNode* handle);
 111
 112     void registerToLoad(FGNasalModelData* data);
 113     void registerToUnload(FGNasalModelData* data);
 114
 115     // can't call this 'globals' due to naming clash
 116     naRef nasalGlobals() const
 117     { return _globals; }
 118
 119     nasal::Hash getGlobals() const
 120     { return nasal::Hash(_globals, _context); }
 121
 122     // This mechanism is here to allow naRefs to be passed to
 123     // locations "outside" the interpreter.  Normally, such a
 124     // reference would be garbage collected unexpectedly.  By passing
 125     // it to gcSave and getting a key/handle, it can be cached in a
 126     // globals.__gcsave hash.  Be sure to release it with gcRelease
 127     // when done.
 128     int gcSave(naRef r);
 129     void gcRelease(int key);
 130
 131     /// retrive the associated log object, for displaying log
 132     /// output somewhere (a UI, presumably)
 133     simgear::BufferedLogCallback* log() const
 134     { return _log; }
 135 private:
 136     //friend class FGNasalScript;
 137     friend class FGNasalListener;
 138     friend class FGNasalModuleListener;
 139
 140     SGLockedQueue<SGSharedPtr<FGNasalModelData> > _loadList;
 141     SGLockedQueue<SGSharedPtr<FGNasalModelData> > _unloadList;
 142
 143     // Delay removing items of the _loadList to ensure the are already attached
 144     // to the scene graph (eg. enables to retrieve world position in load
 145     // callback).
 146     bool _delay_load;
 147
 148     //
 149     // FGTimer subclass for handling Nasal timer callbacks.
 150     // See the implementation of the settimer() extension function for
 151     // more notes.
 152     //
 153     struct NasalTimer {
 154         virtual void timerExpired();
 155         virtual ~NasalTimer() {}
 156         naRef handler;
 157         int gcKey;
 158         FGNasalSys* nasal;
 159     };
 160
 161     // Listener
 162     std::map<int, FGNasalListener *> _listener;
 163     std::vector<FGNasalListener *> _dead_listener;
 164
 165     std::vector<FGNasalModuleListener*> _moduleListeners;
 166
 167     static int _listenerId;
 168
 169     void loadPropertyScripts();
 170     void loadPropertyScripts(SGPropertyNode* n);
 171     void loadScriptDirectory(simgear::Dir nasalDir);
 172     void addModule(std::string moduleName, simgear::PathList scripts);
 173     static void logError(naContext);
 174     naRef parse(naContext ctx, const char* filename, const char* buf, int len);
 175     naRef genPropsModule();
 176
 177     bool _inited;
 178     naContext _context;
 179     naRef _globals,
 180           _string;
 181
 182     SGPropertyNode_ptr _cmdArg;
 183
 184     simgear::BufferedLogCallback* _log;
 185
 186     typedef std::map<std::string, NasalCommand*> NasalCommandDict;
 187     NasalCommandDict _commands;
 188
 189     naRef _wrappedNodeFunc;
 190 public:
 191     void handleTimer(NasalTimer* t);
 192 };
 193
 194 #if 0
 195 class FGNasalScript {
 196 public:
 197     ~FGNasalScript() { _nas->gcRelease(_gcKey); }
 198
 199     bool call() {
 200         naRef n = naNil();
 201         naCall(_nas->_context, _code, 0, &n, naNil(), naNil());
 202         return naGetError(_nas->_context) == 0;
 203     }
 204
 205     FGNasalSys* sys() const { return _nas; }
 206 private:
 207     friend class FGNasalSys;
 208     naRef _code;
 209     int _gcKey;
 210     FGNasalSys* _nas;
 211 };
 212 #endif
 213
 214 #endif // __NASALSYS_HXX