/* ScummVM - Graphic Adventure Engine * * ScummVM is the legal property of its developers, whose names * are too numerous to list here. Please refer to the COPYRIGHT * file distributed with this source distribution. * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * * $URL$ * $Id$ */ #ifndef GUI_DEBUGGER_H #define GUI_DEBUGGER_H #include "common/func.h" #include "common/ptr.h" #include "common/hashmap.h" #include "common/hash-str.h" namespace GUI { #ifndef USE_TEXT_CONSOLE class ConsoleDialog; #endif class Debugger { public: Debugger(); virtual ~Debugger(); int DebugPrintf(const char *format, ...); virtual void onFrame(); virtual void attach(const char *entry = 0); bool isAttached() const { return _isAttached; } protected: typedef Common::Functor2 Debuglet; // Convenience macro for registering a method of a debugger class // as the current command. #define WRAP_METHOD(cls, method) \ new Common::Functor2Mem(this, &cls::method) enum { DVAR_BYTE, DVAR_INT, DVAR_BOOL, DVAR_INTARRAY, DVAR_STRING }; struct DVar { Common::String name; void *variable; int type; int optional; }; int _frame_countdown; bool _detach_now; private: Common::Array _dvars; typedef Common::HashMap, Common::IgnoreCase_Hash, Common::IgnoreCase_EqualTo> CommandsMap; CommandsMap _cmds; bool _isAttached; char *_errStr; bool _firstTime; #ifndef USE_TEXT_CONSOLE GUI::ConsoleDialog *_debuggerDialog; #endif protected: // Hook for subclasses: Called just before enter() is run virtual void preEnter() {} // Hook for subclasses: Called just after enter() was run virtual void postEnter() {} // Hook for subclasses: Process the given command line. // Should return true if and only if argv[0] is a known command and was // handled, false otherwise. virtual bool handleCommand(int argc, const char **argv, bool &keepRunning); private: void detach(); void enter(); bool parseCommand(const char *input); bool tabComplete(const char *input, Common::String &completion) const; protected: void DVar_Register(const Common::String &varname, void *pointer, int type, int optional); void DCmd_Register(const Common::String &cmdname, Debuglet *debuglet); bool Cmd_Exit(int argc, const char **argv); bool Cmd_Help(int argc, const char **argv); bool Cmd_DebugFlagsList(int argc, const char **argv); bool Cmd_DebugFlagEnable(int argc, const char **argv); bool Cmd_DebugFlagDisable(int argc, const char **argv); #ifndef USE_TEXT_CONSOLE private: static bool debuggerInputCallback(GUI::ConsoleDialog *console, const char *input, void *refCon); static bool debuggerCompletionCallback(GUI::ConsoleDialog *console, const char *input, Common::String &completion, void *refCon); #elif defined(USE_READLINE) public: char *readlineComplete(const char *input, int state); #endif }; } // End of namespace GUI #endif