home · contact · privacy
Heavy refactoring of all file I/O and some memory handling; also repaired some incons...
[plomrogue] / src / misc.h
1 /* misc.h
2  *
3  * Miscellaneous routines that have not yet found a proper parent module. Having
4  * LOTS of stuff in here is a sure sign that better modularization is in order.
5  */
6
7 #ifndef MISC_H
8 #define MISC_H
9
10
11
12 #include <stdlib.h>    /* for size_t */
13 #include <stdint.h>    /* for uint16_t */
14 #include "yx_uint16.h" /* for yx_uint16 coordinates */
15 struct World;
16 struct Map;
17
18
19
20 /* Returns message: "Trouble in ".parent." with ".child."." (try_*() helper) */
21 extern char * trouble_msg(struct World * w, char * parent, char * child);
22
23 /* Wrappers to malloc(), calloc() from function called "f" calling exit_err()
24  * with trouble_msg() error message if necessary.
25  */
26 extern void * try_malloc(size_t size, struct World * w, char * f);
27 extern void * try_calloc(size_t nmemb, size_t size,
28                          struct World * w, char * f);
29
30
31
32 /* Check if tempfile "path" exists, and if so, exit with explanation that. */
33 extern void check_tempfile(char * path, struct World * f);
34
35 /* If one and only one of files at "p1", "p2" exists, fail with explanation. */
36 extern void check_files_xor(char * p1, char * p2, struct World * w);
37
38
39
40 /* Update game log by appending "text", or by appending a "." if "text" is the
41  * same as the last one passed.
42  */
43 extern void update_log(struct World * world, char * text);
44
45
46
47 /* Return the offset necessary to center "map" on position "pos" in a frame of
48  * "framesize.
49  */
50 extern uint16_t center_offset(uint16_t pos, uint16_t mapsize,
51                               uint16_t framesize);
52
53
54
55 /* Record last player "action" in game record file "record, increment the game
56  * turn and trigger enemy movement.
57  */
58 extern void turn_over(struct World * world, char action);
59
60
61
62 /* Save current game data to file "savefile". */
63 extern void save_game(struct World * world);
64
65
66
67 /* Return a random position on the map "map" that is passable (as determined by
68  * is_passable().
69  */
70 extern struct yx_uint16 find_passable_pos(struct Map * map);
71
72
73
74 #endif