ViewVC Help

View File | Revision Log | Show Annotations | Download File

/cvs/deliantra/server/server/cfperl.xs

Comparing deliantra/server/server/cfperl.xs (file contents):
Revision 1.7 by root, Fri Aug 25 13:24:50 2006 UTC vs.
Revision 1.42 by root, Mon Sep 4 11:08:00 2006 UTC

…		…
21	* You should have received a copy of the GNU General Public License	21	* You should have received a copy of the GNU General Public License
22	* along with this program; if not, write to the Free Software	22	* along with this program; if not, write to the Free Software
23	* Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA	23	* Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24	*/	24	*/
25		25
26	#include <EXTERN.h>
27	#include <perl.h>
28	#include <XSUB.h>
29
30	#undef save_long // clashes with libproto.h
31
32	#define PLUGIN_NAME "perl"	26	#define PLUGIN_NAME "perl"
33	#define PLUGIN_VERSION "cfperl 0.3"	27	#define PLUGIN_VERSION "cfperl 0.5"
34
35	#ifndef __CEXTRACT__
36	#include <plugin.h>
37	#endif
38
39	#undef MODULEAPI
40	#ifdef WIN32
41	#else
42	#define MODULEAPI
43	#endif
44		28
45	#include <plugin_common.h>	29	#include <plugin_common.h>
46	#include <sounds.h>	30	#include <sounds.h>
47	#include <cstdarg>	31	#include <cstdarg>
48	#include <sproto.h>	32	#include <sproto.h>
49		33
50	#include "cfperl.h"	34	#include "cfperl.h"
		35	#include "shstr.h"
		36
		37	#include <EXTERN.h>
		38	#include <perl.h>
		39	#include <XSUB.h>
51		40
52	#include "perlxsi.c"	41	#include "perlxsi.c"
53
54	static void *globalEventListener (int *type, ...);
55		42
56	extern sint64 *levels; // the experience table	43	extern sint64 *levels; // the experience table
57		44
58	typedef object object_ornull;	45	typedef object object_ornull;
59	typedef mapstruct mapstruct_ornull;	46	typedef mapstruct mapstruct_ornull;
60		47
61	typedef double val64;	48	typedef double val64;
62	#define newSVval64 newSVnv	49	#define newSVval64 newSVnv
63	#define SvVAL64 SvNV	50	#define SvVAL64 SvNV
64		51
65	static f_plug_api gethook;	52	static f_plug_api gethook = cfapi_get_hooks;
66	static f_plug_api registerGlobalEvent;	53	static f_plug_api object_set_property = cfapi_object_set_property;
67	static f_plug_api unregisterGlobalEvent;	54	static f_plug_api object_insert = cfapi_object_insert;
68	static f_plug_api systemDirectory;
69	static f_plug_api object_set_property;
70	static f_plug_api map_get_map;
71	static f_plug_api object_insert;
72		55
73	/* this is a stupid way to do things, and awkward to use for plug-in authors */	56	/* this is a stupid way to do things, and awkward to use for plug-in authors */
74	typedef struct	57	typedef struct
75	{	58	{
76	object* who;	59	object* who;
…		…
87	} CFPContext;	70	} CFPContext;
88		71
89	static HV *obj_cache;	72	static HV *obj_cache;
90	static PerlInterpreter *perl;	73	static PerlInterpreter *perl;
91		74
		75	static AV *cb_global, *cb_object, *cb_player, *cb_type, *cb_map;
		76
92	#define PUSHcfapi(type,value) PUSHs (sv_2mortal (newSVcfapi (CFAPI_ ## type, (value))))	77	#define PUSHcfapi(type,value) PUSHs (sv_2mortal (newSVcfapi (CFAPI_ ## type, (value))))
93	#define PUSHcfapi_va(type,ctype) PUSHcfapi (type, va_arg (args, ctype))	78	#define PUSHcfapi_va(type,ctype) PUSHcfapi (type, va_arg (args, ctype))
94	#define PUSH_OB PUSHcfapi_va(POBJECT, object *)	79	#define PUSH_OB PUSHcfapi_va(POBJECT, object *)
95	#define PUSH_PL PUSHcfapi_va(PPLAYER, player *)	80	#define PUSH_PL PUSHcfapi_va(PPLAYER, player *)
96	#define PUSH_MAP PUSHcfapi_va(PMAP, mapstruct *)	81	#define PUSH_MAP PUSHcfapi_va(PMAP, mapstruct *)
97	#define PUSH_PV PUSHcfapi_va(STRING, const char *)	82	#define PUSH_PV PUSHcfapi_va(STRING, const char *)
98	#define PUSH_IV PUSHs (sv_2mortal (newSViv (va_arg (args, int))))	83	#define PUSH_IV PUSHs (sv_2mortal (newSViv (va_arg (args, int))))
99		84
100	//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////	85	//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
101		86
102	// garbage collect some perl objects, if possible
103	// all objects no longer referenced and empty are
104	// eligible for destruction.
105	static void
106	clean_obj_cache ()
107	{
108	static int count;
109
110	if (++count & 7)
111	return;
112
113	int todo = 1000;
114	do
115	{
116	I32 klen;
117	char *key;
118	HE *he = hv_iternext (obj_cache);
119
120	if (he)
121	{
122	SV *sv = hv_iterval (obj_cache, he);
123
124	// empty and unreferenced? nuke it
125	if (SvREFCNT (sv) == 1 && SvREFCNT (SvRV (sv)) == 1 && !HvFILL ((HV *)(SvRV (sv))))
126	{
127	hv_delete (obj_cache, HeKEY (he), HeKLEN (he), G_DISCARD);
128	todo++;
129	}
130	}
131	else
132	break;
133	}
134	while (--todo);
135	}
136
137	static SV *	87	static SV *
138	newSVptr (void *ptr, const char *klass)	88	newSVptr (void *ptr, const char *klass, HV *hv = newHV ())
139	{	89	{
140	SV *sv;	90	SV *sv;
141		91
142	if (!ptr)	92	if (!ptr)
143	return &PL_sv_undef;	93	return &PL_sv_undef;
144		94
145	sv = newSV (0);
146	sv_magic (sv, 0, PERL_MAGIC_ext, (char *)ptr, 0);	95	sv_magic ((SV *)hv, 0, PERL_MAGIC_ext, (char *)ptr, 0);
147	return sv_bless (newRV_noinc (sv), gv_stashpv (klass, 1));	96	return sv_bless (newRV_noinc ((SV *)hv), gv_stashpv (klass, 1));
		97	}
		98
		99	template<class attachable>
		100	SV *
		101	newSVattachable (attachable *obj, const char *klass)
		102	{
		103	if (!obj)
		104	return &PL_sv_undef;
		105
		106	if (!obj->self)
		107	obj->self = newSVptr (obj, klass);
		108
		109	return newSVsv (obj->self);
148	}	110	}
149		111
150	static void	112	static void
151	SVptr_cache_set (void *ptr, SV *sv)	113	SVptr_cache_set (void *ptr, SV *sv)
152	{	114	{
…		…
222	SV *sv;	184	SV *sv;
223		185
224	switch (type)	186	switch (type)
225	{	187	{
226	case DT_INT:	188	case DT_INT:
227	sv = newSViv (*va_arg (ap, int *));	189	sv = newSViv (va_arg (ap, int));
228	break;	190	break;
229		191
230	case DT_LONG:	192	case DT_INT64:
231	sv = newSVval64 ((val64)*va_arg (ap, sint64 *));	193	sv = newSVval64 ((val64)va_arg (ap, sint64));
232	break;	194	break;
233		195
234	case DT_DOUBLE:	196	case DT_DOUBLE:
235	sv = newSVnv (*va_arg (ap, double *));	197	sv = newSVnv (va_arg (ap, double));
236	break;	198	break;
237		199
238	case DT_STRING:	200	case DT_STRING:
239	{	201	{
240	char *str = va_arg (ap, char *);	202	char *str = (char *)va_arg (ap, const char *);
241	sv = str ? newSVpv (str, 0) : &PL_sv_undef;	203	sv = str ? newSVpv (str, 0) : &PL_sv_undef;
242	}	204	}
243	break;	205	break;
244		206
245	case DT_DATA:	207	case DT_DATA:
246	{	208	{
247	char *str = (char *)va_arg (ap, void *);	209	char *str = (char *)va_arg (ap, const void *);
248	int len = va_arg (ap, int);	210	int len = va_arg (ap, int);
249	sv = str ? newSVpv (str, len) : &PL_sv_undef;	211	sv = str ? newSVpv (str, len) : &PL_sv_undef;
250	}	212	}
251	break;	213	break;
252		214
253	case DT_OBJECT:	215	case DT_OBJECT:
254	{	216	{
255	object *obj = va_arg (ap, object *);	217	object *obj = va_arg (ap, object *);
256		218	sv = newSVattachable (obj, obj && obj->type == PLAYER ? "cf::object::player::wrap" : "cf::object::wrap");
257	if (!obj)
258	sv = &PL_sv_undef;
259	else
260	switch (obj->type)
261	{
262	case MAP:
263	sv = newSVptr_cached (obj, "cf::object::map::wrap");
264	break;
265
266	case PLAYER:
267	sv = newSVptr_cached (obj, "cf::object::player::wrap");
268	break;
269
270	default:
271	sv = newSVptr_cached (obj, "cf::object::wrap");
272	break;
273	}
274	}	219	}
275	break;	220	break;
276		221
277	case DT_MAP:	222	case DT_MAP:
		223	// va_arg (object *) when void * is passed is an XSI extension
278	sv = newSVptr (va_arg (ap, mapstruct *), "cf::map::wrap");	224	sv = newSVattachable (va_arg (ap, mapstruct *), "cf::map::wrap");
279	break;	225	break;
280		226
281	case DT_PLAYER:	227	case DT_PLAYER:
282	sv = newSVptr (va_arg (ap, player *), "cf::player::wrap");	228	sv = newSVattachable (va_arg (ap, player *), "cf::player::wrap");
283	break;	229	break;
284		230
285	case DT_ARCH:	231	case DT_ARCH:
286	sv = newSVptr (va_arg (ap, archetype *), "cf::arch::wrap");	232	sv = newSVptr (va_arg (ap, archetype *), "cf::arch::wrap");
287	break;	233	break;
…		…
321	va_list ap;	267	va_list ap;
322	va_start (ap, type);	268	va_start (ap, type);
323		269
324	switch (type)	270	switch (type)
325	{	271	{
326	case CFAPI_INT: sv = newSVdt_va (ap, DT_INT ); break;	272	case CFAPI_INT: sv = newSViv (*va_arg (ap, int * )); break;
327	case CFAPI_LONG: sv = newSVdt_va (ap, DT_LONG ); break;	273	case CFAPI_LONG: sv = newSVval64 (*va_arg (ap, sint64 *)); break;
328	case CFAPI_DOUBLE: sv = newSVdt_va (ap, DT_DOUBLE); break;	274	case CFAPI_DOUBLE: sv = newSVnv (*va_arg (ap, double *)); break;
329	case CFAPI_STRING: sv = newSVdt_va (ap, DT_STRING); break;	275	case CFAPI_STRING: sv = newSVdt_va (ap, DT_STRING); break;
330	case CFAPI_POBJECT: sv = newSVdt_va (ap, DT_OBJECT); break;	276	case CFAPI_POBJECT: sv = newSVdt_va (ap, DT_OBJECT); break;
331	case CFAPI_PMAP: sv = newSVdt_va (ap, DT_MAP ); break;	277	case CFAPI_PMAP: sv = newSVdt_va (ap, DT_MAP ); break;
332	case CFAPI_PPLAYER: sv = newSVdt_va (ap, DT_PLAYER); break;	278	case CFAPI_PPLAYER: sv = newSVdt_va (ap, DT_PLAYER); break;
333	case CFAPI_PARCH: sv = newSVdt_va (ap, DT_ARCH ); break;	279	case CFAPI_PARCH: sv = newSVdt_va (ap, DT_ARCH ); break;
…		…
341	va_end (ap);	287	va_end (ap);
342		288
343	return sv;	289	return sv;
344	}	290	}
345		291
		292	//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
		293
		294	SV *
		295	registry_of (attachable_base *ext)
		296	{
		297	if (!ext->cb)
		298	ext->cb = newAV ();
		299
		300	return newRV_inc ((SV *)ext->cb);
		301	}
		302
		303	void attachable_base::clear ()
		304	{
		305	if (self)
		306	{
		307	if (cb)
		308	if (SvROK (*av_fetch (cb, EVENT_OBJECT_DESTROY, 1)))
		309	INVOKE_OBJECT (DESTROY, static_cast<object *>(this));
		310	else if (SvROK (*av_fetch (cb, EVENT_MAP_DESTROY, 1)))
		311	INVOKE_MAP (DESTROY, static_cast<mapstruct *>(this));
		312
		313	// disconnect Perl from C, to avoid crashes
		314	sv_unmagic (SvRV ((SV *)self), PERL_MAGIC_ext);
		315
		316	// clear the perl hash, might or might not be a good idea
		317	hv_clear ((HV *)SvRV ((SV *)self));
		318
		319	SvREFCNT_dec (self);
		320	self = 0;
		321	}
		322
		323	if (cb)
		324	{
		325	SvREFCNT_dec (cb);
		326	cb = 0;
		327	}
		328
		329	attach = 0;
		330	}
		331
		332	void attachable_base::optimise ()
		333	{
		334	if (!self)
		335	return;
		336
		337	HV *hv = (HV *)SvRV ((SV *)self);
		338
		339	if (SvREFCNT ((SV *)self) == 1
		340	&& SvREFCNT ((SV *)hv) == 1
		341	&& !HvKEYS (hv))
		342	{
		343	SvREFCNT_dec ((SV *)self);
		344	self = 0;
		345	}
		346	}
		347
		348	void attachable_base::instantiate (data_type type, void *obj)
		349	{
		350	dSP;
		351	ENTER;
		352	SAVETMPS;
		353	PUSHMARK (SP);
		354	EXTEND (SP, 2);
		355	PUSHs (sv_2mortal (newSVdt (type, obj)));
		356	PUSHs (sv_2mortal (newSVpv (attach, 0)));
		357
		358	attach = 0;
		359
		360	PUTBACK;
		361	call_pv ("cf::instantiate", G_DISCARD | G_VOID | G_EVAL);
		362	FREETMPS;
		363	LEAVE;
		364
		365	switch (type)
		366	{
		367	case DT_OBJECT: INVOKE_OBJECT (INSTANTIATE, obj); break;
		368	case DT_MAP: INVOKE_MAP (INSTANTIATE, obj); break;
		369	}
		370	}
		371
346	/////////////////////////////////////////////////////////////////////////////	372	/////////////////////////////////////////////////////////////////////////////
347		373
		374	void reattach (data_type type, void *obj)
		375	{
		376	//TODO only do this when the object has _attachment's
		377
		378	dSP;
		379	ENTER;
		380	SAVETMPS;
		381	PUSHMARK (SP);
		382	XPUSHs (sv_2mortal (newSVdt (type, obj)));
		383	PUTBACK;
		384	call_pv ("cf::reattach", G_DISCARD | G_VOID | G_EVAL);
		385	FREETMPS;
		386	LEAVE;
		387
		388	switch (type)
		389	{
		390	case DT_OBJECT: INVOKE_OBJECT (REATTACH, obj); break;
		391	case DT_PLAYER: INVOKE_PLAYER (REATTACH, obj); break;
		392	case DT_MAP: INVOKE_MAP (REATTACH, obj); break;
		393	}
		394	}
		395
		396	template<class subclass>
		397	void reattach (attachable<subclass> *obj)
		398	{
		399	obj->optimise ();
		400
		401	if (obj->self)
		402	reattach ((data_type) cftype<subclass>::dt, (subclass *)obj);
		403	}
		404
		405	#include "kw_hash.h"
		406
		407	object_freezer::object_freezer ()
		408	: dynbuf (128 * 1024, 64 * 1024)
		409	{
		410	av = newAV ();
		411	}
		412
		413	object_freezer::~object_freezer ()
		414	{
		415	SvREFCNT_dec (av);
		416	}
		417
		418	void object_freezer::put (attachable_base *ext)
		419	{
		420	ext->optimise ();
		421
		422	if (ext->self)
		423	{
		424	int idx = AvFILLp ((AV *)av) + 1;
		425	av_store (av, idx, SvREFCNT_inc (ext->self));
		426
		427	add ((void *)"oid ", 4);
		428	add ((sint32)idx);
		429	add ('\n');
		430	}
		431	}
		432
		433	bool object_freezer::save (const char *filename)
		434	{
		435	dSP;
		436	ENTER;
		437	SAVETMPS;
		438	PUSHMARK (SP);
		439	EXTEND (SP, 3);
		440	PUSHs (sv_2mortal (newSVpv (filename, 0)));
		441	PUSHs (sv_2mortal (newRV_noinc (newSVpvn ((char *)linearise (), size ()))));
		442	PUSHs (sv_2mortal (newRV_inc ((SV *)av)));
		443	PUTBACK;
		444	call_pv ("cf::object_freezer_save", G_VOID | G_DISCARD | G_EVAL);
		445	FREETMPS;
		446	LEAVE;
		447	}
		448
		449	int fprintf (object_freezer &freezer, const char *format, ...)
		450	{
		451	va_list ap;
		452
		453	va_start (ap, format);
		454
		455	int len = vsnprintf ((char *)freezer.force (1024), 1024, format, ap);
		456
		457	if (len >= 0)
		458	freezer.alloc (len);
		459
		460	va_end (ap);
		461	}
		462
		463	int fputs (const char *s, object_freezer &freezer)
		464	{
		465	freezer.add (s);
		466	}
		467
		468	object_thawer::object_thawer (const char *filename)
		469	{
		470	static const char eof[] = "\n\n\n\0\0\0";
		471
		472	av = 0;
		473	text = 0;
		474	line = 0;
		475
		476	if (filename)
		477	{
		478	dSP;
		479	ENTER;
		480	SAVETMPS;
		481	PUSHMARK (SP);
		482	XPUSHs (sv_2mortal (newSVpv (filename, 0)));
		483	PUTBACK;
		484
		485	if (2 == call_pv ("cf::object_thawer_load", G_ARRAY | G_EVAL))
		486	{
		487	SPAGAIN;
		488
		489	// second value - perl objects
		490	{
		491	SV *sv = POPs;
		492	if (SvROK (sv))
		493	av = (AV *)SvREFCNT_inc (SvRV (sv));
		494	}
		495
		496	// first value - text part, pad with 3 zeroes
		497	{
		498	SV *sv = POPs;
		499	STRLEN len;
		500	char *sv_ = SvPVbyte (sv, len);
		501	text = newSV (len + sizeof (eof));
		502	SvCUR_set (text, len);
		503	memcpy (SvPVX (text), sv_, len);
		504	memcpy (SvEND (text), eof, sizeof (eof)); // just to be sure
		505
		506	line = SvPVX (text);
		507	}
		508	}
		509
		510	PUTBACK;
		511	FREETMPS;
		512	LEAVE;
		513	}
		514	}
		515
		516	void object_thawer::get (data_type type, void *obj, attachable_base *ext, int oid)
		517	{
		518	if (!av || oid < 0) // this is actually an error of sorts
		519	return;
		520
		521	// we have to "re-instantiate"/reattach to an object, so nuke ext->attach
		522	ext->clear ();
		523
		524	SV **svp = av_fetch ((AV *)av, oid, 0);
		525
		526	if (!svp || !SvROK (*svp))
		527	{
		528	printf ("trying to thaw duplicate or never-issued oid %d, ignoring.\n", oid);
		529	return;
		530	}
		531
		532	ext->self = *svp; *svp = &PL_sv_undef;
		533	sv_magic (SvRV (ext->self), 0, PERL_MAGIC_ext, (char *)obj, 0);
		534
		535	reattach (type, obj);
		536	}
		537
		538	object_thawer::~object_thawer ()
		539	{
		540	if (text) SvREFCNT_dec (text);
		541	if (av) SvREFCNT_dec (av);
		542	}
		543
		544	char *fgets (char *s, int n, object_thawer &thawer)
		545	{
		546	char *p = thawer.line;
		547	char *q = s;
		548
		549	if (!p)
		550	return 0;
		551
		552	while (--n)
		553	{
		554	if (!*p)
		555	break;
		556
		557	*q++ = *p;
		558
		559	if (*p++ == '\n')
		560	break;
		561	}
		562
		563	*q = 0;
		564	thawer.line = p;
		565
		566	return s == q ? 0 : s;
		567	}
		568
		569	keyword object_thawer::get_kv ()
		570	{
		571	if (!line)
		572	return KW_EOF;
		573
		574	for (;;)
		575	{
		576	char *p = line;
		577
		578	if (!*p)
		579	return KW_EOF;
		580
		581	// parse keyword
		582	while (*p > ' ')
		583	p++;
		584
		585	int klen = p - line;
		586
		587	if (*p++ != '\n')
		588	{
		589	// parse value
		590	while (*p <= ' ' && *p != '\n') // skip 0x01 .. 0x20
		591	++p;
		592
		593	last_value = p;
		594
		595	while (*p != '\n')
		596	p++;
		597
		598	*p++ = 0;
		599	}
		600	else
		601	last_value = 0;
		602
		603	line [klen] = 0;
		604	keyword_idx *kw = kw_lex::match (line, klen);
		605
		606	//printf ("KV %d<%s,%s>\n", kw ? kw->index : 0, line, last_value);//D
		607
		608	if (kw)
		609	{
		610	line = p;
		611	return kw->index;
		612	}
		613	else if (!*line || *line == '#')
		614	{
		615	// empty/comment line
		616	line = p;
		617	}
		618	else
		619	return KW_ERROR;
		620	}
		621	}
		622
		623	void object_thawer::get (shstr &sh) const
		624	{
		625	if (last_value)
		626	sh = last_value;
		627	else
		628	{
		629	sh = "<value missing>";
		630	LOG (llevError, "keyword requires value: <%s>\n", line);//TODO: add filename
		631	}
		632	}
		633
		634	void object_thawer::get_ml (keyword kend, shstr &sh)
		635	{
		636	char kw[128];
		637
		638	// multi-line strings are delimited by "\nendXXX\n"
		639	kw [0] = '\n';
		640	strcpy (kw + 1, keyword_str [kend]);
		641
		642	char *end = strstr (line, kw);
		643
		644	if (!end)
		645	{
		646	sh = 0;
		647	return;
		648	}
		649
		650	*end = 0;
		651	sh = line;
		652
		653	line = end + keyword_len [kend] + 1;
		654
		655	while (*line++ != '\n')
		656	;
		657	}
		658
		659	sint32 object_thawer::get_sint32 () const
		660	{
		661	char *p = last_value;
		662
		663	if (!p)
		664	return 0;
		665
		666	sint32 val = 0;
		667	bool negate;
		668
		669	if (*p == '-')
		670	{
		671	negate = true;
		672	++p;
		673	}
		674	else
		675	negate = false;
		676
		677	do
		678	{
		679	val *= 10;
		680	val += *p++ - '0';
		681	}
		682	while (*p);
		683
		684	return negate ? -val : val;
		685	}
		686
		687	sint64 object_thawer::get_sint64 () const
		688	{
		689	return last_value ? atoll (last_value) : 0;
		690	}
		691
		692	double object_thawer::get_double () const
		693	{
		694	return last_value ? atof (last_value) : 0;
		695	}
		696
		697	/////////////////////////////////////////////////////////////////////////////
		698
348	extern "C" int cfperl_initPlugin (const char *iversion, f_plug_api gethooksptr)	699	extern "C" int cfperl_initPlugin (const char *iversion, f_plug_api gethooksptr)
349	{	700	{
350	gethook = gethooksptr;
351	printf (PLUGIN_VERSION " init\n");
352
353	return 0;	701	return 0;
354	}	702	}
355		703
356	static CommArray_s rtn_cmd;	704	static CommArray_s rtn_cmd;
357		705
…		…
437	extern "C" int cfperl_postInitPlugin ()	785	extern "C" int cfperl_postInitPlugin ()
438	{	786	{
439	int hooktype = 1;	787	int hooktype = 1;
440	int rtype = 0;	788	int rtype = 0;
441		789
442	printf (PLUGIN_VERSION " post init\n");
443
444	registerGlobalEvent = (void* (*)(int*, ...)) gethook (&rtype, hooktype, "cfapi_system_register_global_event");
445	unregisterGlobalEvent = (void* (*)(int*, ...)) gethook (&rtype, hooktype, "cfapi_system_unregister_global_event");
446	systemDirectory = (void* (*)(int*, ...)) gethook (&rtype, hooktype, "cfapi_system_directory");
447	object_set_property = (void* (*)(int*, ...)) gethook (&rtype, hooktype, "cfapi_object_set_property");
448	map_get_map = (void* (*)(int*, ...)) gethook (&rtype, hooktype, "cfapi_map_get_map");
449	object_insert = (void* (*)(int*, ...)) gethook (&rtype, hooktype, "cfapi_object_insert");
450
451	cf_init_plugin (gethook);	790	cf_init_plugin (gethook);
452		791
453	/* Pick the global events you want to monitor from this plugin */
454	registerGlobalEvent (NULL, EVENT_CLOCK, PLUGIN_NAME, globalEventListener);
455	//registerGlobalEvent (NULL, EVENT_CRASH, PLUGIN_NAME, globalEventListener);
456	registerGlobalEvent (NULL, EVENT_FIND_UNARMED_SKILL, PLUGIN_NAME, globalEventListener);
457	registerGlobalEvent (NULL, EVENT_PLAYER_USE_SKILL, PLUGIN_NAME, globalEventListener);
458	registerGlobalEvent (NULL, EVENT_CAST_SPELL, PLUGIN_NAME, globalEventListener);
459	registerGlobalEvent (NULL, EVENT_MONSTER_USE_SKILL, PLUGIN_NAME, globalEventListener);
460	registerGlobalEvent (NULL, EVENT_GKILL, PLUGIN_NAME, globalEventListener);
461	registerGlobalEvent (NULL, EVENT_SHOUT, PLUGIN_NAME, globalEventListener);
462	registerGlobalEvent (NULL, EVENT_TELL, PLUGIN_NAME, globalEventListener);
463	registerGlobalEvent (NULL, EVENT_MUZZLE, PLUGIN_NAME, globalEventListener);
464	registerGlobalEvent (NULL, EVENT_KICK, PLUGIN_NAME, globalEventListener);
465	registerGlobalEvent (NULL, EVENT_EXTCMD, PLUGIN_NAME, globalEventListener);
466
467	return 0;	792	return 0;
468	}
469
470	static void *
471	globalEventListener (int *type, ...)
472	{
473	va_list args;
474	static int rv;
475	int event_code;
476
477	if (!perl)
478	return NULL;
479
480	va_start (args, type);
481	event_code = va_arg (args, int);
482
483	if (event_code == EVENT_CLOCK)
484	{
485	clean_obj_cache ();
486	}
487	else
488	{
489	dSP;
490
491	ENTER;
492	SAVETMPS;
493
494	PUSHMARK (SP);
495
496	EXTEND (SP, 10);
497	PUSHs (sv_2mortal (newSViv (event_code)));
498
499	switch (event_code)
500	{
501	case EVENT_CRASH:
502	break;
503
504	case EVENT_GKILL:
505	PUSH_OB;
506	PUSH_OB;
507	break;
508
509	case EVENT_SHOUT:
510	case EVENT_MUZZLE:
511	case EVENT_KICK:
512	PUSH_OB;
513	PUSH_PV;
514	break;
515
516	case EVENT_FIND_UNARMED_SKILL:
517	PUSH_OB;
518	break;
519
520	case EVENT_PLAYER_USE_SKILL:
521	case EVENT_MONSTER_USE_SKILL:
522	case EVENT_CAST_SPELL:
523	PUSH_OB;
524	PUSH_OB;
525	PUSH_OB;
526	PUSH_IV;
527	PUSH_PV;
528	break;
529
530	case EVENT_EXTCMD:
531	PUSH_PL;
532	{
533	char *buf = va_arg (args, char *);
534	int len = va_arg (args, int);
535	PUSHs (sv_2mortal (newSVpvn (buf, len)));
536	}
537	break;
538
539	case EVENT_TELL:
540	break;
541	}
542
543	va_end (args);
544
545	PUTBACK;
546	int count = call_pv ("cf::inject_global_event", G_SCALAR | G_EVAL);
547	SPAGAIN;
548
549	if (SvTRUE (ERRSV))
550	LOG (llevError, "global event '%d' callback evaluation error: %s", event_code, SvPV_nolen (ERRSV));
551
552	rv = count > 0 ? POPi : 0;
553
554	PUTBACK;
555	FREETMPS;
556	LEAVE;
557	}
558
559	return &rv;
560	}
561
562	extern "C" void *cfperl_eventListener (int *type, ...)
563	{
564	static int rv;
565	va_list args;
566	int event_code;
567	object *who, *activator, *third, *event;
568	char *message, *extension, *options;
569
570	if (!perl)
571	return NULL;
572
573	va_start (args, type);
574	who = va_arg (args, object *);
575	event_code = va_arg (args, int);
576	activator = va_arg (args, object *);
577	third = va_arg (args, object *);
578	message = va_arg (args, char *);
579	va_arg (args, int); // fix yourself
580	extension = va_arg (args, char *);
581	options = va_arg (args, char *);
582	event = va_arg (args, object *);
583	va_end (args);
584
585	{
586	dSP;
587
588	ENTER;
589	SAVETMPS;
590
591	PUSHMARK (SP);
592	EXTEND (SP, 10);
593
594	PUSHcfapi (STRING, extension);
595	PUSHs (sv_2mortal (newSViv (event_code)));
596
597	PUSHcfapi (POBJECT, event);
598	PUSHcfapi (POBJECT, who);
599
600	switch (event_code)
601	{
602	case EVENT_STOP: // $ob (e.g. arrow)
603	case EVENT_TIME: // $ob
604	case EVENT_TIMER: // $ob
605	break;
606
607	case EVENT_APPLY: // $ob, $who
608	case EVENT_DROP: // $ob, $who
609	case EVENT_CLOSE: // $ob, $who
610	case EVENT_DEATH: // $ob[, $killer]
611	case EVENT_MOVE: // $ob, $enemy
612	case EVENT_THROW: // $ob, $thrower
613	PUSHcfapi (POBJECT, activator);
614	break;
615
616	case EVENT_DROP_ON: // $ob, $who, $what
617	case EVENT_ATTACK: // $ob, $who, $victim (?? please god enlighten me)
618	PUSHcfapi (POBJECT, activator);
619	PUSHcfapi (POBJECT, third);
620	break;
621
622	case EVENT_TRIGGER: // $ob, $originator, [$victim], [$msg]
623	PUSHcfapi (POBJECT, activator);
624	PUSHcfapi (POBJECT, third);
625	PUSHcfapi (POBJECT, message);
626	break;
627
628	case EVENT_SAY: // $ob, $who, $msg
629	PUSHcfapi (POBJECT, activator);
630	PUSHcfapi (STRING, message);
631	break;
632
633	default:
634	LOG (llevError, "perl plugin called for unsupported event type %d", event_code);
635	break;
636	}
637
638	PUTBACK;
639	int count = call_pv ("cf::inject_event", G_SCALAR | G_EVAL);
640	SPAGAIN;
641
642	if (SvTRUE (ERRSV))
643	LOG (llevError, "event '%d' callback evaluation error: %s", event_code, SvPV_nolen (ERRSV));
644
645	rv = count > 0 ? POPi : 0;
646
647	PUTBACK;
648	FREETMPS;
649	LEAVE;
650	}
651
652	return &rv;
653	}	793	}
654		794
655	extern "C" int cfperl_closePlugin ()	795	extern "C" int cfperl_closePlugin ()
656	{	796	{
657	return 0;	797	return 0;
658	}	798	}
659		799
660	void	800	void
661	cfperl_init ()	801	cfperl_init ()
662	{	802	{
		803	PERL_SYS_INIT3 (&settings.argc, &settings.argv, 0);
		804	perl = perl_alloc ();
		805	perl_construct (perl);
		806
		807	PL_exit_flags |= PERL_EXIT_DESTRUCT_END;
		808
663	char *argv[] = {	809	char *argv[] = {
664	"",	810	"",
665	"-e"	811	"-e"
666	"BEGIN {"
667	" cf->bootstrap;"	812	"cf->bootstrap;"
668	" unshift @INC, cf::datadir ();"	813	"unshift @INC, cf::datadir ();"
669	"}"
670	""
671	"use cf;"	814	"require cf;"
672	};	815	};
673
674	perl = perl_alloc ();
675	perl_construct (perl);
676
677	PL_exit_flags |= PERL_EXIT_DESTRUCT_END;
678		816
679	if (perl_parse (perl, xs_init, 2, argv, (char **)NULL) || perl_run (perl))	817	if (perl_parse (perl, xs_init, 2, argv, (char **)NULL) || perl_run (perl))
680	{	818	{
681	printf ("unable to initialize perl-interpreter, aborting.\n");	819	printf ("unable to initialize perl-interpreter, aborting.\n");
682
683	exit (EXIT_FAILURE);	820	exit (EXIT_FAILURE);
684	//perl_destruct (perl);
685	//perl_free (perl);
686	//perl = 0;
687	}	821	}
688	else	822
689	obj_cache = newHV ();	823	obj_cache = newHV ();
690	}	824	}
691		825
692	void cfperl_main ()	826	void cfperl_main ()
693	{	827	{
694	dSP;	828	dSP;
…		…
696	PUSHMARK (SP);	830	PUSHMARK (SP);
697	PUTBACK;	831	PUTBACK;
698	call_pv ("cf::main", G_DISCARD | G_VOID);	832	call_pv ("cf::main", G_DISCARD | G_VOID);
699	}	833	}
700		834
701	void cfperl_free_ob (object *op)	835	static event_klass klass_of[NUM_EVENT_TYPES] = {
702	{	836	# define def(type,name) KLASS_ ## type,
703	SV *sv = hv_delete (obj_cache, (char *)&op, sizeof (void *), 0);	837	# include "eventinc.h"
		838	# undef def
		839	};
704		840
705	if (sv)	841	#define KLASS_OF(event) (((unsigned int)event) < NUM_EVENT_TYPES ? klass_of [event] : KLASS_NONE)
706	clearSVptr (sv);
707	}
708		842
		843	static void
		844	gather_callbacks (AV *&callbacks, AV *registry, event_type event)
		845	{
		846	// event must be in array
		847	if (event >= 0 && event <= AvFILLp (registry))
		848	{
		849	SV *cbs_ = AvARRAY (registry)[event];
		850
		851	// element must be list of callback entries
		852	if (cbs_ && SvROK (cbs_) && SvTYPE (SvRV (cbs_)) == SVt_PVAV)
		853	{
		854	AV *cbs = (AV *)SvRV (cbs_);
		855
		856	// no callback entries, no callbacks to call
		857	if (AvFILLp (cbs) >= 0)
		858	{
		859	if (!callbacks)
		860	{
		861	callbacks = newAV ();
		862	av_extend (callbacks, 16);
		863	}
		864
		865	// never use SvREFCNT_inc to copy values, but its ok here :)
		866	for (int i = 0; i <= AvFILLp (cbs); ++i)
		867	av_push (callbacks, SvREFCNT_inc (AvARRAY (cbs)[i]));
		868	}
		869	}
		870	}
		871	}
		872
709	int cfperl_invoke (event_type event, ...)	873	bool cfperl_invoke (event_type event, ...)
710	{	874	{
		875	data_type dt;
		876	va_list ap;
		877
		878	va_start (ap, event);
		879
		880	AV *callbacks = 0;
		881
		882	object *op;
		883	player *pl;
		884	mapstruct *map;
		885
		886	// callback call ordering is:
		887	// 1. per-object callback (NYI)
		888	// 2. per-class object
		889	// 2a. per-type callback
		890	// 4. global callbacks
		891
		892	gather_callbacks (callbacks, cb_global, event);
		893
		894	switch (KLASS_OF (event))
		895	{
		896	case KLASS_GLOBAL:
		897	break;
		898
		899	case KLASS_OBJECT:
		900	dt = (data_type) va_arg (ap, int);
		901	assert (("first argument must be of type object", dt == DT_OBJECT));
		902	op = va_arg (ap, object *);
		903
		904	if (op->cb)
		905	gather_callbacks (callbacks, op->cb, event);
		906
		907	if (op->type)
		908	{
		909	if (op->subtype && op->type + op->subtype * NUM_SUBTYPES <= AvFILLp (cb_type))
		910	{
		911	SV *registry = AvARRAY (cb_type)[op->type + op->subtype * NUM_SUBTYPES];
		912
		913	if (registry && SvROK (registry) && SvTYPE (SvRV (registry)) == SVt_PVAV)
		914	gather_callbacks (callbacks, (AV *)SvRV (registry), event);
		915	}
		916
		917	if (op->type <= AvFILLp (cb_type))
		918	{
		919	SV *registry = AvARRAY (cb_type)[op->type];
		920
		921	if (registry && SvROK (registry) && SvTYPE (SvRV (registry)) == SVt_PVAV)
		922	gather_callbacks (callbacks, (AV *)SvRV (registry), event);
		923	}
		924	}
		925
		926	gather_callbacks (callbacks, cb_object, event);
		927
		928	break;
		929
		930	case KLASS_PLAYER:
		931	dt = (data_type) va_arg (ap, int);
		932	assert (("first argument must be of type player", dt == DT_PLAYER));
		933	pl = va_arg (ap, player *);
		934
		935	if (pl->cb)
		936	gather_callbacks (callbacks, pl->cb, event);
		937
		938	gather_callbacks (callbacks, cb_player, event);
		939	break;
		940
		941	case KLASS_MAP:
		942	dt = (data_type) va_arg (ap, int);
		943	assert (("first argument must be of type object", dt == DT_MAP));
		944	map = va_arg (ap, mapstruct *);
		945
		946	if (map->cb)
		947	gather_callbacks (callbacks, map->cb, event);
		948
		949	gather_callbacks (callbacks, cb_map, event);
		950	break;
		951
		952	default:
		953	assert (("unsupported event klass in cfperl_invoke", 0));
		954	}
		955
		956	// short-circuit processing if no callbacks found/defined
		957	if (!callbacks)
		958	return 0;
		959
711	dSP;	960	dSP;
712	va_list ap;
713
714	ENTER;	961	ENTER;
715	SAVETMPS;	962	SAVETMPS;
716		963
717	va_start (ap, event);
718	PUSHMARK (SP);	964	PUSHMARK (SP);
719	EXTEND (SP, 2);	965	EXTEND (SP, 3);
720	PUSHs (sv_2mortal (newSViv (event)));
721		966
722	// todo, optimise here wether we actually want to invoke an event	967	PUSHs (sv_2mortal (newSViv (event))); // only used for debugging nowadays
		968	PUSHs (sv_2mortal (newRV_noinc ((SV *)callbacks)));
		969
		970	switch (KLASS_OF (event))
		971	{
		972	case KLASS_OBJECT: PUSHs (sv_2mortal (newSVdt (DT_OBJECT, op))); break;
		973	case KLASS_PLAYER: PUSHs (sv_2mortal (newSVdt (DT_PLAYER, pl))); break;
		974	case KLASS_MAP: PUSHs (sv_2mortal (newSVdt (DT_MAP, map))); break;
		975	}
723		976
724	for (;;)	977	for (;;)
725	{	978	{
726	data_type dt = (data_type) va_arg (ap, int);	979	dt = (data_type) va_arg (ap, int);
727		980
728	if (dt == DT_END)	981	if (dt == DT_END)
729	break;	982	break;
730		983
		984	if (dt == DT_AV)
		985	{
		986	AV *av = va_arg (ap, AV *);
		987
		988	for (int i = 0; i <= av_len (av); ++i)
		989	XPUSHs (*av_fetch (av, i, 1));
		990	}
		991	else
731	PUSHs (sv_2mortal (newSVdt_va (ap, dt)));	992	XPUSHs (sv_2mortal (newSVdt_va (ap, dt)));
732	}	993	}
733		994
734	va_end (ap);	995	va_end (ap);
735		996
736	PUTBACK;	997	PUTBACK;
737	int count = call_pv ("cf::invoke", G_SCALAR | G_EVAL);	998	int count = call_pv ("cf::do_invoke", G_SCALAR | G_EVAL);
738	SPAGAIN;	999	SPAGAIN;
739		1000
740	count = count > 0 ? POPi : 0;	1001	count = count > 0 ? POPi : 0;
741		1002
742	FREETMPS;	1003	FREETMPS;
743	LEAVE;	1004	LEAVE;
744		1005
745	return count;	1006	return count;
		1007	}
		1008
		1009	SV *
		1010	cfperl_result (int idx)
		1011	{
		1012	AV *av = get_av ("cfperl::invoke_results", 0);
		1013	if (!av)
		1014	return &PL_sv_undef;
		1015
		1016	SV **sv = av_fetch (av, idx, 0);
		1017	if (!sv)
		1018	return &PL_sv_undef;
		1019
		1020	return *sv;
		1021	}
		1022
		1023	int
		1024	cfperl_result_INT (int idx)
		1025	{
		1026	return SvIV (cfperl_result (idx));
746	}	1027	}
747		1028
748	MODULE = cf PACKAGE = cf PREFIX = cf_	1029	MODULE = cf PACKAGE = cf PREFIX = cf_
749		1030
750	BOOT:	1031	BOOT:
…		…
884	const_iv (BUILDER)	1165	const_iv (BUILDER)
885	const_iv (MATERIAL)	1166	const_iv (MATERIAL)
886	const_iv (ITEM_TRANSFORMER)	1167	const_iv (ITEM_TRANSFORMER)
887	const_iv (QUEST)	1168	const_iv (QUEST)
888		1169
		1170	const_iv (NUM_SUBTYPES)
		1171
889	const_iv (ST_BD_BUILD)	1172	const_iv (ST_BD_BUILD)
890	const_iv (ST_BD_REMOVE)	1173	const_iv (ST_BD_REMOVE)
891		1174
892	const_iv (ST_MAT_FLOOR)	1175	const_iv (ST_MAT_FLOOR)
893	const_iv (ST_MAT_WALL)	1176	const_iv (ST_MAT_WALL)
…		…
1121		1404
1122	const_iv (SK_EXP_ADD_SKILL)	1405	const_iv (SK_EXP_ADD_SKILL)
1123	const_iv (SK_EXP_TOTAL)	1406	const_iv (SK_EXP_TOTAL)
1124	const_iv (SK_EXP_NONE)	1407	const_iv (SK_EXP_NONE)
1125	const_iv (SK_SUBTRACT_SKILL_EXP)	1408	const_iv (SK_SUBTRACT_SKILL_EXP)
		1409	const_iv (SK_EXP_SKILL_ONLY)
1126		1410
1127	const_iv (SK_LOCKPICKING)	1411	const_iv (SK_LOCKPICKING)
1128	const_iv (SK_HIDING)	1412	const_iv (SK_HIDING)
1129	const_iv (SK_SMITHERY)	1413	const_iv (SK_SMITHERY)
1130	const_iv (SK_BOWYER)	1414	const_iv (SK_BOWYER)
…		…
1241	for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )	1525	for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )
1242	newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));	1526	newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));
1243		1527
1244	static const struct {	1528	static const struct {
1245	const char *name;	1529	const char *name;
		1530	int skip;
1246	IV klass;	1531	IV klass;
1247	IV iv;	1532	IV iv;
1248	} *eiv, event_iv[] = {	1533	} *eiv, event_iv[] = {
1249	# define def(klass,name) { # name, (IV)KLASS_ ## klass, (IV)EV_ ## klass ## name },	1534	# define def(klass,name) { "EVENT_" # klass "_" # name, sizeof ("EVENT_" # klass), (IV)KLASS_ ## klass, (IV)EVENT_ ## klass ## _ ## name },
1250	# include "eventinc.h"	1535	# include "eventinc.h"
1251	# undef def	1536	# undef def
1252	};	1537	};
1253		1538
1254	AV *av = get_av ("cf::EVENT", 1);	1539	AV *av = get_av ("cf::EVENT", 1);
1255		1540
1256	for (eiv = event_iv + sizeof (event_iv) / sizeof (event_iv [0]); eiv-- > event_iv; )	1541	for (eiv = event_iv + sizeof (event_iv) / sizeof (event_iv [0]); eiv-- > event_iv; )
1257	{	1542	{
1258	AV *event = newAV ();	1543	AV *event = newAV ();
1259	av_push (event, newSVpv ((char *)eiv->name, 0));	1544	av_push (event, newSVpv ((char *)eiv->name + eiv->skip, 0));
1260	av_push (event, newSViv (eiv->klass));	1545	av_push (event, newSViv (eiv->klass));
1261	av_store (av, eiv->iv, newRV_noinc ((SV *)event));	1546	av_store (av, eiv->iv, newRV_noinc ((SV *)event));
		1547	newCONSTSUB (stash, (char *)eiv->name, newSViv (eiv->iv));
1262	}	1548	}
1263
1264	static const struct {
1265	const char *name;
1266	IV iv;
1267	} *event, event_list[] = {
1268	# define const_event(name) { # name, (IV)EVENT_ ## name },
1269	const_event (NONE)
1270	const_event (APPLY)
1271	const_event (ATTACK)
1272	const_event (DEATH)
1273	const_event (DROP)
1274	const_event (DROP_ON)
1275	const_event (PICKUP)
1276	const_event (SAY)
1277	const_event (STOP)
1278	const_event (TIME)
1279	const_event (THROW)
1280	const_event (TRIGGER)
1281	const_event (CLOSE)
1282	const_event (TIMER)
1283	const_event (MOVE)
1284
1285	//const_event (CLOCK)
1286	const_event (CRASH)
1287	const_event (GKILL)
1288	const_event (SHOUT)
1289	const_event (TELL)
1290	const_event (MUZZLE)
1291	const_event (KICK)
1292	const_event (PLAYER_USE_SKILL)
1293	const_event (MONSTER_USE_SKILL)
1294	const_event (CAST_SPELL)
1295	const_event (FIND_UNARMED_SKILL)
1296	const_event (EXTCMD)
1297	//const_event (FREE_OB)
1298	};
1299
1300	av = get_av ("cf::PLUGIN_EVENT", 1);
1301
1302	for (event = event_list + sizeof (event_list) / sizeof (event_list [0]); event-- > event_list; )
1303	av_store (av, event->iv, newSVpv ((char *)event->name, 0));
1304		1549
1305	static const struct {	1550	static const struct {
1306	int dtype;	1551	int dtype;
1307	const char *name;	1552	const char *name;
1308	IV idx;	1553	IV idx;
…		…
1328	prop (CFAPI_INT, MAP_PROP_WINDDIR)	1573	prop (CFAPI_INT, MAP_PROP_WINDDIR)
1329	prop (CFAPI_INT, MAP_PROP_SKY)	1574	prop (CFAPI_INT, MAP_PROP_SKY)
1330	prop (CFAPI_INT, MAP_PROP_WPARTX)	1575	prop (CFAPI_INT, MAP_PROP_WPARTX)
1331	prop (CFAPI_INT, MAP_PROP_WPARTY)	1576	prop (CFAPI_INT, MAP_PROP_WPARTY)
1332	prop (CFAPI_STRING, MAP_PROP_MESSAGE)	1577	prop (CFAPI_STRING, MAP_PROP_MESSAGE)
1333	prop (CFAPI_PMAP, MAP_PROP_NEXT)
1334	prop (CFAPI_PREGION, MAP_PROP_REGION)	1578	prop (CFAPI_PREGION, MAP_PROP_REGION)
1335	prop (CFAPI_POBJECT, OBJECT_PROP_OB_ABOVE)
1336	prop (CFAPI_POBJECT, OBJECT_PROP_OB_BELOW)
1337	prop (CFAPI_POBJECT, OBJECT_PROP_NEXT_ACTIVE_OB)	1579	prop (CFAPI_POBJECT, OBJECT_PROP_NEXT_ACTIVE_OB)
1338	prop (CFAPI_POBJECT, OBJECT_PROP_PREV_ACTIVE_OB)	1580	prop (CFAPI_POBJECT, OBJECT_PROP_PREV_ACTIVE_OB)
1339	prop (CFAPI_POBJECT, OBJECT_PROP_INVENTORY)	1581	prop (CFAPI_POBJECT, OBJECT_PROP_INVENTORY)
1340	prop (CFAPI_POBJECT, OBJECT_PROP_ENVIRONMENT)	1582	prop (CFAPI_POBJECT, OBJECT_PROP_ENVIRONMENT)
1341	prop (CFAPI_POBJECT, OBJECT_PROP_HEAD)
1342	prop (CFAPI_POBJECT, OBJECT_PROP_CONTAINER)	1583	prop (CFAPI_POBJECT, OBJECT_PROP_CONTAINER)
1343	prop (CFAPI_PMAP, OBJECT_PROP_MAP)	1584	prop (CFAPI_PMAP, OBJECT_PROP_MAP)
1344	prop (CFAPI_INT, OBJECT_PROP_COUNT)	1585	prop (CFAPI_INT, OBJECT_PROP_COUNT)
1345	prop (CFAPI_INT, OBJECT_PROP_REFCOUNT)	1586	prop (CFAPI_INT, OBJECT_PROP_REFCOUNT)
1346	prop (CFAPI_STRING, OBJECT_PROP_NAME)	1587	prop (CFAPI_STRING, OBJECT_PROP_NAME)
…		…
1439	}	1680	}
1440		1681
1441	//I_EVENT_API (PACKAGE);	1682	//I_EVENT_API (PACKAGE);
1442	}	1683	}
1443		1684
		1685	void _reload_1 ()
		1686	CODE:
		1687	cb_global = get_av ("cf::CB_GLOBAL", 1);
		1688	cb_object = get_av ("cf::CB_OBJECT", 1);
		1689	cb_player = get_av ("cf::CB_PLAYER", 1);
		1690	cb_type = get_av ("cf::CB_TYPE" , 1);
		1691	cb_map = get_av ("cf::CB_MAP" , 1);
		1692
		1693	void _reload_2 ()
		1694	CODE:
		1695	{
		1696	// reattach to all attachable objects in the game.
		1697	for (player *pl = first_player; pl; pl = pl->next)
		1698	reattach (pl);
		1699
		1700	for (mapstruct *map = first_map; map; map = map->next)
		1701	reattach (map);
		1702
		1703	for (object *op = objects; op; op = op->next)
		1704	reattach (op);
		1705	}
		1706
1444	NV floor (NV x)	1707	NV floor (NV x)
1445		1708
1446	NV ceil (NV x)	1709	NV ceil (NV x)
1447		1710
1448	void server_tick ()	1711	void server_tick ()
…		…
1456	PROTOTYPE: $$	1719	PROTOTYPE: $$
1457		1720
1458	char *path_combine_and_normalize (char *base, char *path)	1721	char *path_combine_and_normalize (char *base, char *path)
1459	PROTOTYPE: $$	1722	PROTOTYPE: $$
1460		1723
1461	char *	1724	const char *
1462	cf_get_maps_directory (char *path)	1725	get_maps_directory (char *path)
1463	PROTOTYPE: $	1726	PROTOTYPE: $
1464	ALIAS: maps_directory = 0	1727	ALIAS: maps_directory = 0
		1728	CODE:
		1729	RETVAL = create_pathname (path);
		1730	OUTPUT: RETVAL
1465		1731
1466	void	1732	void
1467	sub_generation_inc ()	1733	sub_generation_inc ()
1468	CODE:	1734	CODE:
1469	PL_sub_generation++;	1735	PL_sub_generation++;
…		…
1478	confdir = 3	1744	confdir = 3
1479	localdir = 4	1745	localdir = 4
1480	playerdir = 5	1746	playerdir = 5
1481	datadir = 6	1747	datadir = 6
1482	CODE:	1748	CODE:
1483	{	1749	switch (ix)
1484	int unused_type;	1750	{
1485	RETVAL = (char *)systemDirectory (&unused_type, ix);	1751	case 0: RETVAL = settings.mapdir ; break;
1486	}	1752	case 1: RETVAL = settings.uniquedir; break;
		1753	case 2: RETVAL = settings.tmpdir ; break;
		1754	case 3: RETVAL = settings.confdir ; break;
		1755	case 4: RETVAL = settings.localdir ; break;
		1756	case 5: RETVAL = settings.playerdir; break;
		1757	case 6: RETVAL = settings.datadir ; break;
		1758	}
1487	OUTPUT: RETVAL	1759	OUTPUT: RETVAL
1488		1760
1489	int	1761	int
1490	cf_find_animation (char *text)	1762	cf_find_animation (char *text)
1491	PROTOTYPE: $	1763	PROTOTYPE: $
1492		1764
1493	int random_roll(int min, int max, object *op, int goodbad);	1765	int random_roll(int min, int max, object *op, int goodbad);
1494		1766
1495	const char *cost_string_from_value(uint64 cost, int approx = 0)	1767	const char *cost_string_from_value(uint64 cost, int approx = 0)
		1768
		1769	int invoke (int event, ...)
		1770	CODE:
		1771	if (KLASS_OF (event) != KLASS_GLOBAL) croak ("event class must be GLOBAL");
		1772	AV *av = (AV *)sv_2mortal ((SV *)newAV ());
		1773	for (int i = 1; i < items; i++) av_push (av, SvREFCNT_inc (ST (i)));
		1774	RETVAL = INVOKE_((event_type)event, ARG_AV (av));
		1775	OUTPUT: RETVAL
1496		1776
1497	int	1777	int
1498	exp_to_level (val64 exp)	1778	exp_to_level (val64 exp)
1499	CODE:	1779	CODE:
1500	{	1780	{
…		…
1531	RETVAL = newSVpv (resist_plus[atnr], 0);	1811	RETVAL = newSVpv (resist_plus[atnr], 0);
1532	else	1812	else
1533	XSRETURN_UNDEF;	1813	XSRETURN_UNDEF;
1534	OUTPUT: RETVAL	1814	OUTPUT: RETVAL
1535		1815
		1816	int
		1817	_valid (SV *obj)
		1818	CODE:
		1819	RETVAL = SvROK (obj) && mg_find (SvRV (obj), PERL_MAGIC_ext);
		1820	OUTPUT:
		1821	RETVAL
		1822
1536	MODULE = cf PACKAGE = cf::object PREFIX = cf_object_	1823	MODULE = cf PACKAGE = cf::object PREFIX = cf_object_
		1824
		1825	int invoke (object *op, int event, ...)
		1826	CODE:
		1827	if (KLASS_OF (event) != KLASS_OBJECT) croak ("event class must be OBJECT");
		1828	AV *av = (AV *)sv_2mortal ((SV *)newAV ());
		1829	for (int i = 2; i < items; i++) av_push (av, SvREFCNT_inc (ST (i)));
		1830	RETVAL = INVOKE_((event_type)event, ARG_OBJECT (op), ARG_AV (av));
		1831	OUTPUT: RETVAL
		1832
		1833	SV *registry (object *op)
		1834	CODE:
		1835	RETVAL = registry_of (op);
		1836	OUTPUT:
		1837	RETVAL
		1838
		1839	object *head (object *op)
		1840	PROTOTYPE: $
		1841	ALIAS:
		1842	more = 1
		1843	above = 2
		1844	below = 3
		1845	CODE:
		1846	switch (ix)
		1847	{
		1848	case 0: RETVAL = op->head ? op->head : op; break; // DOH!
		1849	case 1: RETVAL = op->more; break;
		1850	case 2: RETVAL = op->above; break;
		1851	case 3: RETVAL = op->below; break;
		1852	}
		1853	OUTPUT:
		1854	RETVAL
1537		1855
1538	SV *	1856	SV *
1539	get_property (object *obj, int type, int idx)	1857	get_property (object *obj, int type, int idx)
1540	CODE:	1858	CODE:
1541	RETVAL = newSVcfapi (type, cf_object_get_property (obj, idx));	1859	RETVAL = newSVcfapi (type, cf_object_get_property (obj, idx));
…		…
1620		1938
1621	int need_identify (const object *obj);	1939	int need_identify (const object *obj);
1622		1940
1623	int apply_shop_mat (object *shop_mat, object *op);	1941	int apply_shop_mat (object *shop_mat, object *op);
1624		1942
1625	void cf_object_move (object *op, int dir, object *originator = op)	1943	int move (object *op, int dir, object *originator = op)
		1944	CODE:
		1945	RETVAL = move_ob (op, dir, originator);
		1946	OUTPUT:
		1947	RETVAL
1626		1948
1627	void cf_object_apply (object *op, object *author, int flags = 0)	1949	void cf_object_apply (object *op, object *author, int flags = 0)
1628		1950
1629	void cf_object_apply_below (object *op)	1951	void cf_object_apply_below (object *op)
1630		1952
…		…
1671	int cf_object_out_of_map (object *op, int x, int y)	1993	int cf_object_out_of_map (object *op, int x, int y)
1672		1994
1673	void cf_object_drop (object *op, object *author)	1995	void cf_object_drop (object *op, object *author)
1674		1996
1675	void cf_object_take (object *op, object *author)	1997	void cf_object_take (object *op, object *author)
1676
1677	void cf_object_say (object *op, char *msg)
1678
1679	void cf_object_speak (object *op, char *msg)
1680		1998
1681	object *cf_object_insert_object (object *op, object *container)	1999	object *cf_object_insert_object (object *op, object *container)
1682		2000
1683	const char *cf_object_get_msg (object *ob)	2001	const char *cf_object_get_msg (object *ob)
1684	ALIAS: msg = 0	2002	ALIAS: msg = 0
…		…
1818		2136
1819	void cf_player_set_party (object *op, partylist *party)	2137	void cf_player_set_party (object *op, partylist *party)
1820		2138
1821	void kill_player (object *op)	2139	void kill_player (object *op)
1822		2140
1823	MODULE = cf PACKAGE = cf::object::map PREFIX = cf_
1824
1825	MODULE = cf PACKAGE = cf::player PREFIX = cf_player_	2141	MODULE = cf PACKAGE = cf::player PREFIX = cf_player_
		2142
		2143	int invoke (player *pl, int event, ...)
		2144	CODE:
		2145	if (KLASS_OF (event) != KLASS_PLAYER) croak ("event class must be PLAYER");
		2146	AV *av = (AV *)sv_2mortal ((SV *)newAV ());
		2147	for (int i = 2; i < items; i++) av_push (av, SvREFCNT_inc (ST (i)));
		2148	RETVAL = INVOKE_((event_type)event, ARG_PLAYER (pl), ARG_AV (av));
		2149	OUTPUT: RETVAL
		2150
		2151	SV *registry (player *pl)
		2152	CODE:
		2153	RETVAL = registry_of (pl);
		2154	OUTPUT:
		2155	RETVAL
1826		2156
1827	player *cf_player_find (char *name)	2157	player *cf_player_find (char *name)
1828	PROTOTYPE: $	2158	PROTOTYPE: $
1829		2159
1830	void cf_player_move (player *pl, int dir)	2160	void cf_player_move (player *pl, int dir)
…		…
1949	OUTPUT: RETVAL	2279	OUTPUT: RETVAL
1950		2280
1951		2281
1952	MODULE = cf PACKAGE = cf::map PREFIX = cf_map_	2282	MODULE = cf PACKAGE = cf::map PREFIX = cf_map_
1953		2283
		2284	mapstruct *first ()
		2285	PROTOTYPE:
		2286	CODE:
		2287	RETVAL = first_map;
		2288	OUTPUT: RETVAL
		2289
		2290	mapstruct *next (mapstruct *map)
		2291	PROTOTYPE:
		2292	CODE:
		2293	RETVAL = map->next;
		2294	OUTPUT: RETVAL
		2295
		2296	int invoke (mapstruct *map, int event, ...)
		2297	CODE:
		2298	if (KLASS_OF (event) != KLASS_MAP) croak ("event class must be MAP");
		2299	AV *av = (AV *)sv_2mortal ((SV *)newAV ());
		2300	for (int i = 2; i < items; i++) av_push (av, SvREFCNT_inc (ST (i)));
		2301	RETVAL = INVOKE_((event_type)event, ARG_MAP (map), ARG_AV (av));
		2302	OUTPUT: RETVAL
		2303
		2304	SV *registry (mapstruct *map)
		2305	CODE:
		2306	RETVAL = registry_of (map);
		2307	OUTPUT:
		2308	RETVAL
		2309
1954	SV *	2310	SV *
1955	get_property (mapstruct *obj, int type, int idx)	2311	get_property (mapstruct *obj, int type, int idx)
1956	CODE:	2312	CODE:
1957	RETVAL = newSVcfapi (type, cf_map_get_property (obj, idx));	2313	RETVAL = newSVcfapi (type, cf_map_get_property (obj, idx));
1958	OUTPUT: RETVAL	2314	OUTPUT: RETVAL
…		…
1971		2327
1972	mapstruct *new (int width, int height)	2328	mapstruct *new (int width, int height)
1973	PROTOTYPE:	2329	PROTOTYPE:
1974	CODE:	2330	CODE:
1975	{	2331	{
1976	int unused_type;	2332	RETVAL = get_empty_map (width, height);
1977	RETVAL = (mapstruct*) map_get_map (&unused_type, 0, width, height);
1978	}	2333	}
1979	OUTPUT:	2334	OUTPUT:
1980	RETVAL	2335	RETVAL
1981		2336
1982	void delete_map (mapstruct *map)	2337	void delete_map (mapstruct *map)
…		…
1997	XSRETURN_UNDEF;	2352	XSRETURN_UNDEF;
1998	RETVAL = map->tile_path [dir];	2353	RETVAL = map->tile_path [dir];
1999	OUTPUT:	2354	OUTPUT:
2000	RETVAL	2355	RETVAL
2001		2356
2002	mapstruct *cf_map_get_map (char *name)	2357	mapstruct *ready_map_name (char *name, int flags = 0)
2003	PROTOTYPE: $	2358	PROTOTYPE: $;$
2004	ALIAS: map = 0	2359	ALIAS:
		2360	find = 0
		2361	get_map = 1
2005		2362
2006	mapstruct *has_been_loaded (char *name)	2363	mapstruct *has_been_loaded (char *name)
2007	PROTOTYPE: $	2364	PROTOTYPE: $
2008
2009	mapstruct *cf_map_get_first ()
2010	PROTOTYPE:
2011	ALIAS: first = 0
2012		2365
2013	# whoever "designed" the plug-in api should have wasted	2366	# whoever "designed" the plug-in api should have wasted
2014	# his/her time with staying away from the project - would have	2367	# his/her time with staying away from the project - would have
2015	# saved others a lot of time, without doubt.	2368	# saved others a lot of time, without doubt.
2016	void set_path (mapstruct *where, char *path)	2369	void set_path (mapstruct *where, char *path)
…		…
2031		2384
2032	void set_unique (mapstruct *map, bool unique)	2385	void set_unique (mapstruct *map, bool unique)
2033	CODE:	2386	CODE:
2034	map->unique = unique;	2387	map->unique = unique;
2035		2388
		2389	void
		2390	trigger (mapstruct *map, long connection, bool state = true)
		2391	CODE:
		2392	activate_connection (map, connection, state);
		2393
		2394	void
		2395	get_connection (mapstruct *map, long connection)
		2396	PPCODE:
		2397	oblinkpt *obp = get_connection_links (map, connection);
		2398	if (obp)
		2399	for (objectlink *ol = obp->link; ol; ol = ol->next)
		2400	XPUSHs (sv_2mortal (newSVcfapi (CFAPI_POBJECT, ol->ob)));
		2401
2036	object *cf_map_insert_object_there (mapstruct *where, object *op, object *originator, int flags)	2402	object *cf_map_insert_object_there (mapstruct *where, object *op, object *originator, int flags)
2037		2403
2038	object *cf_map_insert_object (mapstruct *where, object* op, int x, int y)	2404	object *cf_map_insert_object (mapstruct *where, object* op, int x, int y)
2039		2405
2040	object* cf_map_present_arch_by_name (mapstruct *map, const char* str, int nx, int ny)	2406	object* cf_map_present_arch_by_name (mapstruct *map, const char* str, int nx, int ny)
…		…
2044	cf_map_normalise (mapstruct *map, int x, int y)	2410	cf_map_normalise (mapstruct *map, int x, int y)
2045	PPCODE:	2411	PPCODE:
2046	{	2412	{
2047	mapstruct *nmap = 0;	2413	mapstruct *nmap = 0;
2048	I16 nx = 0, ny = 0;	2414	I16 nx = 0, ny = 0;
2049	int flags = cf_map_get_flags (map, &nmap, x, y, &nx, &ny);	2415	int flags = get_map_flags (map, &nmap, x, y, &nx, &ny);
2050		2416
2051	EXTEND (SP, 4);	2417	EXTEND (SP, 4);
2052	PUSHs (sv_2mortal (newSViv (flags)));	2418	PUSHs (sv_2mortal (newSViv (flags)));
2053		2419
2054	if (GIMME_V == G_ARRAY)	2420	if (GIMME_V == G_ARRAY)
…		…
2066	{	2432	{
2067	object *o;	2433	object *o;
2068	mapstruct *nmap = 0;	2434	mapstruct *nmap = 0;
2069	I16 nx, ny;	2435	I16 nx, ny;
2070		2436
2071	cf_map_get_flags (map, &nmap, x, y, &nx, &ny);	2437	get_map_flags (map, &nmap, x, y, &nx, &ny);
2072		2438
2073	if (nmap)	2439	if (nmap)
2074	for (o = GET_MAP_OB (nmap, nx, ny); o; o = o->above)	2440	for (o = GET_MAP_OB (nmap, nx, ny); o; o = o->above)
2075	XPUSHs (sv_2mortal (newSVcfapi (CFAPI_POBJECT, o)));	2441	XPUSHs (sv_2mortal (newSVcfapi (CFAPI_POBJECT, o)));
2076	}	2442	}
…		…
2101	case 7: RETVAL = newSVuv ( GET_MAP_MOVE_OFF (obj, x, y)); break;	2467	case 7: RETVAL = newSVuv ( GET_MAP_MOVE_OFF (obj, x, y)); break;
2102	}	2468	}
2103	OUTPUT:	2469	OUTPUT:
2104	RETVAL	2470	RETVAL
2105		2471
2106	# "serialise" map perl data into a ref
2107	void
2108	_get_obs (mapstruct *map)
2109	PPCODE:
2110	{
2111	object *o;
2112	int x, y;
2113	AV *obs = newAV ();
2114	int nonnull = 0;
2115		2472
2116	for (y = 0; y < MAP_HEIGHT (map); y++)	2473	MODULE = cf PACKAGE = cf::arch
2117	for (x = 0; x < MAP_WIDTH (map); x++)
2118	{
2119	AV *av = newAV ();
2120		2474
2121	for (o = GET_MAP_OB (map, x, y); o; o = o->above)	2475	archetype *find (const char *name)
2122	{	2476	CODE:
2123	SV *sv = SVptr_cache_get (o);	2477	RETVAL = find_archetype (name);
		2478	OUTPUT:
		2479	RETVAL
2124		2480
2125	if (sv && HvFILL (SvRV (sv)))	2481	archetype *first()
2126	{
2127	nonnull = 1;
2128	sv = newSVsv (sv);
2129	}
2130	else
2131	sv = &PL_sv_undef;
2132
2133	av_push (av, sv);
2134	}
2135
2136	av_store (obs, x + y * MAP_HEIGHT (map), newRV_noinc ((SV *)av));
2137	}
2138
2139	if (nonnull)
2140	XPUSHs (sv_2mortal (newRV_noinc ((SV *)obs)));
2141	else
2142	SvREFCNT_dec (obs);
2143	}
2144
2145	# "deserialise" perl map data into the map
2146	void
2147	_set_obs (mapstruct *map, SV *sv)
2148	CODE:
2149	{
2150	object *o;
2151	AV *av;
2152	int x, y;
2153	AV *obs = (AV *)SvRV (sv);
2154
2155	for (y = 0; y < MAP_HEIGHT (map); y++)
2156	for (x = 0; x < MAP_WIDTH (map); x++)
2157	{
2158	sv = *av_fetch (obs, x + y * MAP_HEIGHT (map), 1);
2159
2160	if (!SvROK (sv))
2161	continue;
2162
2163	av = (AV *)SvRV (sv);
2164
2165	for (o = GET_MAP_OB (map, x, y); o; o = o->above)
2166	{
2167	sv = av_shift (av);
2168
2169	if (SvROK (sv))
2170	{
2171	sv_magic ((SV *)SvRV (sv), 0, PERL_MAGIC_ext, (char *)o, 0);
2172	SVptr_cache_set (o, sv);
2173	}
2174	}
2175	}
2176	}
2177
2178
2179	MODULE = cf PACKAGE = cf::arch PREFIX = cf_archetype_
2180
2181	archetype *cf_archetype_get_first()
2182	PROTOTYPE:	2482	PROTOTYPE:
2183	ALIAS: first = 0	2483	CODE:
		2484	RETVAL = first_archetype;
		2485	OUTPUT: RETVAL
2184		2486
2185	archetype *cf_archetype_get_next (archetype *arch)	2487	archetype *next (archetype *arch)
2186	ALIAS: next = 0	2488	CODE:
		2489	RETVAL = arch->next;
		2490	OUTPUT: RETVAL
2187		2491
2188	archetype *cf_archetype_get_head (archetype *arch)	2492	archetype *head (archetype *arch)
2189	ALIAS: head = 0	2493	CODE:
		2494	RETVAL = arch->head;
		2495	OUTPUT: RETVAL
2190		2496
2191	archetype *cf_archetype_get_more (archetype *arch)	2497	archetype *more (archetype *arch)
2192	ALIAS: more = 0	2498	CODE:
		2499	RETVAL = arch->more;
		2500	OUTPUT: RETVAL
2193		2501
2194	const char *cf_archetype_get_name (archetype *arch)	2502	const char *name (archetype *arch)
2195	ALIAS: name = 0	2503	CODE:
		2504	RETVAL = arch->name;
		2505	OUTPUT: RETVAL
2196		2506
2197	object *cf_archetype_get_clone (archetype *arch)	2507	object *clone (archetype *arch)
2198	ALIAS: clone = 0	2508	CODE:
		2509	RETVAL = &arch->clone;
		2510	OUTPUT: RETVAL
2199		2511
2200	MODULE = cf PACKAGE = cf::party PREFIX = cf_party_	2512	MODULE = cf PACKAGE = cf::party
2201		2513
2202	partylist *cf_party_get_first ()	2514	partylist *first ()
2203	PROTOTYPE:	2515	PROTOTYPE:
2204	ALIAS: first = 0	2516	CODE:
		2517	RETVAL = get_firstparty ();
		2518	OUTPUT: RETVAL
2205		2519
2206	partylist *cf_party_get_next (partylist *party)	2520	partylist *next (partylist *party)
2207	ALIAS: next = 0	2521	CODE:
		2522	RETVAL = party->next;
		2523	OUTPUT: RETVAL
2208		2524
2209	const char *cf_party_get_name (partylist *party)	2525	const char *name (partylist *party)
		2526	CODE:
		2527	RETVAL = party->partyname;
		2528	OUTPUT: RETVAL
2210		2529
2211	const char *cf_party_get_password (partylist *party)	2530	const char *password (partylist *party)
2212	ALIAS: password = 0	2531	CODE:
		2532	RETVAL = party->passwd;
		2533	OUTPUT: RETVAL
2213		2534
2214	player *cf_party_get_first_player (partylist *party)	2535	MODULE = cf PACKAGE = cf::region
2215	ALIAS: first_player = 0
2216		2536
2217	player *cf_party_get_next_player (partylist *party, player *op)	2537	region *first ()
2218	ALIAS: next_player = 0
2219
2220
2221	MODULE = cf PACKAGE = cf::region PREFIX = cf_region_
2222
2223	region *cf_region_get_first ()
2224	PROTOTYPE:	2538	PROTOTYPE:
2225	ALIAS: first = 0	2539	CODE:
		2540	RETVAL = first_region;
		2541	OUTPUT: RETVAL
2226		2542
		2543	region *next (region *reg)
		2544	CODE:
		2545	RETVAL = reg->next;
		2546	OUTPUT: RETVAL
		2547
		2548	const char *name (region *reg)
		2549	CODE:
		2550	RETVAL = reg->name;
		2551	OUTPUT: RETVAL
		2552
		2553	region *parent (region *reg)
		2554	CODE:
		2555	RETVAL = reg->parent;
		2556	OUTPUT: RETVAL
		2557
2227	const char *cf_region_get_name (region *reg)	2558	const char *longname (region *reg)
2228	ALIAS: name = 0	2559	CODE:
		2560	RETVAL = reg->longname;
		2561	OUTPUT: RETVAL
2229		2562
2230	region *cf_region_get_next (region *reg)	2563	const char *msg (region *reg)
2231	ALIAS: next = 0	2564	CODE:
		2565	RETVAL = reg->msg;
		2566	OUTPUT: RETVAL
2232		2567
2233	region *cf_region_get_parent (region *reg)	2568	MODULE = cf PACKAGE = cf::living
2234	ALIAS: parent = 0
2235
2236	const char *cf_region_get_longname (region *reg)
2237	ALIAS: longname = 0
2238
2239	const char *cf_region_get_message (region *reg)
2240	ALIAS: message = 0
2241
2242
2243	MODULE = cf PACKAGE = cf::living PREFIX = cf_living_
2244		2569
2245	val64	2570	val64
2246	exp (living *liv, val64 new_val = 0)	2571	exp (living *liv, val64 new_val = 0)
2247	PROTOTYPE: $;$	2572	PROTOTYPE: $;$
2248	ALIAS:	2573	ALIAS:

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines