#ifndef WH_MON___YOU_H_cda6cc7c_
#define WH_MON___YOU_H_cda6cc7c_

/*
 * APIs exported by mon-@-you.c.
 *
 * Unlike most monster implementations, mon-@-you exports a lot more
 *  than just its monster's MTINFO.  But then, the player avatar is
 *  rather different from most monsters.
 */

#include "structs.h"

/*
 * Initialize stuff not directly related to the player-avatar monster.
 */
extern void inityou(void);

/*
 * Open the door at a location.
 */
extern void opendoor(LOC *);

/*
 * Close the door at a location.
 */
extern void closedoor(LOC *);

/*
 * Teleport the player to the argument location.
 */
extern void teleport_you(LOC *);

/*
 * Show pline()d messages, if any.  If there are any and the argument
 *  is nonzero, give the player a more break before returning.
 */
extern void showmsgbuf(int);

/*
 * Create and set up the player-avatar monster.
 */
extern void setup_you(void);

/*
 * Initialize the tracking data.
 */
extern void init_track(void);

/*
 * `Find' a secret door (that is, convert it into a closed ordinary
 *  door).
 */
extern void finddoor(LOC *);

/*
 * Redo all sight-based stuff.  This is suitable for use when something
 *  has changed that can drastically affect what cells are visible.
 */
extern void resee(void);

/*
 * Set up a continuing action.
 *
 * set_continuing(fn,arg,flags) calls (*fn)(arg) instead of the usual
 *  tget()-and-dispatch.  flags is flags:
 *	CONT_NODISP
 *		If set, suppresses the drawing of the default display
 *		each cycle.  If clear, the default display happens as
 *		normal.
 */
extern void set_continuing(int (*)(void *), void *, unsigned int);
#define CONT_NODISP 0x00000001

/*
 * You, the player, gain experience.
 */
extern void you_gain_exp(int);

/*
 * Search around a location.  The second arg is flags:
 *	SEARCH_PERFECT
 *		Always find anything that stands any chance of being
 *		found.  Without this, searching may miss things.
 *  Return value is true if anything was found, false if not.
 *
 * XXX At this writing, all searches operate a la SEARCH_PERFECT.
 */
extern int search(LOC *, unsigned int);
#define SEARCH_PERFECT 0x00000001

/*
 * Pick a location, eg for controlled teleport.  Arg is prompt.
 */
extern LOC *pick_location(const char *);

#endif