File: plugin_base.h

package info (click to toggle)
scummvm 2.9.1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 450,580 kB
  • sloc: cpp: 4,299,825; asm: 28,322; python: 12,901; sh: 11,302; java: 9,289; xml: 7,895; perl: 2,639; ansic: 2,465; yacc: 1,670; javascript: 1,020; makefile: 933; lex: 578; awk: 275; objc: 82; sed: 11; php: 1
file content (239 lines) | stat: -rw-r--r-- 7,018 bytes parent folder | download | duplicates (3)
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
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
/* 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 3 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, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef AGS_PLUGINS_PLUGIN_BASE_H
#define AGS_PLUGINS_PLUGIN_BASE_H

#include "ags/shared/util/string.h"
#include "common/hashmap.h"
#include "common/hash-str.h"
#include "common/textconsole.h"

namespace AGS3 {

class IAGSEditor;
class IAGSEngine;

namespace Plugins {

#define SCRIPT_METHOD(NAME, PROC) addMethod(#NAME, &PROC)

#define SCRIPT_HASH_MACRO(TheClass, BaseClass, RegisterMethod) \
	private: \
		typedef void (TheClass::*MethodPtr)(ScriptMethodParams &params); \
		Common::HashMap<Common::String, MethodPtr> _methods; \
		inline void addMethod(const Common::String &name, MethodPtr fn) { \
			_methods[name] = fn; \
			_engine->RegisterMethod(name.c_str(), this); \
		} \
	public: \
		void execMethod(const Common::String &name, ScriptMethodParams &params) override { \
			if (_methods.contains(name)) \
				(this->*_methods[name])(params); \
			else \
				BaseClass::execMethod(name, params); \
		}
#define SCRIPT_HASH(TheClass) SCRIPT_HASH_MACRO(TheClass, PluginBase, RegisterScriptFunction)
#define BUILT_IN_HASH(TheClass) SCRIPT_HASH_MACRO(TheClass, ScriptContainer, RegisterBuiltInFunction)
#define SCRIPT_HASH_SUB(TheClass, BaseClass) SCRIPT_HASH_MACRO(TheClass, BaseClass, RegisterScriptFunction)

inline float PARAM_TO_FLOAT(int32 xi) {
	float x;
	memcpy(&x, &xi, sizeof(float));
	return x;
}

inline int32 PARAM_FROM_FLOAT(float x) {
	int32 xi;
	memcpy(&xi, &x, sizeof(float));
	return xi;
}

#define PARAMS1(T1, N1) \
	T1 N1 = (T1)params[0]
#define PARAMS2(T1, N1, T2, N2) \
	T1 N1 = (T1)params[0]; \
	T2 N2 = (T2)params[1]
#define PARAMS3(T1, N1, T2, N2, T3, N3) \
	T1 N1 = (T1)params[0]; \
	T2 N2 = (T2)params[1]; \
	T3 N3 = (T3)params[2]
#define PARAMS4(T1, N1, T2, N2, T3, N3, T4, N4) \
	T1 N1 = (T1)params[0]; \
	T2 N2 = (T2)params[1]; \
	T3 N3 = (T3)params[2]; \
	T4 N4 = (T4)params[3]
#define PARAMS5(T1, N1, T2, N2, T3, N3, T4, N4, T5, N5) \
	T1 N1 = (T1)params[0]; \
	T2 N2 = (T2)params[1]; \
	T3 N3 = (T3)params[2]; \
	T4 N4 = (T4)params[3]; \
	T5 N5 = (T5)params[4]
#define PARAMS6(T1, N1, T2, N2, T3, N3, T4, N4, T5, N5, T6, N6) \
	T1 N1 = (T1)params[0]; \
	T2 N2 = (T2)params[1]; \
	T3 N3 = (T3)params[2]; \
	T4 N4 = (T4)params[3]; \
	T5 N5 = (T5)params[4]; \
	T6 N6 = (T6)params[5]
#define PARAMS7(T1, N1, T2, N2, T3, N3, T4, N4, T5, N5, T6, N6, T7, N7) \
	T1 N1 = (T1)params[0]; \
	T2 N2 = (T2)params[1]; \
	T3 N3 = (T3)params[2]; \
	T4 N4 = (T4)params[3]; \
	T5 N5 = (T5)params[4]; \
	T6 N6 = (T6)params[5]; \
	T7 N7 = (T7)params[6]
#define PARAMS8(T1, N1, T2, N2, T3, N3, T4, N4, T5, N5, T6, N6, T7, N7, T8, N8) \
	T1 N1 = (T1)params[0]; \
	T2 N2 = (T2)params[1]; \
	T3 N3 = (T3)params[2]; \
	T4 N4 = (T4)params[3]; \
	T5 N5 = (T5)params[4]; \
	T6 N6 = (T6)params[5]; \
	T7 N7 = (T7)params[6]; \
	T8 N8 = (T8)params[7]
#define PARAMS9(T1, N1, T2, N2, T3, N3, T4, N4, T5, N5, T6, N6, T7, N7, T8, N8, T9, N9) \
	T1 N1 = (T1)params[0]; \
	T2 N2 = (T2)params[1]; \
	T3 N3 = (T3)params[2]; \
	T4 N4 = (T4)params[3]; \
	T5 N5 = (T5)params[4]; \
	T6 N6 = (T6)params[5]; \
	T7 N7 = (T7)params[6]; \
	T8 N8 = (T8)params[7]; \
	T9 N9 = (T9)params[8]

class ScriptMethodParams;
class ScriptContainer;

using string = const char *;
typedef uint32 HWND;

class ScriptMethodParams : public Common::Array<intptr_t> {
public:
	NumberPtr _result;

	ScriptMethodParams();
	ScriptMethodParams(int val1);
	ScriptMethodParams(int val1, int val2);
	ScriptMethodParams(int val1, int val2, int val3);
	ScriptMethodParams(int val1, int val2, int val3, int val4);

	/**
	 * Form of Common::String::format for the parameters array.
	 * @param formatIndex	Param index of the format specifier string
	 */
	Common::String format(int formatIndex);
};

/**
 * Shared base class for plugins and classes exposed to plugins
 */
class ScriptContainer {
public:
	ScriptContainer() {}
	virtual ~ScriptContainer() {}

protected:
	IAGSEngine *_engine = nullptr;
public:
	virtual void AGS_EngineStartup(IAGSEngine *engine) {
		_engine = engine;
	}

	virtual void execMethod(const Common::String &name, ScriptMethodParams &params) {
		error("Plugin does not contain method - %s", name.c_str());
	}
};

/**
 * Base class for the implementation of AGS plugins
 */
class PluginBase: public ScriptContainer {
public:
	PluginBase() {}
	virtual ~PluginBase() {}

	virtual const char *AGS_GetPluginName() = 0;
	virtual int    AGS_PluginV2() const { return 1; }
	virtual int    AGS_EditorStartup(IAGSEditor *) { return 0; }
	virtual void   AGS_EditorShutdown() {}
	virtual void   AGS_EditorProperties(HWND) {}
	virtual int    AGS_EditorSaveGame(char *, int) { return 0; }
	virtual void   AGS_EditorLoadGame(char *, int) {}
	virtual void   AGS_EngineShutdown() {}
	virtual int64 AGS_EngineOnEvent(int, NumberPtr) { return 0; }
	virtual int    AGS_EngineDebugHook(const char *, int, int) { return 0; }
	virtual void   AGS_EngineInitGfx(const char *driverID, void *data) {}
};

class PluginMethod {
private:
	ScriptContainer *_sc;
	Common::String _name;
public:
	PluginMethod() : _sc(nullptr) {}
	PluginMethod(ScriptContainer *sc, const Common::String &name) :
		_sc(sc), _name(name) {
	}

	operator bool() const {
		return _sc != nullptr;
	}

	NumberPtr operator()(ScriptMethodParams &params) const {
		_sc->execMethod(_name, params);
		return params._result;
	}

	NumberPtr operator()(intptr_t val1) const {
		ScriptMethodParams params(val1);
		_sc->execMethod(_name, params);
		return params._result;
	}
	NumberPtr operator()(intptr_t val1, intptr_t val2) const {
		ScriptMethodParams params(val1, val2);
		_sc->execMethod(_name, params);
		return params._result;
	}
	NumberPtr operator()(intptr_t val1, intptr_t val2, intptr_t val3) const {
		ScriptMethodParams params(val1, val2, val3);
		_sc->execMethod(_name, params);
		return params._result;
	}
	NumberPtr operator()(intptr_t val1, intptr_t val2, intptr_t val3, intptr_t val4) const {
		ScriptMethodParams params(val1, val2, val3, val4);
		_sc->execMethod(_name, params);
		return params._result;
	}
};

extern PluginBase *pluginOpen(const char *filename);

extern int pluginClose(Plugins::PluginBase *lib);

extern const char *pluginError();

} // namespace Plugins
} // namespace AGS3

#endif