| 1 | // |
1 | // |
| 2 | // cfperl.h perl interface |
2 | // cfperl.h perl interface |
| 3 | // |
3 | // |
|
|
4 | #ifndef CFPERL_H__ |
|
|
5 | #define CFPERL_H__ |
| 4 | |
6 | |
|
|
7 | struct pl; |
|
|
8 | struct object; |
|
|
9 | struct mapstruct; |
|
|
10 | |
|
|
11 | void cfperl_init (); |
| 5 | void cfperl_main (); |
12 | void cfperl_main (); |
|
|
13 | |
|
|
14 | // could have used templates, but a more traditional C api |
|
|
15 | // uses more explicit typing which is ok for this purpose. |
|
|
16 | enum data_type |
|
|
17 | { |
|
|
18 | DT_END, // no further arguments |
|
|
19 | DT_INT, |
|
|
20 | DT_INT64, |
|
|
21 | DT_DOUBLE, |
|
|
22 | DT_STRING, // 0-terminated string |
|
|
23 | DT_DATA, // string + length |
|
|
24 | DT_OBJECT, |
|
|
25 | DT_MAP, |
|
|
26 | DT_PLAYER, |
|
|
27 | DT_ARCH, |
|
|
28 | DT_PARTY, |
|
|
29 | DT_REGION, |
|
|
30 | DT_AV, // av that needs to be flattened out |
|
|
31 | |
|
|
32 | NUM_DATA_TYPES |
|
|
33 | }; |
|
|
34 | |
|
|
35 | enum event_klass |
|
|
36 | { |
|
|
37 | KLASS_GLOBAL, |
|
|
38 | KLASS_PLAYER, |
|
|
39 | KLASS_OBJECT, |
|
|
40 | KLASS_MAP, |
|
|
41 | }; |
|
|
42 | |
|
|
43 | enum event_type |
|
|
44 | { |
|
|
45 | # define def(klass,name) EVENT_ ## klass ## _ ## name, |
|
|
46 | # include "eventinc.h" |
|
|
47 | # undef def |
|
|
48 | NUM_EVENT_TYPES |
|
|
49 | }; |
|
|
50 | |
|
|
51 | #define ARG_INT(v) DT_INT , static_cast<int> (v) |
|
|
52 | #define ARG_INT64(v) DT_INT64 , static_cast<sint64> (v) |
|
|
53 | #define ARG_DOUBLE(v) DT_DOUBLE, static_cast<double> (v) |
|
|
54 | #define ARG_STRING(v) DT_STRING, static_cast<const char *> (v) |
|
|
55 | #define ARG_DATA(s,l) DT_DATA , static_cast<const void *> (s), (l) |
|
|
56 | #define ARG_OBJECT(o) DT_OBJECT, (void *)static_cast<struct object *> (o) |
|
|
57 | #define ARG_MAP(o) DT_MAP , (void *)static_cast<struct mapstruct *> (o) |
|
|
58 | #define ARG_PLAYER(o) DT_PLAYER, (void *)static_cast<struct pl *> (o) |
|
|
59 | #define ARG_ARCH(o) DT_ARCH , (void *)static_cast<struct archetype *> (o) |
|
|
60 | #define ARG_PARTY(o) DT_PARTY , (void *)static_cast<struct party *> (o) |
|
|
61 | #define ARG_REGION(o) DT_REGION, (void *)static_cast<struct region *> (o) |
|
|
62 | |
|
|
63 | // the ", ## __VA_ARGS" is, unfortunately, a gnu-cpp extension |
|
|
64 | |
|
|
65 | // all these return true when the normal event processing should be skipped (if any) |
|
|
66 | #define INVOKE(klass, event, ...) cfperl_invoke (EVENT_ ## klass ## _ ## event, ## __VA_ARGS__, DT_END) |
|
|
67 | |
|
|
68 | #define INVOKE_GLOBAL(event, ...) INVOKE (GLOBAL, event, ## __VA_ARGS__) |
|
|
69 | #define INVOKE_OBJECT(event, op, ...) INVOKE (OBJECT, event, ARG_OBJECT (op), ## __VA_ARGS__) |
|
|
70 | #define INVOKE_PLAYER(event, pl, ...) INVOKE (PLAYER, event, ARG_PLAYER (pl), ## __VA_ARGS__) |
|
|
71 | #define INVOKE_MAP(event, map, ...) INVOKE (MAP , event, ARG_MAP (map) , ## __VA_ARGS__) |
|
|
72 | |
|
|
73 | //TODO should index into @result |
|
|
74 | #define RESULT(idx,type) cfperl_result_ ## type (idx) |
|
|
75 | #define RESULT_INT(idx) RESULT(idx, INT) |
|
|
76 | |
|
|
77 | bool cfperl_invoke (event_type event, ...); |
|
|
78 | int cfperl_result_INT (int idx); |
|
|
79 | |
|
|
80 | struct extendable_base |
|
|
81 | { |
|
|
82 | void *self, *cb; // CF+ perl self and callback |
|
|
83 | const char *attach; // generic extension attachment information |
|
|
84 | |
|
|
85 | void clear (); // called when free'ing objects |
|
|
86 | void optimise (); // possibly save some memory by destroying unneeded data |
|
|
87 | |
|
|
88 | void extendable_init () |
|
|
89 | { |
|
|
90 | self = cb = 0; |
|
|
91 | attach = 0; |
|
|
92 | } |
|
|
93 | }; |
|
|
94 | |
|
|
95 | // objects extendable from perl (or any other extension) should include or |
|
|
96 | // derive using the curiously recurring template pattern, to avoid |
|
|
97 | // virtual method calls etc. |
|
|
98 | template<class subclass> |
|
|
99 | struct extendable : extendable_base |
|
|
100 | { |
|
|
101 | static data_type get_dt () |
|
|
102 | { |
|
|
103 | subclass::get_dt (); |
|
|
104 | } |
|
|
105 | }; |
|
|
106 | |
|
|
107 | struct object_freezer |
|
|
108 | { |
|
|
109 | const char *filename; |
|
|
110 | void *av; |
|
|
111 | int idx; |
|
|
112 | |
|
|
113 | object_freezer (const char *filename); |
|
|
114 | ~object_freezer (); |
|
|
115 | |
|
|
116 | void put (extendable_base *ext); |
|
|
117 | |
|
|
118 | template<class subclass> |
|
|
119 | void put (extendable<subclass> *obj) |
|
|
120 | { |
|
|
121 | put ((extendable_base *)obj); |
|
|
122 | } |
|
|
123 | |
|
|
124 | void finish (); |
|
|
125 | }; |
|
|
126 | |
|
|
127 | struct object_thawer |
|
|
128 | { |
|
|
129 | void *av; |
|
|
130 | int idx; |
|
|
131 | |
|
|
132 | object_thawer (const char *filename = 0); |
|
|
133 | ~object_thawer (); |
|
|
134 | |
|
|
135 | void get (data_type type, void *obj, extendable_base *ext); |
|
|
136 | |
|
|
137 | template<class subclass> |
|
|
138 | void get (extendable<subclass> *obj) |
|
|
139 | { |
|
|
140 | if (av) |
|
|
141 | get (subclass::get_dt (), (subclass *)obj, obj); |
|
|
142 | } |
|
|
143 | |
|
|
144 | void finish (); |
|
|
145 | }; |
|
|
146 | |
|
|
147 | #endif |
|
|
148 | |
