plomlompom.com Git - plomrogue/blob - 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 #include <stdlib.h>    /* for size_t */
  11 #include <stdint.h>    /* for uint16_t */
  12 #include "yx_uint16.h" /* for yx_uint16 coordinates */
  13 struct Map;
  14
  15
  16
  17 /* Returns message: "Trouble in ".parent." with ".child."." (try_*() helper) */
  18 extern char * trouble_msg(char * parent, char * child);
  19
  20 /* Wrappers to malloc(), calloc() from function called "f" calling exit_err()
  21  * with trouble_msg() error message if necessary.
  22  */
  23 extern void * try_malloc(size_t size, char * f);
  24 extern void * try_calloc(size_t nmemb, size_t size, char * f);
  25
  26
  27
  28 /* Check if tempfile "path" exists, and if so, exit with explanation that. */
  29 extern void check_tempfile(char * path);
  30
  31 /* If one and only one of files at "p1", "p2" exists, fail with explanation. */
  32 extern void check_files_xor(char * p1, char * p2);
  33
  34
  35
  36 /* Save / load / unload (free) / reload interface configuration data. */
  37 extern void save_interface_conf();
  38 extern void load_interface_conf();
  39 extern void unload_interface_conf();
  40 extern void reload_interface_conf();
  41
  42
  43
  44 /* Update game log by appending "text", or by appending a "." if "text" is the
  45  * same as the last one passed.
  46  */
  47 extern void update_log(char * text);
  48
  49
  50
  51 /* Return the offset necessary to center a map of "mapsize" on position "pos" in
  52  * a frame of "framesize.
  53  */
  54 extern uint16_t center_offset(uint16_t pos,
  55                               uint16_t mapsize, uint16_t framesize);
  56
  57
  58
  59 /* Record last player "action" in game record file "record, increment the game
  60  * turn and trigger enemy movement.
  61  */
  62 extern void turn_over(char action);
  63
  64
  65
  66 /* Save or load current game data to / from file "savefile". */
  67 extern void save_game();
  68 extern void load_game();
  69
  70
  71
  72 /* Return a random position on the map "map" that is passable (as determined by
  73  * is_passable().
  74  */
  75 extern struct yx_uint16 find_passable_pos(struct Map * map);
  76
  77
  78
  79 /* Navigate (as far as possible) up (dir=='u') or (else) down in player's
  80  * inventory selection.
  81  */
  82 extern void nav_inventory(char dir);
  83
  84
  85
  86 #endif