source: orxonox.OLD/trunk/src/lib/shell/shell.h @ 5480

/*!
 * @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 <stdarg.h>

#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.8f, 0.8f

// FORWARD DECLARATION
class Text;
class ShellInput;
class Material;
template<class T> class tIterator;

//! 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.
    tIterator<char>*         bufferIterator;         //!< used to move through and print the Buffer
};

#endif /* _SHELL_H */