src/console.cpp

   1 //  $Id$
   2 //
   3 //  SuperTux - Console
   4 //  Copyright (C) 2006 Christoph Sommer <christoph.sommer@2006.expires.deltadevelopment.de>
   5 //
   6 //  This program is free software; you can redistribute it and/or
   7 //  modify it under the terms of the GNU General Public License
   8 //  as published by the Free Software Foundation; either version 2
   9 //  of the License, or (at your option) any later version.
  10 //
  11 //  This program is distributed in the hope that it will be useful,
  12 //  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 //  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 //  GNU General Public License for more details.
  15 //
  16 //  You should have received a copy of the GNU General Public License
  17 //  along with this program; if not, write to the Free Software
  18 //  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  19 #include <config.h>
  20
  21 #include <iostream>
  22 #include "console.hpp"
  23 #include "video/drawing_context.hpp"
  24 #include "video/surface.hpp"
  25 #include "scripting/squirrel_error.hpp"
  26 #include "scripting/squirrel_util.hpp"
  27 #include "physfs/physfs_stream.hpp"
  28 #include "player_status.hpp"
  29 #include "main.hpp"
  30 #include "log.hpp"
  31 #include "resources.hpp"
  32
  33 /// speed (pixels/s) the console closes
  34 static const float FADE_SPEED = 1;
  35
  36 Console::Console()
  37   : history_position(history.end()), vm(NULL), backgroundOffset(0),
  38     height(0), alpha(1.0), offset(0), focused(false), stayOpen(0) {
  39   fontheight = 8;
  40 }
  41
  42 Console::~Console()
  43 {
  44   if(vm != NULL) {
  45     sq_release(Scripting::global_vm, &vm_object);
  46   }
  47 }
  48
  49 void
  50 Console::init_graphics()
  51 {
  52   font.reset(new Font("images/engine/fonts/white-small.png",
  53                       "images/engine/fonts/shadow-small.png", 8, 9, 1));
  54   fontheight = font->get_height();
  55   background.reset(new Surface("images/engine/console.png"));
  56   background2.reset(new Surface("images/engine/console2.png"));
  57 }
  58
  59 void
  60 Console::flush(ConsoleStreamBuffer* buffer)
  61 {
  62   if (buffer == &outputBuffer) {
  63     std::string s = outputBuffer.str();
  64     if ((s.length() > 0) && ((s[s.length()-1] == '\n') || (s[s.length()-1] == '\r'))) {
  65       while ((s[s.length()-1] == '\n') || (s[s.length()-1] == '\r')) s.erase(s.length()-1);
  66       addLines(s);
  67       outputBuffer.str(std::string());
  68     }
  69   }
  70   if (buffer == &inputBuffer) {
  71     std::string s = inputBuffer.str();
  72     if ((s.length() > 0) && ((s[s.length()-1] == '\n') || (s[s.length()-1] == '\r'))) {
  73       while ((s[s.length()-1] == '\n') || (s[s.length()-1] == '\r')) s.erase(s.length()-1);
  74       addLines("> "+s);
  75       parse(s);
  76       inputBuffer.str(std::string());
  77     }
  78   }
  79 }
  80
  81 void
  82 Console::ready_vm()
  83 {
  84   if(vm == NULL) {
  85     vm = Scripting::global_vm;
  86     HSQUIRRELVM new_vm = sq_newthread(vm, 16);
  87     if(new_vm == NULL)
  88       throw Scripting::SquirrelError(vm, "Couldn't create new VM thread for console");
  89
  90     // store reference to thread
  91     sq_resetobject(&vm_object);
  92     if(SQ_FAILED(sq_getstackobj(vm, -1, &vm_object)))
  93       throw Scripting::SquirrelError(vm, "Couldn't get vm object for console");
  94     sq_addref(vm, &vm_object);
  95     sq_pop(vm, 1);
  96
  97     // create new roottable for thread
  98     sq_newtable(new_vm);
  99     sq_pushroottable(new_vm);
 100     if(SQ_FAILED(sq_setdelegate(new_vm, -2)))
 101       throw Scripting::SquirrelError(new_vm, "Couldn't set console_table delegate");
 102
 103     sq_setroottable(new_vm);
 104
 105     vm = new_vm;
 106
 107     try {
 108       std::string filename = "scripts/console.nut";
 109       IFileStream stream(filename);
 110       Scripting::compile_and_run(vm, stream, filename);
 111     } catch(std::exception& e) {
 112       log_warning << "Couldn't load console.nut: " << e.what() << std::endl;
 113     }
 114   }
 115 }
 116
 117 void
 118 Console::execute_script(const std::string& command)
 119 {
 120   using namespace Scripting;
 121
 122   ready_vm();
 123
 124   SQInteger oldtop = sq_gettop(vm);
 125   try {
 126     if(SQ_FAILED(sq_compilebuffer(vm, command.c_str(), command.length(),
 127                  "", SQTrue)))
 128       throw SquirrelError(vm, "Couldn't compile command");
 129
 130     sq_pushroottable(vm);
 131     if(SQ_FAILED(sq_call(vm, 1, SQTrue, SQTrue)))
 132       throw SquirrelError(vm, "Problem while executing command");
 133
 134     if(sq_gettype(vm, -1) != OT_NULL)
 135       addLines(squirrel2string(vm, -1));
 136   } catch(std::exception& e) {
 137     addLines(e.what());
 138   }
 139   SQInteger newtop = sq_gettop(vm);
 140   if(newtop < oldtop) {
 141     log_fatal << "Script destroyed squirrel stack..." << std::endl;
 142   } else {
 143     sq_settop(vm, oldtop);
 144   }
 145 }
 146
 147 void
 148 Console::backspace()
 149 {
 150   std::string s = inputBuffer.str();
 151   if (s.length() > 0) {
 152     s.erase(s.length()-1);
 153     inputBuffer.str(s);
 154     inputBuffer.pubseekoff(0, std::ios_base::end, std::ios_base::out);
 155   }
 156 }
 157
 158 void
 159 Console::scroll(int numLines)
 160 {
 161   offset += numLines;
 162   if (offset > 0) offset = 0;
 163 }
 164
 165 void
 166 Console::show_history(int offset)
 167 {
 168   while ((offset > 0) && (history_position != history.end())) {
 169     history_position++;
 170     offset--;
 171   }
 172   while ((offset < 0) && (history_position != history.begin())) {
 173     history_position--;
 174     offset++;
 175   }
 176   if (history_position == history.end()) {
 177     inputBuffer.str(std::string());
 178   } else {
 179     inputBuffer.str(*history_position);
 180     inputBuffer.pubseekoff(0, std::ios_base::end, std::ios_base::out);
 181   }
 182 }
 183
 184 void
 185 Console::autocomplete()
 186 {
 187   std::string cmdPart = inputBuffer.str();
 188   addLines("> "+cmdPart);
 189
 190   std::string cmdList = "";
 191   int cmdListLen = 0;
 192
 193   // append all known CCRs to cmdList
 194   for (std::map<std::string, std::list<ConsoleCommandReceiver*> >::iterator i = commands.begin(); i != commands.end(); i++) {
 195     std::string cmdKnown = i->first;
 196     if (cmdKnown.substr(0, cmdPart.length()) == cmdPart) {
 197       if (cmdListLen > 0) cmdList = cmdList + ", ";
 198       cmdList = cmdList + cmdKnown;
 199       cmdListLen++;
 200     }
 201   }
 202
 203   ready_vm();
 204
 205   // append all keys of the current root table to cmdList
 206   sq_pushroottable(vm); // push root table
 207   sq_pushnull(vm); // push null
 208   while (SQ_SUCCEEDED(sq_next(vm,-2))) {
 209     const SQChar* s;
 210     if (SQ_FAILED(sq_getstring(vm, -2, &s))) {
 211       log_warning << "Could not get string for table entry, skipping." << std::endl;
 212     } else {
 213       std::string cmdKnown = s;
 214       if (cmdKnown.substr(0, cmdPart.length()) == cmdPart) {
 215         if (cmdListLen > 0) cmdList = cmdList + ", ";
 216         cmdList = cmdList + cmdKnown;
 217         cmdListLen++;
 218       }
 219     }
 220     sq_pop(vm,2); // pop key, val
 221   }
 222   sq_pop(vm,1); // pop null
 223   sq_pop(vm,1); // pop root table
 224
 225   // depending on number of hits, show matches or autocomplete
 226   if (cmdListLen == 0) addLines("No known command starts with \""+cmdPart+"\"");
 227   if (cmdListLen == 1) {
 228     inputBuffer.str(cmdList);
 229     inputBuffer.pubseekoff(0, std::ios_base::end, std::ios_base::out);
 230   }
 231   if (cmdListLen > 1) addLines(cmdList);
 232 }
 233
 234 void
 235 Console::addLines(std::string s)
 236 {
 237   std::istringstream iss(s);
 238   std::string line;
 239   while (std::getline(iss, line, '\n')) addLine(line);
 240 }
 241
 242 void
 243 Console::addLine(std::string s)
 244 {
 245   // output line to stderr
 246   std::cerr << s << std::endl;
 247
 248   // wrap long lines
 249   std::string overflow;
 250   do {
 251     lines.push_front(Font::wrap_to_chars(s, 99, &overflow));
 252     s = overflow;
 253   } while (s.length() > 0);
 254
 255   // trim scrollback buffer
 256   while (lines.size() >= 1000)
 257     lines.pop_back();
 258
 259   // increase console height if necessary
 260   if (height < 64) {
 261     if(height < 4)
 262       height = 4;
 263     height += fontheight;
 264   }
 265
 266   // reset console to full opacity
 267   alpha = 1.0;
 268
 269   // increase time that console stays open
 270   if(stayOpen < 6)
 271     stayOpen += 1.5;
 272 }
 273
 274 void
 275 Console::parse(std::string s)
 276 {
 277   // make sure we actually have something to parse
 278   if (s.length() == 0) return;
 279
 280   // add line to history
 281   history.push_back(s);
 282   history_position = history.end();
 283
 284   // split line into list of args
 285   std::vector<std::string> args;
 286   size_t start = 0;
 287   size_t end = 0;
 288   while (1) {
 289     start = s.find_first_not_of(" ,", end);
 290     end = s.find_first_of(" ,", start);
 291     if (start == s.npos) break;
 292     args.push_back(s.substr(start, end-start));
 293   }
 294
 295   // command is args[0]
 296   if (args.size() == 0) return;
 297   std::string command = args.front();
 298   args.erase(args.begin());
 299
 300   // ignore if it's an internal command
 301   if (consoleCommand(command,args)) return;
 302
 303   // look up registered ccr
 304   std::map<std::string, std::list<ConsoleCommandReceiver*> >::iterator i = commands.find(command);
 305   if ((i == commands.end()) || (i->second.size() == 0)) {
 306     try {
 307       execute_script(s);
 308     } catch(std::exception& e) {
 309       addLines(e.what());
 310     }
 311     return;
 312   }
 313
 314   // send command to the most recently registered ccr
 315   ConsoleCommandReceiver* ccr = i->second.front();
 316   if (ccr->consoleCommand(command, args) != true) log_warning << "Sent command to registered ccr, but command was unhandled" << std::endl;
 317 }
 318
 319 bool
 320 Console::consoleCommand(std::string command, std::vector<std::string> arguments)
 321 {
 322   if (command == "ccrs") {
 323     if (arguments.size() != 1) {
 324       log_info << "Usage: ccrs <command>" << std::endl;
 325       return true;
 326     }
 327     std::map<std::string, std::list<ConsoleCommandReceiver*> >::iterator i = commands.find(arguments[0]);
 328     if ((i == commands.end()) || (i->second.size() == 0)) {
 329       log_info << "unknown command: \"" << arguments[0] << "\"" << std::endl;
 330       return true;
 331     }
 332
 333     std::ostringstream ccr_list;
 334     std::list<ConsoleCommandReceiver*> &ccrs = i->second;
 335     std::list<ConsoleCommandReceiver*>::iterator j;
 336     for (j = ccrs.begin(); j != ccrs.end(); j++) {
 337       if (j != ccrs.begin()) ccr_list << ", ";
 338       ccr_list << "[" << *j << "]";
 339     }
 340
 341     log_info << "registered ccrs for \"" << arguments[0] << "\": " << ccr_list.str() << std::endl;
 342     return true;
 343   }
 344
 345   return false;
 346 }
 347
 348 bool
 349 Console::hasFocus()
 350 {
 351   return focused;
 352 }
 353
 354 void
 355 Console::show()
 356 {
 357   focused = true;
 358   height = 256;
 359   alpha = 1.0;
 360 }
 361
 362 void
 363 Console::hide()
 364 {
 365   focused = false;
 366   height = 0;
 367   stayOpen = 0;
 368
 369   // clear input buffer
 370   inputBuffer.str(std::string());
 371 }
 372
 373 void
 374 Console::toggle()
 375 {
 376   if (Console::hasFocus()) {
 377     Console::hide();
 378   }
 379   else {
 380     Console::show();
 381   }
 382 }
 383
 384 void
 385 Console::update(float elapsed_time)
 386 {
 387   if(stayOpen > 0) {
 388     stayOpen -= elapsed_time;
 389     if(stayOpen < 0)
 390       stayOpen = 0;
 391   } else if(!focused && height > 0) {
 392     alpha -= elapsed_time * FADE_SPEED;
 393     if(alpha < 0) {
 394       alpha = 0;
 395       height = 0;
 396     }
 397   }
 398 }
 399
 400 void
 401 Console::draw(DrawingContext& context)
 402 {
 403   if (height == 0)
 404     return;
 405
 406   int layer = LAYER_GUI + 1;
 407
 408   context.push_transform();
 409   context.set_alpha(alpha);
 410   context.draw_surface(background2.get(), Vector(SCREEN_WIDTH/2 - background->get_width()/2 - background->get_width() + backgroundOffset, height - background->get_height()), layer);
 411   context.draw_surface(background2.get(), Vector(SCREEN_WIDTH/2 - background->get_width()/2 + backgroundOffset, height - background->get_height()), layer);
 412   context.draw_surface(background.get(), Vector(SCREEN_WIDTH/2 - background->get_width()/2, height - background->get_height()), layer);
 413   backgroundOffset+=10;
 414   if (backgroundOffset > (int)background->get_width()) backgroundOffset -= (int)background->get_width();
 415
 416   int lineNo = 0;
 417
 418   if (focused) {
 419     lineNo++;
 420     float py = height-4-1*9;
 421     context.draw_text(font.get(), "> "+inputBuffer.str()+"_", Vector(4, py), LEFT_ALLIGN, layer);
 422   }
 423
 424   int skipLines = -offset;
 425   for (std::list<std::string>::iterator i = lines.begin(); i != lines.end(); i++) {
 426     if (skipLines-- > 0) continue;
 427     lineNo++;
 428     float py = height-4-lineNo*9;
 429     if (py < -9) break;
 430     context.draw_text(font.get(), *i, Vector(4, py), LEFT_ALLIGN, layer);
 431   }
 432
 433   context.pop_transform();
 434 }
 435
 436 void
 437 Console::registerCommand(std::string command, ConsoleCommandReceiver* ccr)
 438 {
 439   commands[command].push_front(ccr);
 440 }
 441
 442 void
 443 Console::unregisterCommand(std::string command, ConsoleCommandReceiver* ccr)
 444 {
 445   std::map<std::string, std::list<ConsoleCommandReceiver*> >::iterator i = commands.find(command);
 446   if ((i == commands.end()) || (i->second.size() == 0)) {
 447     log_warning << "Command \"" << command << "\" not associated with a command receiver. Not dissociated." << std::endl;
 448     return;
 449   }
 450   std::list<ConsoleCommandReceiver*>::iterator j = find(i->second.begin(), i->second.end(), ccr);
 451   if (j == i->second.end()) {
 452     log_warning << "Command \"" << command << "\" not associated with given command receiver. Not dissociated." << std::endl;
 453     return;
 454   }
 455   i->second.erase(j);
 456 }
 457
 458 void
 459 Console::unregisterCommands(ConsoleCommandReceiver* ccr)
 460 {
 461   for (std::map<std::string, std::list<ConsoleCommandReceiver*> >::iterator i = commands.begin(); i != commands.end(); i++) {
 462     std::list<ConsoleCommandReceiver*> &ccrs = i->second;
 463     std::list<ConsoleCommandReceiver*>::iterator j;
 464     while ((j = find(ccrs.begin(), ccrs.end(), ccr)) != ccrs.end()) {
 465       ccrs.erase(j);
 466     }
 467   }
 468 }
 469
 470 Console* Console::instance = NULL;
 471 ConsoleStreamBuffer Console::inputBuffer;
 472 ConsoleStreamBuffer Console::outputBuffer;
 473 std::ostream Console::input(&Console::inputBuffer);
 474 std::ostream Console::output(&Console::outputBuffer);
 475