(*
 * Title:   visdelay.h
 * Purpose: Visual indication of some delay
 *
 *)

#ifndef __visdelay_h
#define __visdelay_h

(* ----------------------------- visdelay_begin ----------------------------
 * Description:   Change pointer to show user there will be some delay
 *                (currently the RISC OS hourglass).
 *
 * Parameters:    void
 * Returns:       void.
 * Other Info:    Under RISC OS hourglass will only appear if the delay
 *                is longer than 1/3 sec.
 *
 *)
procedure visdelay_begin; extern;


(* -------------------------- visdelay_percent -----------------------------
 * Description:   Indicates to user that delay is p percent complete.
 * 
 * Parameters:    int p -- percentage complete
 * Returns:       void.
 * Other Info:    none.
 *
 *)
procedure visdelay_percent(p : integer); extern;


(* --------------------------- visdelay_end --------------------------------
 * Decsription:   Remove indication of delay.
 *
 * Parameters:    void
 * Returns:       void.
 * Other Info:    none.
 *
 *)
procedure visdelay_end; extern;


(* --------------------------- visdelay_init -------------------------------
 * Description:   Initialise ready for visdelay functions.
 *
 * Parameters:    void
 * Returns:       void.
 * Other Info:    none.
 *
 *)
procedure visdelay_init; extern;

#endif

(* end visdelay.h *)
