X-Git-Url: http://git.localhorst.tv/?a=blobdiff_plain;f=src%2Floader%2FInterpreter.h;h=6b3835a49ad3c270f2fc9530a71824fd6da6a577;hb=1970312e983541d32d4ff73c81b8d90156a7bb99;hp=c2fc25f84b6a1b6cb09edf1492e046f1e13c50d2;hpb=107b78b720db69ad402c09c0b1d9beb3b88a1952;p=l2e.git diff --git a/src/loader/Interpreter.h b/src/loader/Interpreter.h index c2fc25f..6b3835a 100644 --- a/src/loader/Interpreter.h +++ b/src/loader/Interpreter.h @@ -1,58 +1,209 @@ -/* - * Interpreter.h - * - * Created on: Aug 26, 2012 - * Author: holy - */ - #ifndef LOADER_INTERPRETER_H_ #define LOADER_INTERPRETER_H_ +#include "PagedAllocator.h" +#include "ParsedSource.h" +#include "../common/Script.h" + #include +#include #include #include #include - -namespace battle { - class Monster; -} +#include namespace loader { -class Definition; -class ParsedSource; -class PropertyList; - class Interpreter { public: + static const int BOOLEAN_ID = 1; + static const int COLOR_ID = 2; + static const int IMAGE_ID = 3; + static const int NUMBER_ID = 4; + static const int PATH_ID = 5; + static const int SCRIPT_ID = 6; + static const int STRING_ID = 7; + static const int VECTOR_ID = 8; + + /// Instances of this class are thrown if an + /// interpretation error is encounteres such as a + /// reference to an undeclared or inlining of an undefined + /// object. class Error: public std::runtime_error { public: - Error(const std::string &msg) : std::runtime_error("interpreter error: " + msg) { } + Error(const std::string &msg) + : std::runtime_error("interpreter error: " + msg) { } }; public: - Interpreter(const ParsedSource &source) : source(source) { } - ~Interpreter() { } + /// Create an interpreter that rads from given parsed + /// source. + /// After creation you should call ReadSource() before + /// querying e.g. with GetObject(). + explicit Interpreter(const ParsedSource &source) + : source(source), alloc(4096) { } + ~Interpreter(); private: Interpreter(const Interpreter &); Interpreter &operator =(const Interpreter &); public: + /// Interpret all exported definitions of the underlying + /// source file. void ReadSource(); + /// Get an object of given type that is defined by given + /// name. + /// If the object identified by name is of another type, + /// a cast is performed for compatible types. + /// Error is thrown if the object is undefined or a cast + /// was unsuccessful. + void *GetObject(int typeId, const std::string &name); + const void *GetObject(int typeId, const std::string &name) const; + + /// Register the type descriptions of builtin types. + /// This should be called before any interpretation (like + /// calling ReadSource()) is performed. + static void CreateTypeDescriptions(); + /// Represents a parsed definition with resulting type and + /// object IDs. + struct ParsedDefinition { + ParsedDefinition(const Definition *dfn, int type, int id) + : dfn(dfn), type(type), id(id) { } + const Definition *dfn; + int type; + int id; + }; + /// Represents a postponed object where the type and + /// target location are already known, but the definition + /// was not accessible at interpretation time. + /// It could become available later or be dynamically + /// linked by its identifier. + struct PostponedDefinition { + PostponedDefinition( + char *object, + char *dest, + const std::string &identifier, + int type, + bool inlined, + bool aggregate) + : object(object) + , dest(dest) + , identifier(identifier) + , type(type) + , inlined(inlined) + , aggregate(aggregate) { } + char *object; + char *dest; + std::string identifier; + int type; + bool inlined; + bool aggregate; + }; + + /// Get all the identifiers that are marked for export + /// by name in the source. + const std::set &ExportedIdentifiers() const { + return source.Exports(); + } + /// Get the object definition for given identifier. + const ParsedDefinition &GetDefinition(const std::string &identifier); + const ParsedDefinition &GetDefinition(const std::string &identifier) const; + /// Get all images reference by he source. + /// The returned map is indexed by filenames relative to + /// the source file and contains ready-to-blit surfaces. + const std::map &Images() const { + return imageCache; + } + const std::string &FindImage(SDL_Surface *) const; + /// Get all definitions that were postponed because they + /// were not in the parsed source. + const std::vector &PostponedDefinitions() const { + return postponedDefinitions; + } + /// A map of object id to object. + const std::map > &Values() const { + return values; + } + struct Array { + void *data; + unsigned int typeId; + unsigned int size; + bool ref; + }; + const std::vector &Arrays() const { + return arrays; + } private: + /// Interpret given definition. + void ReadDefinition(const Definition &); + /// Interpret given definition as a literal. void ReadLiteral(const Definition &); + /// Interpret given definition as a complex object. void ReadObject(const Definition &); - void ReadMonster(battle::Monster &, const PropertyList &); + /// Interpret given literal as an object of given type. + /// The resulting object shall be accessible by given ID + /// (whiich is already reserved) and be written to given + /// destination. + void ReadLiteral(int typeId, int id, char *dest, const Literal &); + /// Get an object of given type from given value. + /// The object will be registere as new and be given a + /// unique ID. + /// Any nested objects will be created likewise. + void *GetObject(int typeId, const Value &value); + /// Read an object of given type and properties into dest. + /// The object should alrady have an assigned identifier. + /// Pass -1 as ID if the object is anonymous. + /// Note that anonymous objects must not contain + /// references as they are excluded from linking. + void ReadObject(int typeId, int id, char *dest, const PropertyList &); + /// The function that does the actual compiling when you + /// call ReadScript(const vector &). + void ReadScript(const std::vector &, common::Script *); + /// Compile a tokenized script. + /// Storage for the script will be allocated as neccessary. + char *ReadScript(const std::vector &); + /// Reinterpret dest as a script code and return a + /// reference to that. + common::Script::Code &CreateScriptCode(common::Script::Command c, char *dest); + /// Write address to dest. + void ReadScriptAddress(const ScriptToken &t, char *dest); + /// Write integer to est. + void ReadScriptInteger(const ScriptToken &t, char *dest); + /// Write vector to dest. + void ReadScriptVector(const ScriptToken &t, char *dest); + + /// Get a surface from given image path. + /// Load it if neccessary. + SDL_Surface *GetImage(const std::string &); + + /// Check if a value can be linked right now or if linkage + /// must be deferred (with Postpone()). + bool CanLink(const Value &) const; + /// Defer linking of given object reference. + void Postpone( + char *object, + char *dest, + const std::string &identifier, + int type, + bool inlined = true, + bool aggregate = false); private: const ParsedSource &source; - std::vector monsters; + + PagedAllocator alloc; + + std::map parsedDefinitions; + std::vector postponedDefinitions; + std::map imageCache; + std::map > values; + std::vector arrays; }; } -#endif /* LOADER_INTERPRETER_H_ */ +#endif