X-Git-Url: http://git.localhorst.tv/?a=blobdiff_plain;f=src%2Floader%2FInterpreter.h;h=3e9f661e56ccb53da7f5637315c5b1f5e5b9e1a4;hb=8c8061a4f8b88410d6d93c039afe6affc4b69cf2;hp=a32b3cad6d4c8a90cd8401f25c868955c2dd23fc;hpb=4634bd26d24a163b7128df7dd5183fcb2cdc8031;p=l2e.git diff --git a/src/loader/Interpreter.h b/src/loader/Interpreter.h index a32b3ca..3e9f661 100644 --- a/src/loader/Interpreter.h +++ b/src/loader/Interpreter.h @@ -1,120 +1,207 @@ -/* - * Interpreter.h - * - * Created on: Aug 26, 2012 - * Author: holy - */ - #ifndef LOADER_INTERPRETER_H_ #define LOADER_INTERPRETER_H_ -#include "../geometry/Vector.h" -#include "../graphics/ComplexAnimation.h" +#include "PagedAllocator.h" +#include "ParsedSource.h" +#include "../common/Script.h" #include +#include #include #include #include #include -namespace battle { - class Hero; - class Monster; - class Stats; -} - -namespace graphics { - class Animation; - class SimpleAnimation; - class Sprite; -} - namespace loader { -class Definition; -class ParsedSource; -class PropertyList; -class Value; - 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) { } + /// 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; + }; -public: - graphics::Animation *GetAnimation(const std::string &name); - battle::Hero *GetHero(const std::string &name); - battle::Monster *GetMonster(const std::string &name); - int GetNumber(const std::string &name) const; - graphics::Sprite *GetSprite(const std::string &name); + /// 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; + } + /// 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 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 &); - graphics::Animation *GetAnimation(const Value &); - const std::vector &GetValueArray(const Value &); - const std::vector &GetPropertyListArray(const Value &); - bool GetBoolean(const Value &); - SDL_Surface *GetImage(const Value &); - int GetNumber(const Value &); - const PropertyList *GetPropertyList(const Value &); - graphics::Sprite *GetSprite(const Value &); - const char *GetString(const Value &); - geometry::Vector GetVector(const Value &); - - void ReadComplexAnimation(graphics::ComplexAnimation &, const PropertyList &); - void ReadComplexAnimationFrame(graphics::ComplexAnimation::FrameProp &, const PropertyList &); - void ReadHero(battle::Hero &, const PropertyList &); - void ReadMonster(battle::Monster &, const PropertyList &); - void ReadSimpleAnimation(graphics::SimpleAnimation &, const PropertyList &); - void ReadSprite(graphics::Sprite &, const PropertyList &); - void ReadStats(battle::Stats &, 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; - enum DynamicType { - ANIMATION, - COMPLEX_ANIMATION, - HERO, - MONSTER, - NUMBER, - SIMPLE_ANIMATION, - SPRITE, - }; - struct ParsedDefinition { - ParsedDefinition(const Definition *dfn, DynamicType type, int index) - : dfn(dfn), type(type), index(index) { } - bool IsCompatible(DynamicType with) const; - const Definition *dfn; - DynamicType type; - int index; - }; - std::map parsedDefinitions; - std::vector animations; - std::vector heroes; - std::vector images; - std::vector monsters; - std::vector numbers; - std::vector sprites; + PagedAllocator alloc; + + std::map parsedDefinitions; + std::vector postponedDefinitions; + std::map imageCache; + std::map > values; + std::vector arrays; }; } -#endif /* LOADER_INTERPRETER_H_ */ +#endif