aboutsummaryrefslogtreecommitdiff
path: root/engines/wintermute/wme_debugger.h
blob: 75f57339db9db64e0e822a073b2bba19ad0322d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
/* 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.
 *
 */

/*
 * This file is based on WME Lite.
 * http://dead-code.org/redir.php?target=wmelite
 * Copyright (c) 2011 Jan Nedoma
 */

#ifndef WME_DEBUGGER_H
#define WME_DEBUGGER_H

#ifdef SetProp
#undef SetProp
#endif

#include "engines/wintermute/dcscript.h"

namespace WinterMute {

class IWmeDebugClient;
class IWmeDebugObject;

//////////////////////////////////////////////////////////////////////////
typedef enum {
    WME_DBGPROP_NULL = 0,
    WME_DBGPROP_INT = 1,
    WME_DBGPROP_FLOAT = 2,
    WME_DBGPROP_BOOL = 3,
    WME_DBGPROP_STRING = 4,
    WME_DBGPROP_OBJECT = 5,
    WME_DBGPROP_NATIVE = 6,
    WME_DBGPROP_UNKNOWN = 7
}
EWmeDebuggerPropType;

//////////////////////////////////////////////////////////////////////////
typedef enum {
    WME_DBGVAR_GLOBAL = 0,
    WME_DBGVAR_SCRIPT = 1,
    WME_DBGVAR_SCOPE = 2
}
EWmeDebuggerVariableType;

//////////////////////////////////////////////////////////////////////////
class IWmeDebugScript {
public:
	virtual ~IWmeDebugScript() {}
	virtual int dbgGetLine() = 0;
	virtual const char *dbgGetFilename() = 0;
	virtual TScriptState dbgGetState() = 0;

	virtual int dbgGetNumBreakpoints() = 0;
	virtual int dbgGetBreakpoint(int index) = 0;

	virtual bool dbgSetTracingMode(bool isTracing) = 0;
	virtual bool dbgGetTracingMode() = 0;
};

//////////////////////////////////////////////////////////////////////////
class IWmeDebugProp {
public:
	virtual EWmeDebuggerPropType dbgGetType() = 0;

	virtual ~IWmeDebugProp() {}
	// getters
	virtual int dbgGetValInt() = 0;
	virtual double dbgGetValFloat() = 0;
	virtual bool dbgGetValBool() = 0;
	virtual const char *dbgGetValString() = 0;
	virtual IWmeDebugObject *dbgGetValNative() = 0;

	// setters
	virtual bool dbgSetVal(int value) = 0;
	virtual bool dbgSetVal(double value) = 0;
	virtual bool dbgSetVal(bool value) = 0;
	virtual bool dbgSetVal(const char *value) = 0;
	virtual bool dbgSetVal() = 0;

	// properties
	virtual int dbgGetNumProperties() = 0;
	virtual bool dbgGetProperty(int index, const char **name, IWmeDebugProp **value) = 0;

	virtual bool dbgGetDescription(char *buf, int bufSize) = 0;
};

//////////////////////////////////////////////////////////////////////////
class IWmeDebugObject {
public:
	virtual ~IWmeDebugObject() {}
	virtual const char *dbgGetNativeClass() = 0;
	virtual IWmeDebugProp *dbgGetProperty(const char *name) = 0;
};

//////////////////////////////////////////////////////////////////////////
class IWmeDebugClient {
public:
	virtual ~IWmeDebugClient() {}
	virtual bool onGameInit() = 0;
	virtual bool onGameShutdown() = 0;

	virtual bool onGameTick() = 0;

	virtual bool onLog(unsigned int errorCode, const char *text) = 0;

	virtual bool onScriptInit(IWmeDebugScript *script) = 0;
	virtual bool onScriptEventThreadInit(IWmeDebugScript *script, IWmeDebugScript *ParentScript, const char *EventName) = 0;
	virtual bool onScriptMethodThreadInit(IWmeDebugScript *script, IWmeDebugScript *ParentScript, const char *MethodName) = 0;
	virtual bool onScriptShutdown(IWmeDebugScript *script) = 0;
	virtual bool onScriptChangeLine(IWmeDebugScript *script, int Line) = 0;
	virtual bool onScriptChangeScope(IWmeDebugScript *script, unsigned int scopeID) = 0;
	virtual bool onScriptShutdownScope(IWmeDebugScript *script, unsigned int scopeID) = 0;

	virtual bool onVariableInit(EWmeDebuggerVariableType Type, IWmeDebugScript *script, unsigned int scopeID, IWmeDebugProp *variable, const char *variableName) = 0;
	virtual bool onVariableChangeValue(IWmeDebugProp *variable, IWmeDebugProp *value) = 0;

	virtual bool onScriptHitBreakpoint(IWmeDebugScript *script, int line) = 0;
};

//////////////////////////////////////////////////////////////////////////
class IWmeDebugServer {
public:
	virtual ~IWmeDebugServer() {}
	virtual bool attachClient(IWmeDebugClient *client) = 0;
	virtual bool detachClient(IWmeDebugClient *client) = 0;

	virtual bool queryData(IWmeDebugClient *client) = 0;

	virtual int getPropInt(const char *propName) = 0;
	virtual double getPropFloat(const char *propName) = 0;
	virtual const char *getPropString(const char *propName) = 0;
	virtual bool getPropBool(const char *propName) = 0;

	virtual bool setProp(const char *propName, int propValue) = 0;
	virtual bool setProp(const char *propName, double propValue) = 0;
	virtual bool setProp(const char *propName, const char *propValue) = 0;
	virtual bool setProp(const char *propName, bool propValue) = 0;

	virtual bool resolveFilename(const char *relativeFilename, char *absFilenameBuf, int absBufSize) = 0;

	virtual bool addBreakpoint(const char *scriptFilename, int line) = 0;
	virtual bool removeBreakpoint(const char *scriptFilename, int line) = 0;

	virtual bool continueExecution() = 0;
};


typedef bool (*WMEDBG_INITIALIZE)(IWmeDebugServer *Server);
typedef bool (*WMEDBG_SHUTDOWN)(IWmeDebugServer *Server);

} // end of namespace WinterMute

#endif // WME_DEBUGGER_H