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

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

#define         SHELL_DEFAULT_FONT              "fonts/final_frontier.ttf"
#define         SHELL_DEFAULT_TEXT_COLOR        0.0f, 1.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;

namespace OrxShell
{
  //! 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 std::string& 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 std::string& fileName);

    // BUFFERS
    void setBufferDisplaySize(unsigned int bufferDisplaySize);
    void printToDisplayBuffer(const std::string& 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:
    void resetValues();
    void resetText(Text* text, unsigned int position);
    // helpers //
    Vector2D calculateLinePosition(unsigned int lineNumber);

    //     void testI (int i);
    //     void testS (const std::string& s);
    //     void testB (bool b);
    //     void testF (float f);
    //     void testSF (const std::string& 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].
    std::string                 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).
    std::list<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<std::string>::const_iterator  bufferIterator;         //!< used to move through and print the Buffer
  };

}

#endif /* _SHELL_H */