/* Copyright 1996 Acorn Computers Ltd
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/****************************************************************************
 * This source file was written by Acorn Computers Limited. It is part of   *
 * the RISCOS library for writing applications in C for RISC OS. It may be  *
 * used freely in the creation of programs for Archimedes. It should be     *
 * used with Acorn's C Compiler Release 3 or later.                         *
 *                                                                          *
 ***************************************************************************/

/*
 * 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.
 *
 */

void visdelay_begin(void);


/* -------------------------- visdelay_percent -----------------------------
 * Description:   Indicates to user that delay is p percent complete.
 *
 * Parameters:    int p -- percentage complete
 * Returns:       void.
 * Other Info:    none.
 *
 */

void visdelay_percent(int p);


/* --------------------------- visdelay_end --------------------------------
 * Decsription:   Remove indication of delay.
 *
 * Parameters:    void
 * Returns:       void.
 * Other Info:    none.
 *
 */

void visdelay_end(void);


/* --------------------------- visdelay_init -------------------------------
 * Description:   Initialise ready for visdelay functions.
 *
 * Parameters:    void
 * Returns:       void.
 * Other Info:    none.
 *
 */

void visdelay_init(void);

#endif

/* end visdelay.h */