RingRacers/libs/ACSVM/include/ACSVM/Thread.hpp

//-----------------------------------------------------------------------------
//
// Copyright (C) 2015-2017 David Hill
//
// See COPYING for license information.
//
//-----------------------------------------------------------------------------
//
// Thread classes.
//
//-----------------------------------------------------------------------------

#ifndef ACSVM__Thread_H__
#define ACSVM__Thread_H__

#include "List.hpp"
#include "PrintBuf.hpp"
#include "Stack.hpp"
#include "Store.hpp"


//----------------------------------------------------------------------------|
// Types                                                                      |
//

namespace ACSVM
{
   //
   // CallFrame
   //
   // Stores a call frame for execution.
   //
   class CallFrame
   {
   public:
      Word  const *codePtr;
      Module      *module;
      ModuleScope *scopeMod;
      std::size_t  locArrC;
      std::size_t  locRegC;
   };

   //
   // ThreadState
   //
   class ThreadState
   {
   public:
      enum State
      {
         Inactive, // Inactive thread.
         Running,  // Running.
         Stopped,  // Will go inactive on next exec.
         Paused,   // Paused by instruction.
         WaitScrI, // Waiting on a numbered script.
         WaitScrS, // Waiting on a named script.
         WaitTag,  // Waiting on tagged object.
      };


      ThreadState() : state{Inactive}, data{0}, type{0} {}
      ThreadState(State state_) :
         state{state_}, data{0}, type{0} {}
      ThreadState(State state_, Word data_) :
         state{state_}, data{data_}, type{0} {}
      ThreadState(State state_, Word data_, Word type_) :
         state{state_}, data{data_}, type{type_} {}

      bool operator == (State s) const {return state == s;}
      bool operator != (State s) const {return state != s;}

      State state;

      // Extra state data. Used by:
      //    WaitScrI - Script number.
      //    WaitScrS - Script name index.
      //    WaitTag  - Tag number.
      Word data;

      // Extra state data. Used by:
      //    WaitTag - Tag type.
      Word type;
   };

   //
   // ThreadInfo
   //
   // Derived classes can be used to pass extra information to started threads.
   //
   class ThreadInfo
   {
   public:
      virtual ~ThreadInfo() {}
   };

   //
   // Thread
   //
   class Thread
   {
   public:
      Thread(Environment *env);
      virtual ~Thread();

      void exec();

      virtual ThreadInfo const *getInfo() const;

      virtual void loadState(Serial &in);

      virtual void lockStrings() const;

      virtual void refStrings() const;

      virtual void saveState(Serial &out) const;

      virtual void start(Script *script, MapScope *map, ThreadInfo const *info,
         Word const *argV, Word argC);

      virtual void stop();

      virtual void unlockStrings() const;

      Environment *const env;

      ListLink<Thread> link;

      Stack<CallFrame> callStk;
      Stack<Word>      dataStk;
      Store<Array>     localArr;
      Store<Word>      localReg;
      PrintBuf         printBuf;
      ThreadState      state;

      Word  const *codePtr; // Instruction pointer.
      Module      *module;  // Current execution Module.
      GlobalScope *scopeGbl;
      HubScope    *scopeHub;
      MapScope    *scopeMap;
      ModuleScope *scopeMod;
      Script      *script;  // Current execution Script.
      Word         delay;   // Execution delay tics.
      Word         result;  // Code-defined thread result.


      static constexpr std::size_t CallStkSize =   8;
      static constexpr std::size_t DataStkSize = 256;

   private:
      CallFrame readCallFrame(Serial &in) const;

      void writeCallFrame(Serial &out, CallFrame const &in) const;
   };
}

#endif//ACSVM__Thread_H__