ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/plugins/cfperl/cfperl.xs
Revision: 1.40
Committed: Sun Mar 26 15:52:03 2006 UTC (18 years, 3 months ago) by root
Branch: MAIN
Changes since 1.39: +4 -0 lines
Log Message:
- support cf-native key_value pairs in perl
- use it when saving players and their inventory to store perl data
- keep compatibility to the old format for the time being

File Contents

# Content
1 /*****************************************************************************/
2 /* CrossFire, A Multiplayer game for the X Window System */
3 /* */
4 /*****************************************************************************/
5
6 /*
7 * This code is placed under the GNU General Public Licence (GPL)
8 *
9 * Copyright (C) 2001-2005 by Chachkoff Yann
10 * Copyright (C) 2006 by Marc Lehmann <cf@schmorpd.e>
11 *
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
16 *
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
21 *
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
25 */
26
27 #include <EXTERN.h>
28 #include <perl.h>
29 #include <XSUB.h>
30
31 #undef save_long // clashes with libproto.h
32
33 #define PLUGIN_NAME "perl"
34 #define PLUGIN_VERSION "cfperl 0.2"
35
36 #ifndef __CEXTRACT__
37 #include <plugin.h>
38 #endif
39
40 #undef MODULEAPI
41 #ifdef WIN32
42 #else
43 #define MODULEAPI
44 #endif
45
46 #include <plugin_common.h>
47 #include <sounds.h>
48
49 #include <stdarg.h>
50
51 #include "perlxsi.c"
52
53 typedef object object_ornull;
54 typedef mapstruct mapstruct_ornull;
55
56 static f_plug_api gethook;
57 static f_plug_api registerGlobalEvent;
58 static f_plug_api unregisterGlobalEvent;
59 static f_plug_api systemDirectory;
60 static f_plug_api object_set_property;
61 static f_plug_api map_get_map;
62 static f_plug_api object_insert;
63
64 /* this is a stupid way to do things, and awkward to use for plug-in authors */
65 typedef struct
66 {
67 object* who;
68 object* activator;
69 object* third;
70 mapstruct* map;
71 char message[1024];
72 int fix; // seems to be python-only, and should not be part of the API
73 int event_code;
74 char extension[1024]; // name field, should invoke specific perl extension
75 char options[1024]; // slaying field of event_connectors
76 int returnvalue;
77 } CFPContext;
78
79 static HV *obj_cache;
80 static PerlInterpreter *perl;
81
82 //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
83
84 // garbage collect some perl objects, if possible
85 // all objects no longer referenced and empty are
86 // eligible for destruction.
87 void
88 clean_obj_cache ()
89 {
90 static int count;
91
92 if (++count & 7)
93 return;
94
95 int todo = 1000;
96 do
97 {
98 I32 klen;
99 char *key;
100 HE *he = hv_iternext (obj_cache);
101
102 if (he)
103 {
104 SV *sv = hv_iterval (obj_cache, he);
105
106 // empty and unreferenced? nuke it
107 if (SvREFCNT (sv) == 1 && SvREFCNT (SvRV (sv)) == 1 && !HvFILL ((HV *)(SvRV (sv))))
108 {
109 hv_delete (obj_cache, HeKEY (he), HeKLEN (he), G_DISCARD);
110 todo++;
111 }
112 }
113 else
114 break;
115 }
116 while (--todo);
117 }
118
119 static SV *
120 newSVptr (void *ptr, const char *klass)
121 {
122 SV *sv;
123
124 if (!ptr)
125 return &PL_sv_undef;
126
127 sv = newSV (0);
128 sv_magic (sv, 0, PERL_MAGIC_ext, (char *)ptr, 0);
129 return sv_bless (newRV_noinc (sv), gv_stashpv (klass, 1));
130 }
131
132 static void
133 SVptr_cache_set (void *ptr, SV *sv)
134 {
135 hv_store (obj_cache, (char *)&ptr, sizeof (ptr), sv, 0);
136 }
137
138 static SV *
139 SVptr_cache_get (void *ptr)
140 {
141 SV **he = hv_fetch (obj_cache, (char *)&ptr, sizeof (ptr), 0);
142
143 return he ? *he : 0;
144 }
145
146 static SV *
147 newSVptr_cached (void *ptr, const char *klass)
148 {
149 SV *sv;
150
151 if (!ptr)
152 return &PL_sv_undef;
153
154 sv = SVptr_cache_get (ptr);
155
156 if (!sv)
157 {
158 HV *hv = newHV ();
159 sv_magic ((SV *)hv, 0, PERL_MAGIC_ext, (char *)ptr, 0);
160 sv = sv_bless (newRV_noinc ((SV *)hv), gv_stashpv (klass, 1));
161
162 SVptr_cache_set (ptr, sv);
163 }
164
165 return newSVsv (sv);
166 }
167
168 static void
169 clearSVptr (SV *sv)
170 {
171 if (SvROK (sv))
172 sv = SvRV (sv);
173
174 hv_clear ((HV *)sv);
175 sv_unmagic (sv, PERL_MAGIC_ext);
176 }
177
178 static long
179 SvPTR (SV *sv, const char *klass)
180 {
181 if (!sv_derived_from (sv, klass))
182 croak ("object of type %s expected", klass);
183
184 MAGIC *mg = mg_find (SvRV (sv), PERL_MAGIC_ext);
185
186 if (!mg)
187 croak ("perl code used %s object, but C object is already destroyed, caught", klass);
188
189 return (long)mg->mg_ptr;
190 }
191
192 static long
193 SvPTR_ornull (SV *sv, const char *klass)
194 {
195 if (SvOK (sv))
196 return SvPTR (sv, klass);
197 else
198 return 0;
199 }
200
201 SV *
202 newSVcfapi (int type, ...)
203 {
204 SV *sv;
205
206 va_list args;
207 va_start (args, type);
208
209 switch (type)
210 {
211 #if 0
212 case CFAPI_INT16:
213 sv = newSViv (*va_arg (args, sint16_t *));
214 break;
215 #endif
216
217 case CFAPI_INT:
218 sv = newSViv (*va_arg (args, int *));
219 break;
220
221 case CFAPI_LONG:
222 sv = newSVnv ((double)*va_arg (args, sint64 *)); /* oh, the humanity! */
223 break;
224
225 case CFAPI_DOUBLE:
226 sv = newSViv (*va_arg (args, double *));
227 break;
228
229 case CFAPI_STRING:
230 {
231 char *str = va_arg (args, char *);
232 sv = str ? newSVpv (str, 0) : &PL_sv_undef;
233 }
234 break;
235
236 case CFAPI_POBJECT:
237 {
238 object *obj = va_arg (args, object *);
239
240 if (!obj)
241 sv = &PL_sv_undef;
242 else
243 switch (*(int *)cf_object_get_property (obj, CFAPI_OBJECT_PROP_TYPE))
244 {
245 case MAP:
246 sv = newSVptr_cached (obj, "cf::object::map");
247 break;
248
249 case PLAYER:
250 sv = newSVptr_cached (obj, "cf::object::player");
251 break;
252
253 default:
254 sv = newSVptr_cached (obj, "cf::object");
255 break;
256 }
257 }
258 break;
259
260 case CFAPI_PMAP:
261 sv = newSVptr (va_arg (args, mapstruct *), "cf::map");
262 break;
263
264 case CFAPI_PPLAYER:
265 sv = newSVptr (va_arg (args, player *), "cf::player");
266 break;
267
268 case CFAPI_PARCH:
269 sv = newSVptr (va_arg (args, archetype *), "cf::arch");
270 break;
271
272 case CFAPI_PPARTY:
273 sv = newSVptr (va_arg (args, partylist *), "cf::party");
274 break;
275
276 case CFAPI_PREGION:
277 sv = newSVptr (va_arg (args, region *), "cf::region");
278 break;
279
280 default:
281 assert (("unhandled type in newSVcfapi", 0));
282 }
283
284 va_end (args);
285
286 return sv;
287 }
288
289 /////////////////////////////////////////////////////////////////////////////
290
291 void
292 inject_event (const char *func, CFPContext *context)
293 {
294 dSP;
295
296 ENTER;
297 SAVETMPS;
298
299 PUSHMARK (SP);
300
301 HV *hv = newHV ();
302 #define hv_context(type,addr,expr) hv_store (hv, #expr, sizeof (#expr) - 1, newSVcfapi (type, addr context->expr), 0)
303 hv_context (CFAPI_POBJECT, ,who);
304 hv_context (CFAPI_POBJECT, ,activator);
305 hv_context (CFAPI_POBJECT, ,third);
306 hv_context (CFAPI_PMAP, ,map);
307 hv_context (CFAPI_STRING , ,message);
308 hv_context (CFAPI_INT ,&,fix);
309 hv_context (CFAPI_INT ,&,event_code);
310 hv_context (CFAPI_STRING , ,options);
311 hv_context (CFAPI_STRING , ,extension);
312
313 XPUSHs (sv_2mortal (newRV_noinc ((SV *)hv)));
314
315 PUTBACK;
316 int count = call_pv (func, G_SCALAR | G_EVAL);
317 SPAGAIN;
318
319 if (SvTRUE (ERRSV))
320 LOG (llevError, "event '%d' callback evaluation error: %s", context->event_code, SvPV_nolen (ERRSV));
321
322 context->returnvalue = count > 0 ? POPi : 0;
323
324 PUTBACK;
325 FREETMPS;
326 LEAVE;
327 }
328
329 /////////////////////////////////////////////////////////////////////////////
330
331 int
332 initPlugin (const char *iversion, f_plug_api gethooksptr)
333 {
334 gethook = gethooksptr;
335 printf (PLUGIN_VERSION " init\n");
336
337 return 0;
338 }
339
340 static CommArray_s rtn_cmd;
341
342 int
343 runPluginCommand (object *obj, char *params)
344 {
345 dSP;
346
347 ENTER;
348 SAVETMPS;
349
350 PUSHMARK (SP);
351
352 EXTEND (SP, 3);
353 PUSHs (sv_2mortal (newSVpv (rtn_cmd.name, 0)));
354 PUSHs (sv_2mortal (newSVcfapi (CFAPI_POBJECT, obj)));
355
356 if (params)
357 PUSHs (sv_2mortal (newSVpv (params, 0)));
358
359 PUTBACK;
360 int count = call_pv ("cf::inject_command", G_SCALAR | G_EVAL);
361 SPAGAIN;
362
363 if (SvTRUE (ERRSV))
364 LOG (llevError, "command '%s' callback evaluation error: %s", rtn_cmd.name, SvPV_nolen (ERRSV));
365
366 int returnvalue = count > 0 ? POPi : -1;
367
368 PUTBACK;
369 FREETMPS;
370 LEAVE;
371
372 return returnvalue;
373 }
374
375 void *
376 getPluginProperty (int *type, ...)
377 {
378 va_list args;
379 char *propname;
380 int i;
381 va_start (args, type);
382 propname = va_arg (args, char *);
383 //printf ("Property name: %s\n", propname);
384
385 if (!strcmp (propname, "command?"))
386 {
387 if (!perl)
388 return NULL;
389
390 const char *cmdname = va_arg (args, const char *);
391 HV *hv = get_hv ("cf::COMMAND", 1);
392 SV **svp = hv_fetch (hv, cmdname, strlen (cmdname) + 1, 0);
393
394 va_end (args);
395
396 if (svp)
397 {
398 // this is totaly broken, should stash it into %COMMAND
399 rtn_cmd.name = cmdname;
400 rtn_cmd.time = SvNV (*svp);
401 rtn_cmd.func = runPluginCommand;
402
403 return &rtn_cmd;
404 }
405 }
406 else if (!strcmp (propname, "Identification"))
407 {
408 va_end (args);
409 return PLUGIN_NAME;
410 }
411 else if (!strcmp (propname, "FullName"))
412 {
413 va_end (args);
414 return PLUGIN_VERSION;
415 }
416 else
417 va_end (args);
418
419 return NULL;
420 }
421
422 void *globalEventListener (int *type, ...);
423
424 int
425 postInitPlugin ()
426 {
427 int hooktype = 1;
428 int rtype = 0;
429
430 printf (PLUGIN_VERSION " post init\n");
431
432 registerGlobalEvent = gethook (&rtype, hooktype, "cfapi_system_register_global_event");
433 unregisterGlobalEvent = gethook (&rtype, hooktype, "cfapi_system_unregister_global_event");
434 systemDirectory = gethook (&rtype, hooktype, "cfapi_system_directory");
435 object_set_property = gethook (&rtype, hooktype, "cfapi_object_set_property");
436 map_get_map = gethook (&rtype, hooktype, "cfapi_map_get_map");
437 object_insert = gethook (&rtype, hooktype, "cfapi_object_insert");
438
439 cf_init_plugin (gethook);
440
441 /* Pick the global events you want to monitor from this plugin */
442 registerGlobalEvent (NULL, EVENT_BORN, PLUGIN_NAME, globalEventListener);
443 registerGlobalEvent (NULL, EVENT_CLOCK, PLUGIN_NAME, globalEventListener);
444 //registerGlobalEvent (NULL, EVENT_CRASH, PLUGIN_NAME, globalEventListener);
445 registerGlobalEvent (NULL, EVENT_PLAYER_DEATH, PLUGIN_NAME, globalEventListener);
446 registerGlobalEvent (NULL, EVENT_GKILL, PLUGIN_NAME, globalEventListener);
447 registerGlobalEvent (NULL, EVENT_LOGIN, PLUGIN_NAME, globalEventListener);
448 registerGlobalEvent (NULL, EVENT_LOGOUT, PLUGIN_NAME, globalEventListener);
449 registerGlobalEvent (NULL, EVENT_MAPENTER, PLUGIN_NAME, globalEventListener);
450 registerGlobalEvent (NULL, EVENT_MAPLEAVE, PLUGIN_NAME, globalEventListener);
451 registerGlobalEvent (NULL, EVENT_MAPRESET, PLUGIN_NAME, globalEventListener);
452 registerGlobalEvent (NULL, EVENT_MAPLOAD, PLUGIN_NAME, globalEventListener);
453 registerGlobalEvent (NULL, EVENT_MAPOUT, PLUGIN_NAME, globalEventListener);
454 registerGlobalEvent (NULL, EVENT_MAPIN, PLUGIN_NAME, globalEventListener);
455 registerGlobalEvent (NULL, EVENT_MAPCLEAN, PLUGIN_NAME, globalEventListener);
456 registerGlobalEvent (NULL, EVENT_REMOVE, PLUGIN_NAME, globalEventListener);
457 registerGlobalEvent (NULL, EVENT_SHOUT, PLUGIN_NAME, globalEventListener);
458 registerGlobalEvent (NULL, EVENT_TELL, PLUGIN_NAME, globalEventListener);
459 registerGlobalEvent (NULL, EVENT_MUZZLE, PLUGIN_NAME, globalEventListener);
460 registerGlobalEvent (NULL, EVENT_KICK, PLUGIN_NAME, globalEventListener);
461 registerGlobalEvent (NULL, EVENT_FREE_OB, PLUGIN_NAME, globalEventListener);
462 registerGlobalEvent (NULL, EVENT_PLAYER_LOAD, PLUGIN_NAME, globalEventListener);
463 registerGlobalEvent (NULL, EVENT_PLAYER_SAVE, PLUGIN_NAME, globalEventListener);
464
465 char *argv[] = {
466 "",
467 "-e"
468 "BEGIN {"
469 " cf->bootstrap;"
470 " unshift @INC, cf::datadir ();"
471 "}"
472 ""
473 "use cf;"
474 };
475
476 perl = perl_alloc ();
477 perl_construct (perl);
478
479 if (perl_parse (perl, xs_init, 2, argv, (char **)NULL) || perl_run (perl))
480 {
481 printf ("unable to initialize perl-interpreter, continuing without.\n");
482
483 perl_destruct (perl);
484 perl_free (perl);
485 perl = 0;
486 }
487 else
488 {
489 obj_cache = newHV ();
490 }
491
492 return 0;
493 }
494
495 void *
496 globalEventListener (int *type, ...)
497 {
498 va_list args;
499 static int rv = 0;
500 CFPContext context;
501 char *buf;
502 player *pl;
503 object *op;
504
505 if (!perl)
506 return;
507
508 memset (&context, 0, sizeof (context));
509
510 va_start (args, type);
511 context.event_code = va_arg (args, int);
512
513 switch (context.event_code)
514 {
515 case EVENT_CRASH:
516 printf ("Unimplemented for now\n");
517 break;
518
519 case EVENT_PLAYER_LOAD:
520 case EVENT_PLAYER_SAVE:
521 context.who = va_arg (args, object *);
522 buf = va_arg (args, char *);
523 if (buf != 0)
524 strncpy (context.message, buf, sizeof (context.message));
525 break;
526
527 case EVENT_MAPLOAD:
528 case EVENT_MAPOUT:
529 case EVENT_MAPIN:
530 case EVENT_MAPCLEAN:
531 context.map = va_arg (args, mapstruct *);
532 break;
533
534 case EVENT_MAPENTER:
535 case EVENT_MAPLEAVE:
536 case EVENT_FREE_OB:
537 case EVENT_BORN:
538 case EVENT_REMOVE:
539 context.activator = va_arg (args, object *);
540 break;
541
542 case EVENT_PLAYER_DEATH:
543 context.who = va_arg (args, object *);
544 break;
545
546 case EVENT_GKILL:
547 context.who = va_arg (args, object *);
548 context.activator = va_arg (args, object *);
549 break;
550
551 case EVENT_LOGIN:
552 case EVENT_LOGOUT:
553 pl = va_arg (args, player *);
554 context.activator = pl->ob;
555 buf = va_arg (args, char *);
556 if (buf != 0)
557 strncpy (context.message, buf, sizeof (context.message));
558 break;
559
560 case EVENT_SHOUT:
561 case EVENT_MUZZLE:
562 case EVENT_KICK:
563 context.activator = va_arg (args, object *);
564 buf = va_arg (args, char *);
565 if (buf != 0)
566 strncpy (context.message, buf, sizeof (context.message));
567 break;
568
569 case EVENT_CLOCK:
570 clean_obj_cache ();
571 break;
572
573 case EVENT_TELL:
574 break;
575
576 case EVENT_MAPRESET:
577 /* stupid, should be the map itself, not "message"??? */
578 buf = va_arg (args, char *);
579 if (buf != 0)
580 strncpy (context.message, buf, sizeof (context.message));
581 break;
582 }
583
584 va_end (args);
585
586 if (context.event_code == EVENT_FREE_OB)
587 {
588 SV *sv = hv_delete (obj_cache, (char *)&context.activator, sizeof (void *), 0);
589
590 if (sv)
591 clearSVptr (sv);
592 }
593 else
594 inject_event ("cf::inject_global_event", &context);
595
596 rv = context.returnvalue;
597
598 return &rv;
599 }
600
601 void *
602 eventListener (int *type, ...)
603 {
604 static int rv = 0;
605 va_list args;
606 char *buf;
607 CFPContext context;
608
609 if (!perl)
610 return;
611
612 memset (&context, 0, sizeof (context));
613
614 va_start (args, type);
615
616 context.who = va_arg (args, object *);
617 context.event_code = va_arg (args, int);
618 context.activator = va_arg (args, object *);
619 context.third = va_arg (args, object *);
620
621 buf = va_arg (args, char *);
622 if (buf != 0)
623 strncpy (context.message, buf, sizeof (context.message));
624
625 context.fix = va_arg (args, int);
626 strncpy (context.extension, va_arg (args, char *), sizeof (context.extension));
627 strncpy (context.options, va_arg (args, char *), sizeof (context.options));
628 context.returnvalue = 0;
629 va_end (args);
630
631 inject_event ("cf::inject_event", &context);
632
633 rv = context.returnvalue;
634 return &rv;
635 }
636
637 int
638 closePlugin ()
639 {
640 printf (PLUGIN_VERSION " closing\n");
641
642 if (perl)
643 {
644 perl_destruct (perl);
645 perl_free (perl);
646 perl = 0;
647 }
648
649 return 0;
650 }
651
652 MODULE = cf PACKAGE = cf PREFIX = cf_
653
654 BOOT:
655 {
656 HV *stash = gv_stashpv ("cf", 1);
657
658 static const struct {
659 const char *name;
660 IV iv;
661 } *civ, const_iv[] = {
662 # define const_iv(name) { # name, (IV)name },
663 const_iv (llevError)
664 const_iv (llevInfo)
665 const_iv (llevDebug)
666 const_iv (llevMonster)
667
668 const_iv (PLAYER)
669 const_iv (TRANSPORT)
670 const_iv (ROD)
671 const_iv (TREASURE)
672 const_iv (POTION)
673 const_iv (FOOD)
674 const_iv (POISON)
675 const_iv (BOOK)
676 const_iv (CLOCK)
677 const_iv (LIGHTNING)
678 const_iv (ARROW)
679 const_iv (BOW)
680 const_iv (WEAPON)
681 const_iv (ARMOUR)
682 const_iv (PEDESTAL)
683 const_iv (ALTAR)
684 const_iv (LOCKED_DOOR)
685 const_iv (SPECIAL_KEY)
686 const_iv (MAP)
687 const_iv (DOOR)
688 const_iv (KEY)
689 const_iv (TIMED_GATE)
690 const_iv (TRIGGER)
691 const_iv (GRIMREAPER)
692 const_iv (MAGIC_EAR)
693 const_iv (TRIGGER_BUTTON)
694 const_iv (TRIGGER_ALTAR)
695 const_iv (TRIGGER_PEDESTAL)
696 const_iv (SHIELD)
697 const_iv (HELMET)
698 const_iv (HORN)
699 const_iv (MONEY)
700 const_iv (CLASS)
701 const_iv (GRAVESTONE)
702 const_iv (AMULET)
703 const_iv (PLAYERMOVER)
704 const_iv (TELEPORTER)
705 const_iv (CREATOR)
706 const_iv (SKILL)
707 const_iv (EXPERIENCE)
708 const_iv (EARTHWALL)
709 const_iv (GOLEM)
710 const_iv (THROWN_OBJ)
711 const_iv (BLINDNESS)
712 const_iv (GOD)
713 const_iv (DETECTOR)
714 const_iv (TRIGGER_MARKER)
715 const_iv (DEAD_OBJECT)
716 const_iv (DRINK)
717 const_iv (MARKER)
718 const_iv (HOLY_ALTAR)
719 const_iv (PLAYER_CHANGER)
720 const_iv (BATTLEGROUND)
721 const_iv (PEACEMAKER)
722 const_iv (GEM)
723 const_iv (FIREWALL)
724 const_iv (ANVIL)
725 const_iv (CHECK_INV)
726 const_iv (MOOD_FLOOR)
727 const_iv (EXIT)
728 const_iv (ENCOUNTER)
729 const_iv (SHOP_FLOOR)
730 const_iv (SHOP_MAT)
731 const_iv (RING)
732 const_iv (FLOOR)
733 const_iv (FLESH)
734 const_iv (INORGANIC)
735 const_iv (SKILL_TOOL)
736 const_iv (LIGHTER)
737 const_iv (TRAP_PART)
738 const_iv (WALL)
739 const_iv (LIGHT_SOURCE)
740 const_iv (MISC_OBJECT)
741 const_iv (MONSTER)
742 const_iv (SPAWN_GENERATOR)
743 const_iv (LAMP)
744 const_iv (DUPLICATOR)
745 const_iv (TOOL)
746 const_iv (SPELLBOOK)
747 const_iv (BUILDFAC)
748 const_iv (CLOAK)
749 const_iv (SPINNER)
750 const_iv (GATE)
751 const_iv (BUTTON)
752 const_iv (CF_HANDLE)
753 const_iv (HOLE)
754 const_iv (TRAPDOOR)
755 const_iv (SIGN)
756 const_iv (BOOTS)
757 const_iv (GLOVES)
758 const_iv (SPELL)
759 const_iv (SPELL_EFFECT)
760 const_iv (CONVERTER)
761 const_iv (BRACERS)
762 const_iv (POISONING)
763 const_iv (SAVEBED)
764 const_iv (POISONCLOUD)
765 const_iv (FIREHOLES)
766 const_iv (WAND)
767 const_iv (SCROLL)
768 const_iv (DIRECTOR)
769 const_iv (GIRDLE)
770 const_iv (FORCE)
771 const_iv (POTION_EFFECT)
772 const_iv (EVENT_CONNECTOR)
773 const_iv (CLOSE_CON)
774 const_iv (CONTAINER)
775 const_iv (ARMOUR_IMPROVER)
776 const_iv (WEAPON_IMPROVER)
777 const_iv (SKILLSCROLL)
778 const_iv (DEEP_SWAMP)
779 const_iv (IDENTIFY_ALTAR)
780 const_iv (MENU)
781 const_iv (RUNE)
782 const_iv (TRAP)
783 const_iv (POWER_CRYSTAL)
784 const_iv (CORPSE)
785 const_iv (DISEASE)
786 const_iv (SYMPTOM)
787 const_iv (BUILDER)
788 const_iv (MATERIAL)
789 const_iv (ITEM_TRANSFORMER)
790 const_iv (QUEST)
791
792 const_iv (ST_BD_BUILD)
793 const_iv (ST_BD_REMOVE)
794
795 const_iv (ST_MAT_FLOOR)
796 const_iv (ST_MAT_WALL)
797 const_iv (ST_MAT_ITEM)
798
799 const_iv (AT_PHYSICAL)
800 const_iv (AT_MAGIC)
801 const_iv (AT_FIRE)
802 const_iv (AT_ELECTRICITY)
803 const_iv (AT_COLD)
804 const_iv (AT_CONFUSION)
805 const_iv (AT_ACID)
806 const_iv (AT_DRAIN)
807 const_iv (AT_WEAPONMAGIC)
808 const_iv (AT_GHOSTHIT)
809 const_iv (AT_POISON)
810 const_iv (AT_SLOW)
811 const_iv (AT_PARALYZE)
812 const_iv (AT_TURN_UNDEAD)
813 const_iv (AT_FEAR)
814 const_iv (AT_CANCELLATION)
815 const_iv (AT_DEPLETE)
816 const_iv (AT_DEATH)
817 const_iv (AT_CHAOS)
818 const_iv (AT_COUNTERSPELL)
819 const_iv (AT_GODPOWER)
820 const_iv (AT_HOLYWORD)
821 const_iv (AT_BLIND)
822 const_iv (AT_INTERNAL)
823 const_iv (AT_LIFE_STEALING)
824 const_iv (AT_DISEASE)
825
826 const_iv (QUEST_IN_PROGRESS)
827 const_iv (QUEST_DONE_QUEST)
828 const_iv (QUEST_DONE_TASK)
829 const_iv (QUEST_START_QUEST)
830 const_iv (QUEST_END_QUEST)
831 const_iv (QUEST_START_TASK)
832 const_iv (QUEST_END_TASK)
833 const_iv (QUEST_OVERRIDE)
834 const_iv (QUEST_ON_ACTIVATE)
835
836 const_iv (WEAP_HIT)
837 const_iv (WEAP_SLASH)
838 const_iv (WEAP_PIERCE)
839 const_iv (WEAP_CLEAVE)
840 const_iv (WEAP_SLICE)
841 const_iv (WEAP_STAB)
842 const_iv (WEAP_WHIP)
843 const_iv (WEAP_CRUSH)
844 const_iv (WEAP_BLUD)
845
846 const_iv (FLAG_ALIVE)
847 const_iv (FLAG_WIZ)
848 const_iv (FLAG_REMOVED)
849 const_iv (FLAG_FREED)
850 const_iv (FLAG_WAS_WIZ)
851 const_iv (FLAG_APPLIED)
852 const_iv (FLAG_UNPAID)
853 const_iv (FLAG_USE_SHIELD)
854 const_iv (FLAG_NO_PICK)
855 const_iv (FLAG_ANIMATE)
856 const_iv (FLAG_MONSTER)
857 const_iv (FLAG_FRIENDLY)
858 const_iv (FLAG_GENERATOR)
859 const_iv (FLAG_IS_THROWN)
860 const_iv (FLAG_AUTO_APPLY)
861 const_iv (FLAG_TREASURE)
862 const_iv (FLAG_PLAYER_SOLD)
863 const_iv (FLAG_SEE_INVISIBLE)
864 const_iv (FLAG_CAN_ROLL)
865 const_iv (FLAG_OVERLAY_FLOOR)
866 const_iv (FLAG_IS_TURNABLE)
867 const_iv (FLAG_IS_USED_UP)
868 const_iv (FLAG_IDENTIFIED)
869 const_iv (FLAG_REFLECTING)
870 const_iv (FLAG_CHANGING)
871 const_iv (FLAG_SPLITTING)
872 const_iv (FLAG_HITBACK)
873 const_iv (FLAG_STARTEQUIP)
874 const_iv (FLAG_BLOCKSVIEW)
875 const_iv (FLAG_UNDEAD)
876 const_iv (FLAG_SCARED)
877 const_iv (FLAG_UNAGGRESSIVE)
878 const_iv (FLAG_REFL_MISSILE)
879 const_iv (FLAG_REFL_SPELL)
880 const_iv (FLAG_NO_MAGIC)
881 const_iv (FLAG_NO_FIX_PLAYER)
882 const_iv (FLAG_IS_LIGHTABLE)
883 const_iv (FLAG_TEAR_DOWN)
884 const_iv (FLAG_RUN_AWAY)
885 const_iv (FLAG_PICK_UP)
886 const_iv (FLAG_UNIQUE)
887 const_iv (FLAG_NO_DROP)
888 const_iv (FLAG_WIZCAST)
889 const_iv (FLAG_CAST_SPELL)
890 const_iv (FLAG_USE_SCROLL)
891 const_iv (FLAG_USE_RANGE)
892 const_iv (FLAG_USE_BOW)
893 const_iv (FLAG_USE_ARMOUR)
894 const_iv (FLAG_USE_WEAPON)
895 const_iv (FLAG_USE_RING)
896 const_iv (FLAG_READY_RANGE)
897 const_iv (FLAG_READY_BOW)
898 const_iv (FLAG_XRAYS)
899 const_iv (FLAG_NO_APPLY)
900 const_iv (FLAG_IS_FLOOR)
901 const_iv (FLAG_LIFESAVE)
902 const_iv (FLAG_NO_STRENGTH)
903 const_iv (FLAG_SLEEP)
904 const_iv (FLAG_STAND_STILL)
905 const_iv (FLAG_RANDOM_MOVE)
906 const_iv (FLAG_ONLY_ATTACK)
907 const_iv (FLAG_CONFUSED)
908 const_iv (FLAG_STEALTH)
909 const_iv (FLAG_WIZPASS)
910 const_iv (FLAG_IS_LINKED)
911 const_iv (FLAG_CURSED)
912 const_iv (FLAG_DAMNED)
913 const_iv (FLAG_SEE_ANYWHERE)
914 const_iv (FLAG_KNOWN_MAGICAL)
915 const_iv (FLAG_KNOWN_CURSED)
916 const_iv (FLAG_CAN_USE_SKILL)
917 const_iv (FLAG_BEEN_APPLIED)
918 const_iv (FLAG_READY_SCROLL)
919 const_iv (FLAG_USE_ROD)
920 const_iv (FLAG_USE_HORN)
921 const_iv (FLAG_MAKE_INVIS)
922 const_iv (FLAG_INV_LOCKED)
923 const_iv (FLAG_IS_WOODED)
924 const_iv (FLAG_IS_HILLY)
925 const_iv (FLAG_READY_SKILL)
926 const_iv (FLAG_READY_WEAPON)
927 const_iv (FLAG_NO_SKILL_IDENT)
928 const_iv (FLAG_BLIND)
929 const_iv (FLAG_SEE_IN_DARK)
930 const_iv (FLAG_IS_CAULDRON)
931 const_iv (FLAG_NO_STEAL)
932 const_iv (FLAG_ONE_HIT)
933 const_iv (FLAG_CLIENT_SENT)
934 const_iv (FLAG_BERSERK)
935 const_iv (FLAG_NEUTRAL)
936 const_iv (FLAG_NO_ATTACK)
937 const_iv (FLAG_NO_DAMAGE)
938 const_iv (FLAG_OBJ_ORIGINAL)
939 const_iv (FLAG_OBJ_SAVE_ON_OVL)
940 const_iv (FLAG_ACTIVATE_ON_PUSH)
941 const_iv (FLAG_ACTIVATE_ON_RELEASE)
942 const_iv (FLAG_IS_WATER)
943 const_iv (FLAG_CONTENT_ON_GEN)
944 const_iv (FLAG_IS_A_TEMPLATE)
945 const_iv (FLAG_IS_BUILDABLE)
946 const_iv (FLAG_AFK)
947
948 const_iv (NDI_BLACK)
949 const_iv (NDI_WHITE)
950 const_iv (NDI_NAVY)
951 const_iv (NDI_RED)
952 const_iv (NDI_ORANGE)
953 const_iv (NDI_BLUE)
954 const_iv (NDI_DK_ORANGE)
955 const_iv (NDI_GREEN)
956 const_iv (NDI_LT_GREEN)
957 const_iv (NDI_GREY)
958 const_iv (NDI_BROWN)
959 const_iv (NDI_GOLD)
960 const_iv (NDI_TAN)
961 const_iv (NDI_MAX_COLOR)
962 const_iv (NDI_COLOR_MASK)
963 const_iv (NDI_UNIQUE)
964 const_iv (NDI_ALL)
965
966 const_iv (F_APPLIED)
967 const_iv (F_LOCATION)
968 const_iv (F_UNPAID)
969 const_iv (F_MAGIC)
970 const_iv (F_CURSED)
971 const_iv (F_DAMNED)
972 const_iv (F_OPEN)
973 const_iv (F_NOPICK)
974 const_iv (F_LOCKED)
975
976 const_iv (P_BLOCKSVIEW)
977 const_iv (P_NO_MAGIC)
978 const_iv (P_IS_ALIVE)
979 const_iv (P_NO_CLERIC)
980 const_iv (P_NEED_UPDATE)
981 const_iv (P_NO_ERROR)
982 const_iv (P_OUT_OF_MAP)
983 const_iv (P_NEW_MAP)
984
985 const_iv (UP_OBJ_INSERT)
986 const_iv (UP_OBJ_REMOVE)
987 const_iv (UP_OBJ_CHANGE)
988 const_iv (UP_OBJ_FACE)
989
990 const_iv (INS_NO_MERGE)
991 const_iv (INS_ABOVE_FLOOR_ONLY)
992 const_iv (INS_NO_WALK_ON)
993 const_iv (INS_ON_TOP)
994 const_iv (INS_BELOW_ORIGINATOR)
995 const_iv (INS_MAP_LOAD)
996
997 const_iv (WILL_APPLY_HANDLE)
998 const_iv (WILL_APPLY_TREASURE)
999 const_iv (WILL_APPLY_EARTHWALL)
1000 const_iv (WILL_APPLY_DOOR)
1001 const_iv (WILL_APPLY_FOOD)
1002
1003 const_iv (SAVE_MODE)
1004 const_iv (SAVE_DIR_MODE)
1005
1006 const_iv (M_PAPER)
1007 const_iv (M_IRON)
1008 const_iv (M_GLASS)
1009 const_iv (M_LEATHER)
1010 const_iv (M_WOOD)
1011 const_iv (M_ORGANIC)
1012 const_iv (M_STONE)
1013 const_iv (M_CLOTH)
1014 const_iv (M_ADAMANT)
1015 const_iv (M_LIQUID)
1016 const_iv (M_SOFT_METAL)
1017 const_iv (M_BONE)
1018 const_iv (M_ICE)
1019 const_iv (M_SPECIAL)
1020
1021 const_iv (SK_EXP_ADD_SKILL)
1022 const_iv (SK_EXP_TOTAL)
1023 const_iv (SK_EXP_NONE)
1024 const_iv (SK_SUBTRACT_SKILL_EXP)
1025
1026 const_iv (SK_LOCKPICKING)
1027 const_iv (SK_HIDING)
1028 const_iv (SK_SMITHERY)
1029 const_iv (SK_BOWYER)
1030 const_iv (SK_JEWELER)
1031 const_iv (SK_ALCHEMY)
1032 const_iv (SK_STEALING)
1033 const_iv (SK_LITERACY)
1034 const_iv (SK_BARGAINING)
1035 const_iv (SK_JUMPING)
1036 const_iv (SK_DET_MAGIC)
1037 const_iv (SK_ORATORY)
1038 const_iv (SK_SINGING)
1039 const_iv (SK_DET_CURSE)
1040 const_iv (SK_FIND_TRAPS)
1041 const_iv (SK_MEDITATION)
1042 const_iv (SK_PUNCHING)
1043 const_iv (SK_FLAME_TOUCH)
1044 const_iv (SK_KARATE)
1045 const_iv (SK_CLIMBING)
1046 const_iv (SK_WOODSMAN)
1047 const_iv (SK_INSCRIPTION)
1048 const_iv (SK_ONE_HANDED_WEAPON)
1049 const_iv (SK_MISSILE_WEAPON)
1050 const_iv (SK_THROWING)
1051 const_iv (SK_USE_MAGIC_ITEM)
1052 const_iv (SK_DISARM_TRAPS)
1053 const_iv (SK_SET_TRAP)
1054 const_iv (SK_THAUMATURGY)
1055 const_iv (SK_PRAYING)
1056 const_iv (SK_CLAWING)
1057 const_iv (SK_LEVITATION)
1058 const_iv (SK_SUMMONING)
1059 const_iv (SK_PYROMANCY)
1060 const_iv (SK_EVOCATION)
1061 const_iv (SK_SORCERY)
1062 const_iv (SK_TWO_HANDED_WEAPON)
1063
1064 const_iv (SOUND_NEW_PLAYER)
1065 const_iv (SOUND_FIRE_ARROW)
1066 const_iv (SOUND_LEARN_SPELL)
1067 const_iv (SOUND_FUMBLE_SPELL)
1068 const_iv (SOUND_WAND_POOF)
1069 const_iv (SOUND_OPEN_DOOR)
1070 const_iv (SOUND_PUSH_PLAYER)
1071 const_iv (SOUND_PLAYER_HITS1)
1072 const_iv (SOUND_PLAYER_HITS2)
1073 const_iv (SOUND_PLAYER_HITS3)
1074 const_iv (SOUND_PLAYER_HITS4)
1075 const_iv (SOUND_PLAYER_IS_HIT1)
1076 const_iv (SOUND_PLAYER_IS_HIT2)
1077 const_iv (SOUND_PLAYER_IS_HIT3)
1078 const_iv (SOUND_PLAYER_KILLS)
1079 const_iv (SOUND_PET_IS_KILLED)
1080 const_iv (SOUND_PLAYER_DIES)
1081 const_iv (SOUND_OB_EVAPORATE)
1082 const_iv (SOUND_OB_EXPLODE)
1083 const_iv (SOUND_CLOCK)
1084 const_iv (SOUND_TURN_HANDLE)
1085 const_iv (SOUND_FALL_HOLE)
1086 const_iv (SOUND_DRINK_POISON)
1087 const_iv (SOUND_CAST_SPELL_0)
1088 };
1089
1090 for (civ = const_iv + sizeof (const_iv) / sizeof (const_iv [0]); civ-- > const_iv; )
1091 newCONSTSUB (stash, (char *)civ->name, newSViv (civ->iv));
1092
1093 static const struct {
1094 const char *name;
1095 IV iv;
1096 } *event, event_list[] = {
1097 # define const_event(name) { # name, (IV)EVENT_ ## name },
1098 const_event (NONE)
1099 const_event (APPLY)
1100 const_event (ATTACK)
1101 const_event (DEATH)
1102 const_event (DROP)
1103 const_event (PICKUP)
1104 const_event (SAY)
1105 const_event (STOP)
1106 const_event (TIME)
1107 const_event (THROW)
1108 const_event (TRIGGER)
1109 const_event (CLOSE)
1110 const_event (TIMER)
1111 const_event (MOVE)
1112
1113 const_event (BORN)
1114 const_event (CLOCK)
1115 const_event (CRASH)
1116 const_event (PLAYER_DEATH)
1117 const_event (PLAYER_LOAD)
1118 const_event (PLAYER_SAVE)
1119 const_event (GKILL)
1120 const_event (LOGIN)
1121 const_event (LOGOUT)
1122 const_event (MAPENTER)
1123 const_event (MAPLEAVE)
1124 const_event (MAPRESET)
1125 const_event (MAPLOAD)
1126 const_event (MAPOUT)
1127 const_event (MAPIN)
1128 const_event (MAPCLEAN)
1129 const_event (REMOVE)
1130 const_event (SHOUT)
1131 const_event (TELL)
1132 const_event (MUZZLE)
1133 const_event (KICK)
1134 //const_event (FREE_OB)
1135 };
1136
1137 AV *av = get_av ("cf::EVENT", 1);
1138
1139 for (event = event_list + sizeof (event_list) / sizeof (event_list [0]); event-- > event_list; )
1140 av_store (av, event->iv, newSVpv ((char *)event->name, 0));
1141
1142 static const struct {
1143 int dtype;
1144 const char *name;
1145 IV idx;
1146 } *cprop, prop_table[] = {
1147 # define prop(type, name) { type, # name, (IV) CFAPI_ ## name },
1148 prop (CFAPI_INT, MAP_PROP_FLAGS)
1149 prop (CFAPI_INT, MAP_PROP_DIFFICULTY)
1150 prop (CFAPI_STRING, MAP_PROP_PATH)
1151 prop (CFAPI_STRING, MAP_PROP_TMPNAME)
1152 prop (CFAPI_STRING, MAP_PROP_NAME)
1153 prop (CFAPI_INT, MAP_PROP_RESET_TIME)
1154 prop (CFAPI_INT, MAP_PROP_RESET_TIMEOUT)
1155 prop (CFAPI_INT, MAP_PROP_PLAYERS)
1156 prop (CFAPI_INT, MAP_PROP_DARKNESS)
1157 prop (CFAPI_INT, MAP_PROP_WIDTH)
1158 prop (CFAPI_INT, MAP_PROP_HEIGHT)
1159 prop (CFAPI_INT, MAP_PROP_ENTER_X)
1160 prop (CFAPI_INT, MAP_PROP_ENTER_Y)
1161 prop (CFAPI_INT, MAP_PROP_TEMPERATURE)
1162 prop (CFAPI_INT, MAP_PROP_PRESSURE)
1163 prop (CFAPI_INT, MAP_PROP_HUMIDITY)
1164 prop (CFAPI_INT, MAP_PROP_WINDSPEED)
1165 prop (CFAPI_INT, MAP_PROP_WINDDIR)
1166 prop (CFAPI_INT, MAP_PROP_SKY)
1167 prop (CFAPI_INT, MAP_PROP_WPARTX)
1168 prop (CFAPI_INT, MAP_PROP_WPARTY)
1169 prop (CFAPI_STRING, MAP_PROP_MESSAGE)
1170 prop (CFAPI_PMAP, MAP_PROP_NEXT)
1171 prop (CFAPI_PREGION, MAP_PROP_REGION)
1172 prop (CFAPI_POBJECT, OBJECT_PROP_OB_ABOVE)
1173 prop (CFAPI_POBJECT, OBJECT_PROP_OB_BELOW)
1174 prop (CFAPI_POBJECT, OBJECT_PROP_NEXT_ACTIVE_OB)
1175 prop (CFAPI_POBJECT, OBJECT_PROP_PREV_ACTIVE_OB)
1176 prop (CFAPI_POBJECT, OBJECT_PROP_INVENTORY)
1177 prop (CFAPI_POBJECT, OBJECT_PROP_ENVIRONMENT)
1178 prop (CFAPI_POBJECT, OBJECT_PROP_HEAD)
1179 prop (CFAPI_POBJECT, OBJECT_PROP_CONTAINER)
1180 prop (CFAPI_PMAP, OBJECT_PROP_MAP)
1181 prop (CFAPI_INT, OBJECT_PROP_COUNT)
1182 prop (CFAPI_INT, OBJECT_PROP_REFCOUNT)
1183 prop (CFAPI_STRING, OBJECT_PROP_NAME)
1184 prop (CFAPI_STRING, OBJECT_PROP_NAME_PLURAL)
1185 prop (CFAPI_STRING, OBJECT_PROP_TITLE)
1186 prop (CFAPI_STRING, OBJECT_PROP_RACE)
1187 prop (CFAPI_STRING, OBJECT_PROP_SLAYING)
1188 prop (CFAPI_STRING, OBJECT_PROP_SKILL)
1189 prop (CFAPI_STRING, OBJECT_PROP_MESSAGE)
1190 prop (CFAPI_STRING, OBJECT_PROP_LORE)
1191 prop (CFAPI_INT, OBJECT_PROP_X)
1192 prop (CFAPI_INT, OBJECT_PROP_Y)
1193 prop (CFAPI_DOUBLE, OBJECT_PROP_SPEED)
1194 prop (CFAPI_DOUBLE, OBJECT_PROP_SPEED_LEFT)
1195 prop (CFAPI_INT, OBJECT_PROP_NROF)
1196 prop (CFAPI_INT, OBJECT_PROP_DIRECTION)
1197 prop (CFAPI_INT, OBJECT_PROP_FACING)
1198 prop (CFAPI_INT, OBJECT_PROP_TYPE)
1199 prop (CFAPI_INT, OBJECT_PROP_SUBTYPE)
1200 prop (CFAPI_INT, OBJECT_PROP_CLIENT_TYPE)
1201 prop (CFAPI_INT, OBJECT_PROP_ATTACK_TYPE)
1202 prop (CFAPI_INT, OBJECT_PROP_PATH_ATTUNED)
1203 prop (CFAPI_INT, OBJECT_PROP_PATH_REPELLED)
1204 prop (CFAPI_INT, OBJECT_PROP_PATH_DENIED)
1205 prop (CFAPI_INT, OBJECT_PROP_MATERIAL)
1206 prop (CFAPI_STRING, OBJECT_PROP_MATERIAL_NAME)
1207 prop (CFAPI_INT, OBJECT_PROP_MAGIC)
1208 prop (CFAPI_INT, OBJECT_PROP_VALUE)
1209 prop (CFAPI_INT, OBJECT_PROP_LEVEL)
1210 prop (CFAPI_INT, OBJECT_PROP_LAST_HEAL)
1211 prop (CFAPI_INT, OBJECT_PROP_LAST_SP)
1212 prop (CFAPI_INT, OBJECT_PROP_LAST_GRACE)
1213 prop (CFAPI_INT, OBJECT_PROP_LAST_EAT)
1214 prop (CFAPI_INT, OBJECT_PROP_INVISIBLE_TIME)
1215 prop (CFAPI_INT, OBJECT_PROP_PICK_UP)
1216 prop (CFAPI_INT, OBJECT_PROP_ITEM_POWER)
1217 prop (CFAPI_INT, OBJECT_PROP_GEN_SP_ARMOUR)
1218 prop (CFAPI_INT, OBJECT_PROP_WEIGHT)
1219 prop (CFAPI_INT, OBJECT_PROP_WEIGHT_LIMIT)
1220 prop (CFAPI_INT, OBJECT_PROP_CARRYING)
1221 prop (CFAPI_INT, OBJECT_PROP_GLOW_RADIUS)
1222 prop (CFAPI_LONG, OBJECT_PROP_PERM_EXP)
1223 prop (CFAPI_POBJECT, OBJECT_PROP_CURRENT_WEAPON)
1224 prop (CFAPI_POBJECT, OBJECT_PROP_ENEMY)
1225 prop (CFAPI_POBJECT, OBJECT_PROP_ATTACKED_BY)
1226 prop (CFAPI_INT, OBJECT_PROP_RUN_AWAY)
1227 prop (CFAPI_POBJECT, OBJECT_PROP_CHOSEN_SKILL)
1228 prop (CFAPI_INT, OBJECT_PROP_HIDDEN)
1229 prop (CFAPI_INT, OBJECT_PROP_MOVE_STATUS)
1230 prop (CFAPI_INT, OBJECT_PROP_MOVE_TYPE)
1231 prop (CFAPI_POBJECT, OBJECT_PROP_SPELL_ITEM)
1232 prop (CFAPI_DOUBLE, OBJECT_PROP_EXP_MULTIPLIER)
1233 prop (CFAPI_PARCH, OBJECT_PROP_ARCHETYPE)
1234 prop (CFAPI_PARCH, OBJECT_PROP_OTHER_ARCH)
1235 prop (CFAPI_STRING, OBJECT_PROP_CUSTOM_NAME)
1236 prop (CFAPI_INT, OBJECT_PROP_ANIM_SPEED)
1237 prop (CFAPI_INT, OBJECT_PROP_FRIENDLY)
1238 prop (CFAPI_STRING, OBJECT_PROP_SHORT_NAME)
1239 prop (CFAPI_INT, OBJECT_PROP_MAGICAL)
1240 prop (CFAPI_INT, OBJECT_PROP_LUCK)
1241 prop (CFAPI_POBJECT, OBJECT_PROP_OWNER)
1242 prop (CFAPI_POBJECT, OBJECT_PROP_PRESENT)
1243 prop (CFAPI_INT, OBJECT_PROP_CHEATER)
1244 prop (CFAPI_INT, OBJECT_PROP_MERGEABLE)
1245 prop (CFAPI_INT, OBJECT_PROP_PICKABLE)
1246 prop (CFAPI_INT, OBJECT_PROP_STR)
1247 prop (CFAPI_INT, OBJECT_PROP_DEX)
1248 prop (CFAPI_INT, OBJECT_PROP_CON)
1249 prop (CFAPI_INT, OBJECT_PROP_WIS)
1250 prop (CFAPI_INT, OBJECT_PROP_INT)
1251 prop (CFAPI_INT, OBJECT_PROP_POW)
1252 prop (CFAPI_INT, OBJECT_PROP_CHA)
1253 prop (CFAPI_INT, OBJECT_PROP_WC)
1254 prop (CFAPI_INT, OBJECT_PROP_AC)
1255 prop (CFAPI_INT, OBJECT_PROP_HP)
1256 prop (CFAPI_INT, OBJECT_PROP_SP)
1257 prop (CFAPI_INT, OBJECT_PROP_GP)
1258 prop (CFAPI_INT, OBJECT_PROP_FP)
1259 prop (CFAPI_INT, OBJECT_PROP_MAXHP)
1260 prop (CFAPI_INT, OBJECT_PROP_MAXSP)
1261 prop (CFAPI_INT, OBJECT_PROP_MAXGP)
1262 prop (CFAPI_INT, OBJECT_PROP_DAM)
1263 prop (CFAPI_STRING, OBJECT_PROP_GOD)
1264 prop (CFAPI_STRING, OBJECT_PROP_ARCH_NAME)
1265 prop (CFAPI_INT, OBJECT_PROP_INVISIBLE)
1266 prop (CFAPI_INT, OBJECT_PROP_FACE)
1267 };
1268
1269 HV *prop_type = get_hv ("cf::PROP_TYPE", 1);
1270 HV *prop_idx = get_hv ("cf::PROP_IDX", 1);
1271
1272 for (cprop = prop_table + sizeof (prop_table) / sizeof (prop_table [0]); cprop-- > prop_table; )
1273 {
1274 hv_store (prop_type, cprop->name, strlen (cprop->name), newSViv (cprop->dtype), 0);
1275 hv_store (prop_idx, cprop->name, strlen (cprop->name), newSViv (cprop->idx ), 0);
1276 }
1277 }
1278
1279 void
1280 LOG (int level, char *msg)
1281 PROTOTYPE: $$
1282 C_ARGS: level, "%s", msg
1283
1284 char *
1285 cf_get_maps_directory (char *path)
1286 PROTOTYPE: $
1287 ALIAS: maps_directory = 0
1288
1289 char *
1290 mapdir ()
1291 PROTOTYPE:
1292 ALIAS:
1293 mapdir = 0
1294 uniquedir = 1
1295 tmpdir = 2
1296 confdir = 3
1297 localdir = 4
1298 playerdir = 5
1299 datadir = 6
1300 CODE:
1301 {
1302 int unused_type;
1303 RETVAL = (char *)systemDirectory (&unused_type, ix);
1304 }
1305 OUTPUT: RETVAL
1306
1307 int
1308 cf_find_animation (char *text)
1309 PROTOTYPE: $
1310
1311 MODULE = cf PACKAGE = cf::object PREFIX = cf_object_
1312
1313 SV *
1314 get_property (object *obj, int type, int idx)
1315 CODE:
1316 RETVAL = newSVcfapi (type, cf_object_get_property (obj, idx));
1317 OUTPUT: RETVAL
1318
1319 SV *
1320 set_property (object *obj, int type, int idx, SV *newval)
1321 CODE:
1322 switch (type)
1323 {
1324 case CFAPI_INT:
1325 cf_object_set_int_property (obj, idx, SvIV (newval));
1326 break;
1327 case CFAPI_LONG:
1328 cf_object_set_long_property (obj, idx, SvNV (newval));
1329 break;
1330 case CFAPI_DOUBLE:
1331 {
1332 int unused_type;
1333 object_set_property (&unused_type, obj, idx, (double)SvNV (newval));
1334 }
1335 break;
1336 case CFAPI_STRING:
1337 cf_object_set_string_property (obj, idx, SvOK (newval) ? SvPV_nolen (newval) : 0);
1338 break;
1339 case CFAPI_POBJECT:
1340 {
1341 int unused_type;
1342 object_set_property (&unused_type, obj, idx, (object *)SvPTR_ornull (newval, "cf::object"));
1343 }
1344 break;
1345 default:
1346 croak ("unhandled type '%d' in set_property '%d'", type, idx);
1347 }
1348
1349 # missing properties
1350
1351 void
1352 set_attacktype (object *obj, U32 attacktype)
1353 CODE:
1354 obj->attacktype = attacktype;
1355
1356 U32
1357 get_attacktype (object *obj)
1358 ALIAS:
1359 attacktype = 0
1360 CODE:
1361 RETVAL = obj->attacktype;
1362 OUTPUT: RETVAL
1363
1364 # missing in plug-in api, of course
1365 void
1366 set_food (object *obj, int food)
1367 CODE:
1368 obj->stats.food = food;
1369
1370 int
1371 get_food (object *obj)
1372 ALIAS:
1373 food = 0
1374 CODE:
1375 RETVAL = obj->stats.food;
1376 OUTPUT: RETVAL
1377
1378 void
1379 inv (object *obj)
1380 PROTOTYPE: $
1381 PPCODE:
1382 {
1383 object *o;
1384 for (o = obj->inv; o; o = o->below)
1385 XPUSHs (sv_2mortal (newSVcfapi (CFAPI_POBJECT, o)));
1386 }
1387
1388 int cf_object_get_resistance (object *op, int rtype)
1389 ALIAS: resistance = 0
1390
1391 int cf_object_get_flag (object *op, int flag)
1392 ALIAS: flag = 0
1393
1394 void cf_object_set_flag (object *op, int flag, int value)
1395
1396 void cf_object_move (object *op, int dir, object *originator = op)
1397
1398 void cf_object_apply (object *op, object *author, int flags = 0)
1399
1400 void cf_object_apply_below (object *op)
1401
1402 void cf_object_remove (object *op)
1403
1404 void cf_object_free (object *op)
1405
1406 object *cf_object_present_archname_inside (object *op, char *whatstr)
1407
1408 int cf_object_transfer (object *op, int x, int y, int r = 0, object_ornull *orig = 0)
1409
1410 int cf_object_change_map (object *op, int x, int y, mapstruct *map)
1411
1412 object *cf_object_clone (object *op, int clonetype = 0)
1413
1414 int cf_object_pay_item (object *op, object *buyer)
1415
1416 int cf_object_pay_amount (object *op, double amount)
1417
1418 int cf_object_cast_spell (object *caster, object *ctoo, int dir, object *spell_ob, char *stringarg = 0)
1419
1420 int cf_object_cast_ability (object *caster, object *ctoo, int dir, object *sp_, char *stringarg = 0)
1421
1422 void cf_object_learn_spell (object *op, object *sp)
1423
1424 void cf_object_forget_spell (object *op, object *sp)
1425
1426 object *cf_object_check_for_spell (object *op, char *spellname)
1427
1428 int cf_object_query_money (object *op)
1429 ALIAS: money = 0
1430
1431 int cf_object_query_cost (object *op, object *who, int flags)
1432 ALIAS: cost = 0
1433
1434 void cf_object_activate_rune (object *op , object *victim)
1435
1436 int cf_object_check_trigger (object *op, object *cause)
1437
1438 int cf_object_out_of_map (object *op, int x, int y)
1439
1440 void cf_object_drop (object *op, object *author)
1441
1442 void cf_object_take (object *op, object *author)
1443
1444 void cf_object_say (object *op, char *msg)
1445
1446 void cf_object_speak (object *op, char *msg)
1447
1448 object *cf_object_insert_object (object *op, object *container)
1449
1450 const char *cf_object_get_msg (object *ob)
1451 ALIAS: msg = 0
1452
1453 object *cf_object_insert_in_ob (object *ob, object *where)
1454
1455 int cf_object_teleport (object *op, mapstruct *map, int x, int y)
1456
1457 void cf_object_update (object *op, int flags)
1458
1459 void cf_object_pickup (object *op, object *what)
1460
1461 char *cf_object_get_key (object *op, char *keyname)
1462 ALIAS: key = 0
1463
1464 void cf_object_set_key (object *op, char *keyname, char *value)
1465
1466 object *cf_create_object_by_name (const char *name)
1467
1468 void change_exp (object *op, double exp, const char *skill_name = 0, int flag = 0)
1469
1470 void player_lvl_adj (object *who, object *skill = 0)
1471
1472
1473 MODULE = cf PACKAGE = cf::object PREFIX = cf_
1474
1475 void cf_fix_object (object *pl)
1476 ALIAS: fix = 0
1477
1478 object *cf_insert_ob_in_ob (object *ob, object *where)
1479
1480 # no clean way to get an object from an archetype - stupid idiotic
1481 # dumb kludgy misdesigned plug-in api slowly gets on my nerves.
1482
1483 object *new (const char *archetype = 0)
1484 PROTOTYPE: ;$
1485 CODE:
1486 RETVAL = archetype ? get_archetype (archetype) : cf_create_object ();
1487 OUTPUT:
1488 RETVAL
1489
1490 object *insert_ob_in_map_at (object *ob, mapstruct *where, object_ornull *orig, int flag, int x, int y)
1491 PROTOTYPE: $$$$$$
1492 CODE:
1493 {
1494 int unused_type;
1495 RETVAL = (object *)object_insert (&unused_type, ob, 0, where, orig, flag, x, y);
1496 }
1497
1498 const char *get_ob_key_value (object *op, const char *key)
1499
1500 bool set_ob_key_value (object *op, const char *key, const char *value = 0, int add_key = 1)
1501
1502 object *get_nearest_player (object *ob)
1503 ALIAS: nearest_player = 0
1504 PREINIT:
1505 extern object *get_nearest_player (object *);
1506
1507 void rangevector (object *ob, object *other, int flags = 0)
1508 PROTOTYPE: $$;$
1509 PPCODE:
1510 {
1511 rv_vector rv;
1512 get_rangevector (ob, other, &rv, flags);
1513 EXTEND (SP, 5);
1514 PUSHs (newSVuv (rv.distance));
1515 PUSHs (newSViv (rv.distance_x));
1516 PUSHs (newSViv (rv.distance_y));
1517 PUSHs (newSViv (rv.direction));
1518 PUSHs (newSVcfapi (CFAPI_POBJECT, rv.part));
1519 }
1520
1521 bool on_same_map_as (object *ob, object *other)
1522 CODE:
1523 RETVAL = on_same_map (ob, other);
1524 OUTPUT: RETVAL
1525
1526 char *
1527 base_name (object *ob, int plural)
1528 CODE:
1529 RETVAL = cf_query_base_name (ob, plural);
1530 OUTPUT: RETVAL
1531
1532 living *
1533 stats (object *ob)
1534 CODE:
1535 RETVAL = &ob->stats;
1536 OUTPUT: RETVAL
1537
1538
1539 MODULE = cf PACKAGE = cf::object::player PREFIX = cf_player_
1540
1541 player *player (object *op)
1542 CODE:
1543 RETVAL = cf_player_find (cf_query_name (op));
1544 OUTPUT: RETVAL
1545
1546 void cf_player_message (object *obj, char *txt, int flags = NDI_ORANGE | NDI_UNIQUE)
1547
1548 object *cf_player_send_inventory (object *op)
1549
1550 player *contr (object *op)
1551 CODE:
1552 RETVAL = op->contr;
1553 OUTPUT: RETVAL
1554
1555 char *cf_player_get_ip (object *op)
1556 ALIAS: ip = 0
1557
1558 object *cf_player_get_marked_item (object *op)
1559 ALIAS: marked_item = 0
1560
1561 void cf_player_set_marked_item (object *op, object *ob)
1562
1563 partylist *cf_player_get_party (object *op)
1564 ALIAS: party = 0
1565
1566 void cf_player_set_party (object *op, partylist *party)
1567
1568 void change_skill (object *op, double exp, char *skill_name = 0, int flag = 0)
1569
1570 MODULE = cf PACKAGE = cf::object::map PREFIX = cf_
1571
1572 MODULE = cf PACKAGE = cf::player PREFIX = cf_player_
1573
1574 player *cf_player_find (char *name)
1575 PROTOTYPE: $
1576
1577 void cf_player_move (player *pl, int dir)
1578
1579 void MapNewmapCmd (player *pl)
1580
1581 void play_sound_player_only (player *pl, int soundnum, int x = 0, int y = 0);
1582
1583 # nonstandard
1584 object *ob (player *pl)
1585 CODE:
1586 RETVAL = pl->ob;
1587 OUTPUT: RETVAL
1588
1589 player *first ()
1590 CODE:
1591 RETVAL = first_player;
1592 OUTPUT: RETVAL
1593
1594 player *next (player *pl)
1595 CODE:
1596 RETVAL = pl->next;
1597 OUTPUT: RETVAL
1598
1599 void get_savebed (player *pl)
1600 ALIAS:
1601 savebed = 0
1602 PPCODE:
1603 EXTEND (SP, 3);
1604 PUSHs (sv_2mortal (newSVpv (pl->savebed_map, 0)));
1605 PUSHs (sv_2mortal (newSViv (pl->bed_x)));
1606 PUSHs (sv_2mortal (newSViv (pl->bed_y)));
1607
1608 void set_savebed (player *pl, char *map_path, int x, int y)
1609 CODE:
1610 strcpy (pl->savebed_map, map_path);
1611 pl->bed_x = x;
1612 pl->bed_y = y;
1613
1614 void
1615 list ()
1616 PPCODE:
1617 {
1618 player *pl;
1619 for (pl = first_player; pl; pl = pl->next)
1620 XPUSHs (newSVcfapi (CFAPI_PPLAYER, pl));
1621 }
1622
1623 living *
1624 orig_stats (player *pl)
1625 CODE:
1626 RETVAL = &pl->orig_stats;
1627 OUTPUT: RETVAL
1628
1629 living *
1630 last_stats (player *pl)
1631 CODE:
1632 RETVAL = &pl->last_stats;
1633 OUTPUT: RETVAL
1634
1635
1636 MODULE = cf PACKAGE = cf::map PREFIX = cf_map_
1637
1638 SV *
1639 get_property (mapstruct *obj, int type, int idx)
1640 CODE:
1641 RETVAL = newSVcfapi (type, cf_map_get_property (obj, idx));
1642 OUTPUT: RETVAL
1643
1644 SV *
1645 set_property (mapstruct *obj, int type, int idx, SV *newval)
1646 CODE:
1647 switch (type)
1648 {
1649 case CFAPI_INT:
1650 cf_map_set_int_property (obj, idx, SvIV (newval));
1651 break;
1652 default:
1653 croak ("unhandled type '%d' in set_property '%d'", type, idx);
1654 }
1655
1656 mapstruct *new (int width, int height)
1657 PROTOTYPE:
1658 CODE:
1659 {
1660 int unused_type;
1661 RETVAL = map_get_map (&unused_type, 0, width, height);
1662 }
1663 OUTPUT:
1664 RETVAL
1665
1666 void delete_map (mapstruct *map)
1667
1668 void clean_tmp_map (mapstruct *map)
1669
1670 void play_sound_map (mapstruct *map, int x, int y, int sound_num)
1671
1672 mapstruct *cf_map_get_map (char *name)
1673 PROTOTYPE: $
1674 ALIAS: map = 0
1675
1676 mapstruct *cf_map_get_first ()
1677 PROTOTYPE:
1678 ALIAS: first = 0
1679
1680 # whoever "designed" the plug-in api should have wasted
1681 # his/her time with staying away form the project - would have
1682 # saved others a lot of time, without doubt.
1683 void set_path (mapstruct *where, char *path)
1684 CODE:
1685 strcpy (where->path, path);
1686
1687 bool unique (mapstruct *map)
1688 CODE:
1689 RETVAL = map->unique;
1690 OUTPUT:
1691 RETVAL
1692
1693 void set_unique (mapstruct *map, bool unique)
1694 CODE:
1695 map->unique = unique;
1696
1697 object *cf_map_insert_object_there (mapstruct *where, object *op, object *originator, int flags)
1698
1699 object *cf_map_insert_object (mapstruct *where, object* op, int x, int y)
1700
1701 object* cf_map_present_arch_by_name (mapstruct *map, const char* str, int nx, int ny)
1702 C_ARGS: str, map, nx, ny
1703
1704 #int cf_map_get_flags (mapstruct* map, mapstruct** nmap, I16 x, I16 y, I16 *nx, I16 *ny)
1705
1706 void
1707 at (mapstruct *obj, unsigned int x, unsigned int y)
1708 PROTOTYPE: $$$
1709 INIT:
1710 if (x >= MAP_WIDTH (obj) || y >= MAP_HEIGHT (obj)) XSRETURN_EMPTY;
1711 PPCODE:
1712 {
1713 object *o;
1714
1715 for (o = GET_MAP_OB (obj, x, y); o; o = o->above)
1716 XPUSHs (sv_2mortal (newSVcfapi (CFAPI_POBJECT, o)));
1717 }
1718
1719 SV *
1720 bot_at (mapstruct *obj, unsigned int x, unsigned int y)
1721 PROTOTYPE: $$$
1722 ALIAS:
1723 top_at = 1
1724 flags_at = 2
1725 light_at = 3
1726 move_block_at = 4
1727 move_slow_at = 5
1728 move_on_at = 6
1729 move_off_at = 7
1730 INIT:
1731 if (x >= MAP_WIDTH (obj) || y >= MAP_HEIGHT (obj)) XSRETURN_UNDEF;
1732 CODE:
1733 switch (ix)
1734 {
1735 case 0: RETVAL = newSVcfapi (CFAPI_POBJECT, GET_MAP_OB (obj, x, y)); break;
1736 case 1: RETVAL = newSVcfapi (CFAPI_POBJECT, GET_MAP_TOP (obj, x, y)); break;
1737 case 2: RETVAL = newSVuv ( GET_MAP_FLAGS (obj, x, y)); break;
1738 case 3: RETVAL = newSViv ( GET_MAP_LIGHT (obj, x, y)); break;
1739 case 4: RETVAL = newSVuv ( GET_MAP_MOVE_BLOCK (obj, x, y)); break;
1740 case 5: RETVAL = newSVuv ( GET_MAP_MOVE_SLOW (obj, x, y)); break;
1741 case 6: RETVAL = newSVuv ( GET_MAP_MOVE_ON (obj, x, y)); break;
1742 case 7: RETVAL = newSVuv ( GET_MAP_MOVE_OFF (obj, x, y)); break;
1743 }
1744 OUTPUT:
1745 RETVAL
1746
1747 # "serialise" map perl data into a ref
1748 void
1749 _get_obs (mapstruct *map)
1750 PPCODE:
1751 {
1752 object *o;
1753 int x, y;
1754 AV *obs = newAV ();
1755 int nonnull = 0;
1756
1757 for (y = 0; y < MAP_HEIGHT (map); y++)
1758 for (x = 0; x < MAP_WIDTH (map); x++)
1759 {
1760 AV *av = newAV ();
1761
1762 for (o = GET_MAP_OB (map, x, y); o; o = o->above)
1763 {
1764 SV *sv = SVptr_cache_get (o);
1765
1766 if (sv && HvFILL (SvRV (sv)))
1767 {
1768 nonnull = 1;
1769 sv = newSVsv (sv);
1770 }
1771 else
1772 sv = &PL_sv_undef;
1773
1774 av_push (av, sv);
1775 }
1776
1777 av_store (obs, x + y * MAP_HEIGHT (map), newRV_noinc ((SV *)av));
1778 }
1779
1780 if (nonnull)
1781 XPUSHs (sv_2mortal (newRV_noinc ((SV *)obs)));
1782 else
1783 SvREFCNT_dec (obs);
1784 }
1785
1786 # "deserialise" perl map data into the map
1787 void
1788 _set_obs (mapstruct *map, SV *sv)
1789 CODE:
1790 {
1791 object *o;
1792 AV *av;
1793 int x, y;
1794 AV *obs = (AV *)SvRV (sv);
1795
1796 for (y = 0; y < MAP_HEIGHT (map); y++)
1797 for (x = 0; x < MAP_WIDTH (map); x++)
1798 {
1799 sv = *av_fetch (obs, x + y * MAP_HEIGHT (map), 1);
1800
1801 if (!SvROK (sv))
1802 continue;
1803
1804 av = (AV *)SvRV (sv);
1805
1806 for (o = GET_MAP_OB (map, x, y); o; o = o->above)
1807 {
1808 sv = av_shift (av);
1809
1810 if (SvROK (sv))
1811 {
1812 sv_magic ((SV *)SvRV (sv), 0, PERL_MAGIC_ext, (char *)o, 0);
1813 SVptr_cache_set (o, sv);
1814 }
1815 }
1816 }
1817 }
1818
1819
1820 MODULE = cf PACKAGE = cf::arch PREFIX = cf_archetype_
1821
1822 archetype *cf_archetype_get_first()
1823 PROTOTYPE:
1824 ALIAS: first = 0
1825
1826 archetype *cf_archetype_get_next (archetype *arch)
1827 ALIAS: next = 0
1828
1829 archetype *cf_archetype_get_head (archetype *arch)
1830 ALIAS: head = 0
1831
1832 archetype *cf_archetype_get_more (archetype *arch)
1833 ALIAS: more = 0
1834
1835 const char *cf_archetype_get_name (archetype *arch)
1836 ALIAS: name = 0
1837
1838 MODULE = cf PACKAGE = cf::party PREFIX = cf_party_
1839
1840 partylist *cf_party_get_first ()
1841 PROTOTYPE:
1842 ALIAS: first = 0
1843
1844 partylist *cf_party_get_next (partylist *party)
1845 ALIAS: next = 0
1846
1847 const char *cf_party_get_name (partylist *party)
1848
1849 const char *cf_party_get_password (partylist *party)
1850 ALIAS: password = 0
1851
1852 player *cf_party_get_first_player (partylist *party)
1853 ALIAS: first_player = 0
1854
1855 player *cf_party_get_next_player (partylist *party, player *op)
1856 ALIAS: next_player = 0
1857
1858
1859 MODULE = cf PACKAGE = cf::region PREFIX = cf_region_
1860
1861 region *cf_region_get_first ()
1862 PROTOTYPE:
1863 ALIAS: first = 0
1864
1865 const char *cf_region_get_name (region *reg)
1866 ALIAS: name = 0
1867
1868 region *cf_region_get_next (region *reg)
1869 ALIAS: next = 0
1870
1871 region *cf_region_get_parent (region *reg)
1872 ALIAS: parent = 0
1873
1874 const char *cf_region_get_longname (region *reg)
1875 ALIAS: longname = 0
1876
1877 const char *cf_region_get_message (region *reg)
1878 ALIAS: message = 0
1879
1880
1881 MODULE = cf PACKAGE = cf::living PREFIX = cf_living_
1882
1883 double
1884 exp (living *liv, double new_val = 0.)
1885 PROTOTYPE: $;$
1886 ALIAS:
1887 Str = 1
1888 Dex = 2
1889 Con = 3
1890 Wis = 4
1891 Cha = 5
1892 Int = 6
1893 Pow = 7
1894 wc = 8
1895 ac = 9
1896 hp = 10
1897 maxhp = 11
1898 sp = 12
1899 maxsp = 13
1900 grace = 14
1901 maxgrace = 15
1902 food = 16
1903 dam = 17
1904 luck = 18
1905 CODE:
1906 # define LIVING_ACC(acc,idx) case idx: RETVAL = liv->acc; if (items > 1) liv->acc = new_val; break
1907 switch (ix)
1908 {
1909 LIVING_ACC (exp , 0);
1910 LIVING_ACC (Str , 1);
1911 LIVING_ACC (Dex , 2);
1912 LIVING_ACC (Con , 3);
1913 LIVING_ACC (Wis , 4);
1914 LIVING_ACC (Cha , 5);
1915 LIVING_ACC (Int , 6);
1916 LIVING_ACC (Pow , 7);
1917 LIVING_ACC (wc , 8);
1918 LIVING_ACC (ac , 9);
1919 LIVING_ACC (hp , 10);
1920 LIVING_ACC (maxhp , 11);
1921 LIVING_ACC (sp , 12);
1922 LIVING_ACC (maxsp , 13);
1923 LIVING_ACC (grace , 14);
1924 LIVING_ACC (maxgrace, 15);
1925 LIVING_ACC (food , 16);
1926 LIVING_ACC (dam , 17);
1927 LIVING_ACC (luck , 18);
1928 }
1929 # undef LIVING_ACC
1930 OUTPUT:
1931 RETVAL
1932