Initial commit

Torque/SDK/engine/console/codeBlock.h

@@ -0,0 +1,129 @@
+//-----------------------------------------------------------------------------
+// Torque Game Engine 
+// Copyright (C) GarageGames.com, Inc.
+//-----------------------------------------------------------------------------
+
+#ifndef _CODEBLOCK_H_
+#define _CODEBLOCK_H_
+
+#include "console/compiler.h"
+#include "console/consoleParser.h"
+
+class Stream;
+
+/// Core TorqueScript code management class.
+///
+/// This class represents a block of code, usually mapped directly to a file.
+class CodeBlock
+{
+private:
+   static CodeBlock* smCodeBlockList;
+   static CodeBlock* smCurrentCodeBlock;
+   
+public:
+   static U32                       smBreakLineCount;
+   static bool                      smInFunction;
+   static Compiler::ConsoleParser * smCurrentParser;
+
+   static CodeBlock* getCurrentBlock()
+   {
+      return smCurrentCodeBlock;
+   }
+
+   static CodeBlock *getCodeBlockList()
+   {
+      return smCodeBlockList;
+   }
+
+   static StringTableEntry getCurrentCodeBlockName();
+   static CodeBlock *find(StringTableEntry);
+
+   CodeBlock();
+   ~CodeBlock();
+
+   StringTableEntry name;
+
+   char *globalStrings;
+   char *functionStrings;
+
+   F64 *globalFloats;
+   F64 *functionFloats;
+
+   U32 codeSize;
+   U32 *code;
+
+   U32 refCount;
+   U32 lineBreakPairCount;
+   U32 *lineBreakPairs;
+   U32 breakListSize;
+   U32 *breakList;
+   CodeBlock *nextFile;
+   StringTableEntry mRoot;
+
+
+   void addToCodeList();
+   void removeFromCodeList();
+   void calcBreakList();
+   void clearAllBreaks();
+   void setAllBreaks();
+
+   /// Returns the first breakable line or 0 if none was found.
+   /// @param lineNumber The one based line number.
+   U32 findFirstBreakLine(U32 lineNumber);
+
+   void clearBreakpoint(U32 lineNumber);
+
+   /// Set a OP_BREAK instruction on a line. If a break 
+   /// is not possible on that line it returns false.
+   /// @param lineNumber The one based line number.
+   bool setBreakpoint(U32 lineNumber);
+
+   void findBreakLine(U32 ip, U32 &line, U32 &instruction);
+   void getFunctionArgs(char buffer[1024], U32 offset);
+   const char *getFileLine(U32 ip);
+
+   bool read(StringTableEntry fileName, Stream &st);
+   bool compile(const char *dsoName, StringTableEntry fileName, const char *script);
+
+   void incRefCount();
+   void decRefCount();
+
+   /// Compiles and executes a block of script storing the compiled code in this
+   /// CodeBlock. If there is no filename breakpoints will not be generated and 
+   /// the CodeBlock will not be added to the linked list of loaded CodeBlocks. 
+   /// Note that if the script contains no executable statements the CodeBlock
+   /// will delete itself on return an empty string. The return string is any 
+   /// result of the code executed, if any, or an empty string.
+   ///
+   /// @param fileName The file name, including path and extension, for the 
+   /// block of code or an empty string.
+   /// @param script The script code to compile and execute.
+   /// @param noCalls Skips calling functions from the script.
+   /// @param setFrame A zero based index of the stack frame to execute the code 
+   /// with, zero being the top of the stack. If the the index is
+   /// -1 a new frame is created. If the index is out of range the
+   /// top stack frame is used.
+   const char *compileExec(StringTableEntry fileName, const char *script, 
+      bool noCalls, int setFrame = -1 );
+
+   /// Executes the existing code in the CodeBlock. The return string is any 
+   /// result of the code executed, if any, or an empty string.
+   ///
+   /// @param offset The instruction offset to start executing from.
+   /// @param fnName The name of the function to execute or null.
+   /// @param ns The namespace of the function to execute or null.
+   /// @param argc The number of parameters passed to the function or
+   /// zero to execute code outside of a function.
+   /// @param argv The function parameter list.
+   /// @param noCalls Skips calling functions from the script.
+   /// @param setFrame A zero based index of the stack frame to execute the code 
+   /// with, zero being the top of the stack. If the the index is
+   /// -1 a new frame is created. If the index is out of range the
+   /// top stack frame is used.
+   /// @param packageName The code package name or null.
+   const char *exec(U32 offset, const char *fnName, Namespace *ns, U32 argc, 
+      const char **argv, bool noCalls, StringTableEntry packageName, 
+      S32 setFrame = -1);
+};
+
+#endif