ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/include/object.h
Revision: 1.186
Committed: Mon Oct 6 18:26:35 2008 UTC (15 years, 7 months ago) by elmex
Content type: text/plain
Branch: MAIN
Changes since 1.185: +5 -0 lines
Log Message:
refactored drop code a bit, and hopefully fixed some bugs with it.

File Contents

# User Rev Content
1 root 1.92 /*
2 root 1.153 * This file is part of Deliantra, the Roguelike Realtime MMORPG.
3 root 1.128 *
4 root 1.164 * Copyright (©) 2005,2006,2007,2008 Marc Alexander Lehmann / Robin Redeker / the Deliantra team
5 root 1.128 * Copyright (©) 2001,2007 Mark Wedel & Crossfire Development Team
6     * Copyright (©) 1992,2007 Frank Tore Johansen
7     *
8 root 1.153 * Deliantra is free software: you can redistribute it and/or modify
9 root 1.135 * it under the terms of the GNU General Public License as published by
10     * the Free Software Foundation, either version 3 of the License, or
11     * (at your option) any later version.
12 root 1.128 *
13 root 1.135 * This program is distributed in the hope that it will be useful,
14     * but WITHOUT ANY WARRANTY; without even the implied warranty of
15     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16     * GNU General Public License for more details.
17 root 1.128 *
18 root 1.135 * You should have received a copy of the GNU General Public License
19     * along with this program. If not, see <http://www.gnu.org/licenses/>.
20 root 1.128 *
21 root 1.153 * The authors can be reached via e-mail to <support@deliantra.net>
22 root 1.86 */
23 root 1.1
24     #ifndef OBJECT_H
25     #define OBJECT_H
26    
27 root 1.56 #include <bitset>
28    
29 root 1.6 #include "cfperl.h"
30 root 1.7 #include "shstr.h"
31 root 1.6
32 root 1.81 typedef int tag_t;
33 root 1.109
34 root 1.118 enum {
35 root 1.122 body_skill,
36     body_combat,
37 root 1.118 body_range,
38     body_shield,
39     body_arm,
40     body_torso,
41     body_head,
42     body_neck,
43     body_finger,
44     body_shoulder,
45     body_foot,
46     body_hand,
47     body_wrist,
48     body_waist,
49     NUM_BODY_LOCATIONS
50     };
51 root 1.1
52 root 1.121 enum slottype_t
53     {
54     slot_none,
55     slot_combat,
56     slot_ranged,
57     };
58    
59 root 1.1 /* See common/item.c */
60    
61 root 1.20 typedef struct Body_Locations
62     {
63 root 1.127 keyword save_name; /* Name used to load/save it to disk */
64 root 1.20 const char *use_name; /* Name used when describing an item we can use */
65     const char *nonuse_name; /* Name to describe objects we can't use */
66 root 1.1 } Body_Locations;
67    
68     extern Body_Locations body_locations[NUM_BODY_LOCATIONS];
69    
70 root 1.154 #define NUM_COINS 4 /* number of coin types */
71     extern const char *const coins[NUM_COINS + 1];
72    
73 root 1.1 /*
74     * Each object (this also means archetypes!) could have a few of these
75     * "dangling" from it; this could also end up containing 'parse errors'.
76     *
77     * key and value are shared-strings.
78     *
79 root 1.172 * Please use kv_get/kv_set/kv_del from object rather than
80 root 1.1 * accessing the list directly.
81     * Exception is if you want to walk this list for some reason.
82     */
83 root 1.172 struct key_value : slice_allocated
84 root 1.20 {
85     key_value *next;
86     shstr key, value;
87 root 1.15 };
88 root 1.1
89 root 1.34 struct UUID
90     {
91     uint64 seq;
92 root 1.53
93 root 1.155 static UUID cur; // last uuid generated
94     static void init ();
95     static UUID gen ();
96    
97 root 1.53 UUID () { }
98     UUID (uint64 seq) : seq(seq) { }
99     operator uint64() { return seq; }
100     void operator =(uint64 seq) { this->seq = seq; }
101 root 1.156
102     typedef char BUF [32];
103    
104     bool parse (const char *s)
105     {
106 root 1.157 return sscanf (s, "<1.%" SCNx64 ">", &seq) == 1;
107 root 1.156 }
108    
109     const char *c_str (char *buf, int len) const
110     {
111     snprintf (buf, len, "<1.%" PRIx64 ">", seq);
112    
113     return buf;
114     }
115    
116     const char *c_str () const
117     {
118     static BUF buf;
119    
120     return c_str (buf, sizeof (buf));
121     }
122 root 1.34 };
123    
124 root 1.1 /* Definition for WILL_APPLY values. Replaces having harcoded values
125     * sprinkled in the code. Note that some of these also replace fields
126     * that were in the can_apply area. What is the point of having both
127     * can_apply and will_apply?
128     */
129 root 1.27 #define WILL_APPLY_HANDLE 0x01
130     #define WILL_APPLY_TREASURE 0x02
131     #define WILL_APPLY_EARTHWALL 0x04
132     #define WILL_APPLY_DOOR 0x08
133 root 1.14 #define WILL_APPLY_FOOD 0x10
134 root 1.1
135 root 1.116 struct body_slot
136     {
137 root 1.117 signed char info:4; /* body info as loaded from the file */
138     signed char used:4; /* Calculated value based on items equipped */
139 root 1.116 };
140    
141 root 1.68 INTERFACE_CLASS (object)
142 root 1.65 // these are being copied
143 root 1.68 struct object_copy : attachable
144 root 1.18 {
145 root 1.65 typedef bitset<NUM_FLAGS> flags_t;
146 root 1.1
147 root 1.68 sint16 ACC (RW, x), ACC (RW, y); /* Position in the map for this object */
148 root 1.117
149     uint8 ACC (RW, type); /* PLAYER, BULLET, etc. See define.h */
150     uint8 ACC (RW, subtype); /* subtype of object */
151 root 1.68 sint8 ACC (RW, direction); /* Means the object is moving that way. */
152     sint8 ACC (RW, facing); /* Object is oriented/facing that way. */
153 root 1.117
154 root 1.20 shstr ACC (RW, name); /* The name of the object, obviously... */
155     shstr ACC (RW, name_pl); /* The plural name of the object */
156 root 1.46 shstr ACC (RW, title); /* Of foo, etc */
157 root 1.20 shstr ACC (RW, race); /* human, goblin, dragon, etc */
158     shstr ACC (RW, slaying); /* Which race to do double damage to */
159 root 1.68 /* If this is an exit, this is the filename */
160 root 1.149 shstr ACC (RW, tag); // a tag used to tracking this object
161 root 1.46 shstr ACC (RW, skill); /* Name of the skill this object uses/grants */
162 root 1.20 shstr ACC (RW, msg); /* If this is a book/sign/magic mouth/etc */
163     shstr ACC (RW, lore); /* Obscure information about this object, */
164 root 1.68 /* To get put into books and the like. */
165 root 1.20 shstr ACC (RW, materialname); /* specific material name */
166     shstr ACC (RW, custom_name); /* Custom name assigned by player */
167 root 1.96 // materialtype_t *ACC (RW, material); /* What material this object consists of */
168 root 1.41 object_ptr ACC (RW, owner); /* Pointer to the object which controls this one */
169     object_ptr ACC (RW, enemy); /* Monster/player to follow even if not closest */
170     object_ptr ACC (RW, attacked_by); /* This object start to attack us! only player & monster */
171     object_ptr ACC (RW, chosen_skill); /* the skill chosen to use */
172     object_ptr ACC (RW, spellitem); /* Spell ability monster is choosing to use */
173     object_ptr ACC (RW, spell); /* Spell that was being cast */
174     object_ptr ACC (RW, current_weapon); /* Pointer to the weapon currently used */
175 root 1.62 arch_ptr ACC (RW, arch); /* Pointer to archetype */
176     arch_ptr ACC (RW, other_arch);/* Pointer used for various things - mostly used for what */
177 elmex 1.63
178 root 1.46 float ACC (RW, speed); /* The overall speed of this object */
179 root 1.20 float ACC (RW, speed_left); /* How much speed is left to spend this round */
180 root 1.180 sint32 ACC (RW, nrof); /* How many of the objects */
181 root 1.18
182 root 1.171 /* This next big block is basically used for monsters and equipment */
183 root 1.20 uint16 ACC (RW, client_type); /* Public type information. see doc/Developers/objects */
184 root 1.117
185 root 1.67 sint16 ACC (RW, resist[NROFATTACKS]); /* Resistance adjustments for attacks */
186 root 1.20 uint32 ACC (RW, attacktype); /* Bitmask of attacks this object does */
187 root 1.46 uint32 ACC (RW, path_attuned);/* Paths the object is attuned to */
188 root 1.20 uint32 ACC (RW, path_repelled); /* Paths the object is repelled from */
189     uint32 ACC (RW, path_denied); /* Paths the object is denied access to */
190 root 1.96 uint16 ACC (RW, materials); /* What materials this object consists of */
191 root 1.46 sint8 ACC (RW, magic); /* Any magical bonuses to this item */
192     uint8 ACC (RW, state); /* How the object was last drawn (animation) */
193 root 1.20 sint32 ACC (RW, value); /* How much money it is worth (or contains) */
194 root 1.18 /* Note that the last_.. values are sometimes used for non obvious
195     * meanings by some objects, eg, sp penalty, permanent exp.
196     */
197 root 1.20 sint32 ACC (RW, last_heal); /* Last healed. Depends on constitution */
198     sint32 ACC (RW, last_sp); /* As last_heal, but for spell points */
199     sint16 ACC (RW, last_grace); /* as last_sp, except for grace */
200     sint16 ACC (RW, last_eat); /* How long since we last ate */
201     sint16 ACC (RW, invisible); /* How much longer the object will be invis */
202 root 1.26 sint16 ACC (RW, level); /* Level of creature or object */
203 root 1.20 uint8 ACC (RW, pick_up); /* See crossfire.doc */
204     sint8 ACC (RW, item_power); /* power rating of the object */
205 root 1.46 sint8 ACC (RW, gen_sp_armour);/* sp regen penalty this object has (was last_heal) */
206 root 1.26 sint8 ACC (RW, glow_radius); /* indicates the glow radius of the object */
207 root 1.20 sint32 ACC (RW, weight); /* Attributes of the object */
208 root 1.46 sint32 ACC (RW, weight_limit);/* Weight-limit of object */
209 root 1.164 sint32 ACC (RW, carrying); /* How much weight this object contains, must be 0 if nrof == 0 */
210 root 1.20 sint64 ACC (RW, perm_exp); /* Permanent exp */
211     uint32 ACC (RW, weapontype); /* type of weapon */
212     uint32 ACC (RW, tooltype); /* type of tool or build facility */
213 root 1.116 body_slot slot [NUM_BODY_LOCATIONS];
214 root 1.139 faceidx ACC (RW, face); /* the graphical face */
215     faceidx ACC (RW, sound); /* the sound face */
216 root 1.141 faceidx ACC (RW, sound_destroy); /* played on destroy */
217 root 1.36 living ACC (RO, stats); /* Str, Con, Dex, etc */
218 root 1.68 /* See the pod/objects.pod for more info about body locations */
219 root 1.18
220     /* Following mostly refers to fields only used for monsters */
221 root 1.46 uint32 ACC (RW, hide); /* The object is hidden, not invisible */
222 root 1.68
223 root 1.18 /* allows different movement patterns for attackers */
224 root 1.20 sint32 ACC (RW, move_status); /* What stage in attack mode */
225     uint16 ACC (RW, attack_movement); /* What kind of attack movement */
226 root 1.26 uint16 ACC (RW, run_away); /* Monster runs away if it's hp goes below this percentage. */
227     float ACC (RW, expmul); /* needed experience = (calc_exp*expmul) - means some */
228 root 1.68 /* races/classes can need less/more exp to gain levels */
229 root 1.18
230     /* Spell related information, may be useful elsewhere
231     * Note that other fields are used - these files are basically
232     * only used in spells.
233     */
234 root 1.20 sint16 ACC (RW, duration); /* How long the spell lasts */
235 root 1.46 sint16 ACC (RW, casting_time);/* time left before spell goes off */
236 root 1.117
237 root 1.26 uint16 ACC (RW, start_holding);
238     uint8 ACC (RW, duration_modifier); /* how level modifies duration */
239 root 1.20 uint8 ACC (RW, dam_modifier); /* How going up in level effects damage */
240 root 1.117
241 root 1.46 sint8 ACC (RW, range); /* Range of the spell */
242 root 1.20 uint8 ACC (RW, range_modifier); /* How going up in level effects range */
243 root 1.68 MoveType ACC (RW, move_type); /* Type of movement this object uses */
244     MoveType ACC (RW, move_block);/* What movement types this blocks */
245 root 1.117
246 root 1.68 MoveType ACC (RW, move_allow);/* What movement types explicitly allowd */
247     MoveType ACC (RW, move_on); /* Move types affected moving on to this space */
248     MoveType ACC (RW, move_off); /* Move types affected moving off this space */
249     MoveType ACC (RW, move_slow); /* Movement types this slows down */
250 root 1.117
251 root 1.68 float ACC (RW, move_slow_penalty); /* How much this slows down the object */
252    
253 root 1.36 char *ACC (RW, spellarg);
254 root 1.18
255     /* Following are values used by any object */
256 root 1.56 /* this objects turns into or what this object creates */
257 root 1.40 treasurelist *ACC (RW, randomitems); /* Items to be generated */
258 root 1.66 flags_t flag; /* various flags */
259 root 1.67 #if FOR_PERL
260     bool ACC (RW, flag[NUM_FLAGS]);
261     #endif
262 root 1.46 uint16 ACC (RW, animation_id);/* An index into the animation array */
263     uint8 ACC (RW, anim_speed); /* ticks between animation-frames */
264     uint8 ACC (RW, last_anim); /* last sequence used to draw face */
265     uint8 ACC (RW, smoothlevel); /* how to smooth this square around */
266 root 1.32 uint8 ACC (RW, will_apply); /* See crossfire.doc */
267 elmex 1.178 uint16 ACC (RW, cached_sp); /* cached spell points used for a spell, used by esrv_update_spells */
268     uint16 ACC (RW, cached_grace);/* cached grace points used for a spell, used by esrv_update_spells */
269     uint16 ACC (RW, cached_eat); /* cached food, used by esrv_update_spells */
270 elmex 1.4 };
271    
272 root 1.68 struct object : zero_initialised, object_copy
273 root 1.18 {
274 root 1.65 // These variables are not changed by ->copy_to
275 root 1.182 maptile *ACC (RW, map); /* Pointer to the map in which this object is present */
276 root 1.65
277     UUID ACC (RW, uuid); // Unique Identifier, survives saves etc.
278 root 1.82 int ACC (RO, count);
279 root 1.134 object_vector_index ACC (RO, index); // index into objects
280     object_vector_index ACC (RO, active); // index into actives
281 root 1.65
282 root 1.142 player_ptr ACC (RW, contr); /* Pointer to the player which control this object, ALWAYS set *iff* type == PLAYER */
283 root 1.81
284 root 1.65 object *ACC (RW, below); /* Pointer to the object stacked below this one */
285     object *ACC (RW, above); /* Pointer to the object stacked above this one */
286     /* Note: stacked in the *same* environment */
287     object *inv; /* Pointer to the first object in the inventory */
288 root 1.83
289     //TODO: container must move into client
290 root 1.99 object_ptr ACC (RW, container); /* Current container being used. I think this
291 root 1.65 * is only used by the player right now.
292     */
293     object *ACC (RW, env); /* Pointer to the object which is the environment.
294     * This is typically the container that the object is in.
295     */
296     object *ACC (RW, more); /* Pointer to the rest of a large body of objects */
297     object *head; /* Points to the main object of a large body */ // NO ACC, perl semantics are different
298     client_container *seen_by; // seen by which player/container currently?
299 root 1.105 key_value *key_values; /* Fields not explictly known by the loader. */
300 root 1.65
301 root 1.172 // privates / perl
302     const shstr &kv_get (const shstr &key) const;
303     void kv_del (const shstr &key);
304     void kv_set (const shstr &key, const shstr &value);
305    
306     // custom extra fields management
307     struct key_value_access_proxy
308     {
309     object &ob;
310     shstr key;
311    
312     key_value_access_proxy (object &ob, const shstr &key)
313     : ob (ob), key (key)
314     {
315     }
316    
317     const key_value_access_proxy &operator =(const shstr &value) const
318     {
319     ob.kv_set (key, value);
320     return *this;
321     }
322    
323     operator const shstr &() const { return ob.kv_get (key); }
324     operator const char *() const { return ob.kv_get (key); }
325    
326     private:
327     void operator =(int);
328     };
329    
330     // operator [] is too annoying to use
331     const key_value_access_proxy kv (const shstr &key)
332     {
333     return key_value_access_proxy (*this, key);
334     }
335    
336 root 1.100 bool parse_kv (object_thawer &f); // parse kv pairs, (ab-)used by archetypes, which should not exist at all
337 root 1.148 MTH void post_load_check (); // do some adjustments after parsing
338 root 1.101 static object *read (object_thawer &f, maptile *map = 0); // map argument due to toal design bogosity, must go.
339 root 1.100 bool write (object_freezer &f);
340    
341 root 1.121 MTH int slottype () const;
342 root 1.69 MTH static object *create ();
343 root 1.146 const mapxy &operator =(const mapxy &pos);
344 root 1.69 MTH void copy_to (object *dst);
345 root 1.173 MTH object *clone (); // create + copy_to a single object
346     MTH object *deep_clone (); // copy whole more chain and inventory
347 root 1.68 void do_destroy ();
348     void gather_callbacks (AV *&callbacks, event_type event) const;
349 root 1.185 MTH void destroy ();
350 root 1.184 MTH void drop_and_destroy ()
351     {
352     destroy_inv (true);
353     destroy ();
354     }
355 root 1.68
356     // recursively destroy all objects in inventory, optionally dropping them to the ground instead
357 root 1.69 MTH void destroy_inv (bool drop_to_ground = false);
358     MTH object *insert (object *item); // insert into inventory
359 root 1.164 MTH void play_sound (faceidx sound);
360 root 1.138
361 root 1.95 void do_remove ();
362 root 1.88 MTH void remove ()
363     {
364     if (!flag [FLAG_REMOVED])
365 root 1.95 do_remove ();
366 root 1.88 }
367 root 1.22
368 root 1.150 MTH bool blocked (maptile *m, int x, int y) const;
369    
370 root 1.146 void move_to (const mapxy &pos)
371     {
372     remove ();
373     *this = pos;
374     insert_at (this, this);
375     }
376    
377 root 1.51 static bool can_merge_slow (object *op1, object *op2);
378    
379     // this is often used in time-critical code, so optimise
380 root 1.69 MTH static bool can_merge (object *op1, object *op2)
381 root 1.51 {
382 root 1.52 return op1->value == op2->value
383     && op1->name == op2->name
384 root 1.51 && can_merge_slow (op1, op2);
385     }
386 root 1.19
387 root 1.69 MTH void set_owner (object *owner);
388 root 1.70 MTH void set_speed (float speed);
389 root 1.120 MTH bool change_weapon (object *ob);
390 root 1.123 MTH bool change_skill (object *ob);
391 root 1.51
392 root 1.99 MTH void open_container (object *new_container);
393     MTH void close_container ()
394     {
395     open_container (0);
396     }
397    
398 root 1.136 MTH object *force_find (const shstr name);
399     MTH void force_add (const shstr name, int duration = 0);
400    
401 root 1.126 // overwrite the attachable should_invoke function with a version that also checks ev_want_type
402     bool should_invoke (event_type event)
403 root 1.125 {
404 root 1.126 return ev_want_event [event] || ev_want_type [type] || cb;
405 root 1.125 }
406    
407 root 1.100 MTH void instantiate ();
408 root 1.34
409 root 1.62 // recalculate all stats
410 root 1.69 MTH void update_stats ();
411     MTH void roll_stats ();
412     MTH void swap_stats (int a, int b);
413     MTH void add_statbonus ();
414     MTH void remove_statbonus ();
415     MTH void drain_stat ();
416     MTH void drain_specific_stat (int deplete_stats);
417     MTH void change_luck (int value);
418 root 1.62
419 root 1.33 // info must hold 256 * 3 bytes currently
420 root 1.73 const char *debug_desc (char *info) const;
421 root 1.113 MTH const char *debug_desc () const; // uses at least 3 round-robin buffers
422 root 1.75 const char *flag_desc (char *desc, int len) const;
423 root 1.33
424 root 1.165 MTH bool decrease (sint32 nr = 1); // returns true if anything is left
425     MTH object *split (sint32 nr = 1); // return 0 on failure
426 root 1.164
427 root 1.163 MTH int number_of () const
428 root 1.96 {
429     return nrof ? nrof : 1;
430     }
431    
432 root 1.163 MTH sint32 total_weight () const
433 root 1.96 {
434 root 1.164 return (weight + carrying) * number_of ();
435 root 1.96 }
436    
437 root 1.163 MTH void update_weight ();
438    
439 root 1.96 // return the dominant material of this item, always return something
440 root 1.97 const materialtype_t *dominant_material () const;
441 root 1.96
442 root 1.98 // return the volume of this object in cm³
443 root 1.163 MTH uint64 volume () const
444 root 1.96 {
445 root 1.98 return total_weight ()
446     * 1000
447     * (type == CONTAINER ? 1000 : 1)
448     / dominant_material ()->density;
449 root 1.96 }
450    
451 root 1.183 MTH bool is_wiz () const { return flag [FLAG_WIZ]; }
452 root 1.69 MTH bool is_weapon () const { return type == ARROW || type == BOW || type == WEAPON; }
453     MTH bool is_armor () const { return type == ARMOUR || type == SHIELD || type == HELMET
454     || type == CLOAK || type == BOOTS || type == GLOVES
455     || type == BRACERS || type == GIRDLE; }
456     MTH bool is_alive () const { return (type == PLAYER
457     || flag [FLAG_MONSTER]
458     || (flag [FLAG_ALIVE] && !flag [FLAG_GENERATOR] && type != DOOR))
459     && !flag [FLAG_IS_A_TEMPLATE]; }
460     MTH bool is_arrow () const { return type == ARROW
461     || (type == SPELL_EFFECT
462     && (subtype == SP_BULLET || subtype == SP_MAGIC_MISSILE)); }
463 root 1.114 MTH bool is_range () const { return type == BOW || type == ROD || type == WAND || type == HORN; }
464 root 1.57
465 elmex 1.74 MTH bool has_active_speed () const { return FABS(speed) >= MIN_ACTIVE_SPEED; }
466    
467 root 1.76 // temporary: wether the object can be saved in a map file
468 root 1.72 // contr => is a player
469     // head => only save head of a multitile object
470     // owner => can not reference owner yet
471 root 1.145 MTH bool can_map_save () const { return !head && (!owner || owner->contr) && !contr && !flag [FLAG_NO_MAP_SAVE]; }
472 root 1.72
473 root 1.57 /* This return true if object has still randomitems which
474     * could be expanded.
475     */
476 root 1.69 MTH bool has_random_items () const { return randomitems && !flag [FLAG_IS_A_TEMPLATE]; }
477 root 1.57
478 root 1.179 MTH bool has_dialogue () const { return *&msg == '@'; }
479    
480 root 1.170 // returns the outermost owner, never returns 0
481     MTH object *outer_owner ()
482     {
483 root 1.181 object *op;
484    
485     for (op = this; op->owner; op = op->owner)
486     ;
487    
488     return op;
489 root 1.170 }
490    
491 root 1.163 // returns the outermost environment, never returns 0
492     MTH object *outer_env ()
493     {
494 root 1.181 object *op;
495    
496     for (op = this; op->env; op = op->env)
497     ;
498    
499     return op;
500 root 1.163 }
501    
502 root 1.60 // returns the player that has this object in his inventory, or 0
503 root 1.164 // we assume the player is always the outer env
504     MTH object *in_player ()
505 root 1.60 {
506 root 1.164 object *op = outer_env ();
507 root 1.60
508 root 1.164 return op->type == PLAYER ? op : 0;
509 root 1.60 }
510    
511 root 1.71 // "temporary" helper function
512     MTH object *head_ ()
513     {
514     return head ? head : this;
515     }
516    
517 root 1.130 MTH bool is_head ()
518     {
519     return head_ () == this;
520     }
521    
522 root 1.164 MTH bool is_on_map () const
523     {
524     return !env && !flag [FLAG_REMOVED];
525     }
526    
527 elmex 1.186 MTH bool is_in_map_or_inv () const
528     {
529     return !flag [FLAG_REMOVED];
530     }
531    
532 root 1.166 // returns the player that cna see this object, if any
533     MTH object *visible_to () const;
534    
535 root 1.110 MTH std::string long_desc (object *who = 0);
536     MTH std::string describe_monster (object *who = 0);
537     MTH std::string describe_item (object *who = 0);
538     MTH std::string describe (object *who = 0);
539    
540 root 1.109 // If this object has no extra parts but should have them,
541     // add them, effectively expanding heads into multipart
542     // objects. This method only works on objects not inserted
543     // anywhere.
544 root 1.111 MTH void expand_tail ();
545    
546     MTH void create_treasure (treasurelist *tl, int flags = 0);
547 root 1.109
548 root 1.71 // insert object at same map position as 'where'
549     // handles both inventory and map "positions"
550     MTH object *insert_at (object *where, object *originator = 0, int flags = 0);
551 root 1.137 MTH void drop_unpaid_items ();
552 root 1.71
553 root 1.78 MTH void activate ();
554     MTH void deactivate ();
555     MTH void activate_recursive ();
556     MTH void deactivate_recursive ();
557 root 1.73
558 root 1.158 // set the given flag on all objects in the inventory recursively
559 root 1.79 MTH void set_flag_inv (int flag, int value = 1);
560    
561 root 1.112 void enter_exit (object *exit);//Perl
562 root 1.73 MTH void enter_map (maptile *newmap, int x, int y);
563 root 1.174 void player_goto (const char *path, int x, int y); // only for players
564 root 1.73
565 root 1.61 // returns the mapspace this object is in
566     mapspace &ms () const;
567    
568 root 1.29 // fully recursive iterator
569     struct iterator_base
570     {
571     object *item;
572    
573 root 1.30 iterator_base (object *container)
574     : item (container)
575 root 1.29 {
576     }
577    
578     operator object *() const { return item; }
579    
580     object *operator ->() const { return item; }
581     object &operator * () const { return *item; }
582     };
583    
584 root 1.77 MTH unsigned int random_seed () const
585     {
586     return (unsigned int)uuid.seq;
587     }
588    
589 root 1.30 // depth-first recursive iterator
590     struct depth_iterator : iterator_base
591 root 1.29 {
592 root 1.30 depth_iterator (object *container);
593 root 1.29 void next ();
594     object *operator ++( ) { next (); return item; }
595     object *operator ++(int) { object *i = item; next (); return i; }
596     };
597    
598     object *begin ()
599     {
600 root 1.30 return this;
601 root 1.29 }
602    
603     object *end ()
604     {
605 root 1.30 return this;
606 root 1.29 }
607    
608 root 1.84 /* This returns TRUE if the object is something that
609 root 1.168 * a client might want to know about.
610 root 1.84 */
611     MTH bool client_visible () const
612     {
613     return !invisible && type != PLAYER;
614     }
615    
616 root 1.167 // the client does nrof * this weight
617     MTH sint32 client_weight () const
618     {
619     return weight + carrying;
620     }
621    
622 root 1.93 MTH struct region *region () const;
623    
624 root 1.143 void statusmsg (const char *msg, int color = NDI_BLACK);
625 root 1.144 void failmsg (const char *msg, int color = NDI_RED);
626 root 1.143
627 root 1.151 const char *query_inventory (object *who = 0, const char *indent = "");
628    
629 root 1.148 MTH const_octet_string ref () const; // creates and returns a consistent persistent object reference
630     static object *deref (const_octet_string ref); // returns the object from the generated refreence, if possible
631    
632 root 1.23 protected:
633 root 1.130 void link ();
634 root 1.24 void unlink ();
635    
636 root 1.23 object ();
637     ~object ();
638 root 1.171
639     private:
640     object &operator =(const object &);
641     object (const object &);
642 elmex 1.4 };
643 root 1.1
644 root 1.124 // move this object to the top of its env's inventory to speed up
645     // searches for it.
646     static object *
647     splay (object *ob)
648     {
649     if (ob->env && ob->env->inv != ob)
650     {
651     if (ob->above) ob->above->below = ob->below;
652     if (ob->below) ob->below->above = ob->above;
653    
654     ob->above = 0;
655     ob->below = ob->env->inv;
656     ob->below->above = ob;
657     ob->env->inv = ob;
658     }
659    
660     return ob;
661     }
662    
663 root 1.20 typedef struct oblnk
664     { /* Used to link together several objects */
665 root 1.43 object_ptr ob;
666 root 1.1 struct oblnk *next;
667     } objectlink;
668    
669 root 1.20 typedef struct oblinkpt
670     { /* Used to link together several object links */
671 root 1.1 struct oblnk *link;
672 root 1.159 sint32 value; /* Used as connected value in buttons/gates */
673 root 1.1 struct oblinkpt *next;
674     } oblinkpt;
675    
676 root 1.122 object *find_skill_by_name (object *who, const char *name);
677     object *find_skill_by_name (object *who, const shstr &sh);
678     object *find_skill_by_number (object *who, int skillno);
679    
680 root 1.1 /*
681     * The archetype structure is a set of rules on how to generate and manipulate
682     * objects which point to archetypes.
683     * This probably belongs in arch.h, but there really doesn't appear to
684     * be much left in the archetype - all it really is is a holder for the
685     * object and pointers. This structure should get removed, and just replaced
686     * by the object structure
687     */
688    
689 root 1.68 INTERFACE_CLASS (archetype)
690 root 1.130 struct archetype : object
691 root 1.15 {
692 root 1.161 static arch_ptr empty; // the empty_archetype
693     MTH static void gc ();
694 root 1.160
695 root 1.130 archetype (const char *name);
696 root 1.22 ~archetype ();
697 root 1.68 void gather_callbacks (AV *&callbacks, event_type event) const;
698 root 1.22
699 root 1.148 MTH static archetype *find (const_utf8_string name);
700    
701     MTH void link ();
702     MTH void unlink ();
703 root 1.44
704 root 1.175 MTH static object *get (const char *name); // (find() || singularity)->instance()
705 root 1.152 MTH object *instance ();
706    
707 root 1.134 object_vector_index ACC (RW, archid); // index in archvector
708 root 1.129 shstr ACC (RW, archname); /* More definite name, like "generate_kobold" */
709    
710     sint8 ACC (RW, min_x), ACC (RW, min_y); /* extents, compared to the head (min_x, min_y should be zero, but aren't...) */
711     sint8 ACC (RW, max_x), ACC (RW, max_y);
712 root 1.160
713     // support for archetype loading
714     static archetype *read (object_thawer &f);
715     MTH static void commit_load (); // commit any objects loaded, resolves cyclic dependencies and more
716     static void postpone_arch_ref (arch_ptr &ref, const_utf8_string other_arch); /* postpone other_arch reference */
717 root 1.21 };
718 root 1.1
719 root 1.177 // compatbiility, remove once replaced by ->instance
720     inline object *
721     arch_to_object (archetype *at)
722     {
723     return at->instance ();
724     }
725    
726 root 1.132 inline void
727     object_freezer::put (keyword k, archetype *v)
728     {
729     put (k, v ? &v->archname : (const char *)0);
730     }
731    
732 root 1.129 typedef object_vector<object, &object::index > objectvec;
733     typedef object_vector<object, &object::active> activevec;
734     typedef object_vector<archetype, &archetype::archid> archvec;
735    
736     extern objectvec objects;
737     extern activevec actives;
738     extern archvec archetypes;
739    
740 root 1.176 // "safely" iterate over inv in a way such that the current item is removable
741     // quite horrible, thats why its hidden in some macro
742     #define for_inv_removable(op,var) \
743     for (object *var, *next_ = (op)->inv; (var = next_), var && (next_ = var->below), var; )
744    
745     #define for_all_objects(var) \
746 root 1.129 for (unsigned _i = 0; _i < objects.size (); ++_i) \
747     statementvar (object *, var, objects [_i])
748    
749 root 1.176 #define for_all_actives(var) \
750 root 1.129 for (unsigned _i = 0; _i < actives.size (); ++_i) \
751     statementvar (object *, var, actives [_i])
752    
753 root 1.176 #define for_all_archetypes(var) \
754 root 1.129 for (unsigned _i = 0; _i < archetypes.size (); ++_i) \
755     statementvar (archetype *, var, archetypes [_i])
756    
757 root 1.1 /* Used by update_object to know if the object being passed is
758     * being added or removed.
759     */
760     #define UP_OBJ_INSERT 1
761     #define UP_OBJ_REMOVE 2
762     #define UP_OBJ_CHANGE 3
763 root 1.20 #define UP_OBJ_FACE 4 /* Only thing that changed was the face */
764 root 1.1
765     /* These are flags passed to insert_ob_in_map and
766     * insert_ob_in_ob. Note that all flags may not be meaningful
767     * for both functions.
768     * Most are fairly explanatory:
769     * INS_NO_MERGE: don't try to merge inserted object with ones alrady
770     * on space.
771     * INS_ABOVE_FLOOR_ONLY: Put object immediatly above the floor.
772     * INS_NO_WALK_ON: Don't call check_walk_on against the
773     * originator - saves cpu time if you know the inserted object
774     * is not meaningful in terms of having an effect.
775     * INS_ON_TOP: Always put object on top. Generally only needed when loading
776     * files from disk and ordering needs to be preserved.
777     * INS_BELOW_ORIGINATOR: Insert new object immediately below originator -
778     * Use for treasure chests so the new object is the highest thing
779     * beneath the player, but not actually above it. Note - the
780     * map and x,y coordinates for the object to be inserted must
781     * match the originator.
782     *
783     * Note that INS_BELOW_ORIGINATOR, INS_ON_TOP, INS_ABOVE_FLOOR_ONLY
784     * are mutually exclusive. The behaviour for passing more than one
785     * should be considered undefined - while you may notice what happens
786     * right now if you pass more than one, that could very well change
787     * in future revisions of the code.
788     */
789 root 1.14 #define INS_NO_MERGE 0x0001
790     #define INS_ABOVE_FLOOR_ONLY 0x0002
791     #define INS_NO_WALK_ON 0x0004
792     #define INS_ON_TOP 0x0008
793     #define INS_BELOW_ORIGINATOR 0x0010
794 root 1.1
795     #define ARCH_DEPLETION "depletion"
796    
797     #endif
798 root 1.44