ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/include/object.h
Revision: 1.188
Committed: Sun Nov 16 03:52:12 2008 UTC (15 years, 6 months ago) by root
Content type: text/plain
Branch: MAIN
CVS Tags: rel-2_72, rel-2_73
Changes since 1.187: +36 -25 lines
Log Message:
*** empty log message ***

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