/*! * @file shell.h * Definition of a on-screen-shell * * @todo Buffer Display in different Colors for different debug mode. * @todo choose color of the Font and the background. */ #ifndef _SHELL_H #define _SHELL_H #include "element_2d.h" #include "event_listener.h" #include #define SHELL_DEFAULT_FONT "fonts/dpquake_.ttf" #define SHELL_DEFAULT_TEXT_COLOR 1.0f, 0.0f, 0.0f, 1.0f #define SHELL_DEFAULT_BACKGROUND_COLOR 0.0f, 0.0f, 0.0f, 1.0f // FORWARD DECLARATION class Text; class ShellInput; class Material; //! A class that is able to redirect all output to a openGL-Shell, and that one can use to input some commands /** * the major idea is, that all the Output can be redirected to the Shell, * and does not have to be displayed to the opening Shell, this is good, * for developers using Windows, where all output is otherwise redirected * to stdout.txt * * Furthermore the Shell should enable us, to input some simple commands * Each Class can check itself in to the Shell, and listen for commands. * * more info: @see ShellCommand * @see shell_command.h * @see shell_buffer.h * @see shell_input.h * * !! note in order to keep shellbuffer to a minimal (it is included with * !! debug.h) Display of it inside the Shell is located here !! */ class Shell : public Element2D, public EventListener { public: Shell(); virtual ~Shell(); void activate(); void deactivate(); /** @returns true if the Shell is active, false otherwise. */ inline bool isActive() const { return this->bActive; }; void setFont(const char* fontFile); void setTextSize(unsigned int textSize, unsigned int lineSpacing = 1); void setTextColor(float r, float g, float b, float a); void setBackgroundColor(float r, float g, float b, float a); void setBackgroundImage(const char* fileName); void resetValues(); void rebuildText(); // BUFFERS void setBufferDisplaySize(unsigned int bufferDisplaySize); void printToDisplayBuffer(const char* text); void moveDisplayBuffer(int lineCount); void flush(); void clear(); // EventListener virtual void process(const Event &event); // Element2D-functions virtual void draw() const; void debug() const; private: // helpers // Vector calculateLinePosition(unsigned int lineNumber); // void testI (int i); // void testS (const char* s); // void testB (bool b); // void testF (float f); // void testSF (const char* s, float f); private: // GENERAL bool bActive; //!< If the shell is active. unsigned int shellHeight; //!< The hight of the Shell in Pixels. unsigned int lineSpacing; //!< The Spacing between lines. unsigned int textSize; //!< The size of the text. float textColor[4]; //!< The text's color [r,g,b,a]. char* fontFile; //!< The file containing the font. Material* backgroundMaterial; //!< A material for the background. // HANDLING TEXT INPUT ShellInput* shellInput; //!< The inputLine of the Shell. // BUFFER unsigned int bufferDisplaySize; //!< The Size of the Display-buffer, in lines (not in characters). Text** bufferText; //!< A list of stored bufferTexts for the display of the buffer. int bufferOffset; //!< how many lines from the bottom up we display the Buffer. std::list::const_iterator bufferIterator; //!< used to move through and print the Buffer }; #endif /* _SHELL_H */