source: orxonox.OLD/branches/preferences/src/lib/shell/shell_input.h @ 6769

/*!
 * @file shell_input.h
 * @brief Shell Input is an InputLine for the Shell.
 *
 * @todo move around in the InputText with the cursor (SDLK_LEFT/SDLK_RIGHT)
 * @todo blinking curson (can blink with the speed of the RepeatDelay)
*/

#ifndef _SHELL_INPUT_H
#define _SHELL_INPUT_H

#include "text.h"
#include "event_listener.h"
#include <list>

// FORWARD DECLARATION
class ShellCompletion;

//! An InputLine for the Shell
/**
 * The ShellInput has the ability to catch and display user input.
 * The ShellInput is auto-completed after the user presses [TAB]
 * The ShellInput is executed (and sent back to the Application) on Pressing [ENTER]
 * [UP] and [DOWN] move through the history of allready given commands.
 */
class ShellInput : public Text,  public EventListener {

 public:
  ShellInput();
  virtual ~ShellInput();

  /** @returns the inputLine */
  const char* getInput() const { return this->inputLine; };

  // InputLine
  void flush();
  void setInputText(const char* text);
  void addCharacter(char character);
  void addCharacters(const char* characters);
  void removeCharacters(unsigned int characterCount = 1);
  void setRepeatDelay(float repeatDelay, float repeatRate);
  bool executeCommand();

  /** sets the count of the History's entries */
  void setHistoryLength(unsigned int historyLength) { this->historyLength = historyLength; };
  void historyMoveUp();
  void historyMoveDown();

  void help(const char* className = "", const char* function = "");

  virtual void tick(float dt);
  virtual void process(const Event &event);

 private:
    // HANDLING TEXT INPUT
   ShellCompletion*            completion;             //!< The Completion Interface.

   char*                       inputLine;              //!< the Char-Array of the Buffer
   float                       repeatRate;             //!< The Repeat-Delay.
   float                       repeatDelay;            //!< The delay of the first Character of a given Character.
   float                       delayed;                //!< how much of the delay is remaining.
   Uint16                      pressedKey;             //!< the pressed key that will be repeated.

   std::list<char*>            history;                //!< The history of given commands.
   std::list<char*>::iterator  historyIT;
   unsigned int                historyLength;          //!< The maximum length of the InputHistory.
   bool                        historyScrolling;       //!< true if we are scrolling through the history.
};

#endif /* _SHELL_INPUT_H */