(*
 * Title:   res.h
 * Purpose: Access to resources
 *
 *)

# ifndef __res_h
# define __res_h

(* -------------------------------- res_init ------------------------------
 * Description:   Initialises, ready for calling other res functions.
 *
 * Parameters:    const char *a -- your program name
 * Returns:       void.
 * Other Info:    call this before using any res functions
 *                (or before using any resspr functions!).
 *
 *)
procedure res_init(progname : string); extern;


(* ------------------------------- res_findname ---------------------------
 * Description:   Creates full pathname for "resname" file.
 *
 * Parameters:    const char *resname -- name of one of your resource files
 *                char *buf -- buffer to put full pathname in
 * Returns:       TRUE always!!
 * Other Info:    full pathname is constructed as:
 *                             <ProgramName$Dir>.resname
 *                where ProgramName has been set using res_init.
 *
 *)
procedure res_findname(resname : string; buf : string) : boolean; extern;


(* -------------------------- res_openfile --------------------------------
 * Description:   opens a named resource file, in a given ANSI-style mode.
 *
 * Parameters:    const char *resname -- name of the resource file
 *                const char *mode -- usual ANSI open mode ("r", "w", etc)
 * Returns:       ANSI FILE pointer for opened file.
 * Other Info:    resname should be a "leafname" (a call to res_findname is
 *                made for you!).
 *
 *)
function res_openfile(resname : string; mode : string) : pointer; extern;

#endif

(* end of res.h *)
