/*
 * ptr.h
 *
 * [Generated from ptr, 25 September 1996]
 */

#if !defined(__CC_NORCROFT) || !defined(__arm)
  #error You must use the Norcroft ARM Compiler for Sapphire programs
#endif

#pragma include_only_once
#pragma force_top_level

#ifndef __ptr_h
#define __ptr_h

#ifndef __sapphire_h
  #include "sapphire.h"
#endif

/*----- Overview ----------------------------------------------------------*
 *
 * Functions provided:
 *
 *  ptr_setShape
 *  ptr_resetShape
 *  ptr_blinkOn
 *  ptr_blinkOff
 *  ptr_init
 */

/* --- ptr_setShape --- *
 *
 * On entry:	R0 == sprite name
 *		R1 == x offset of hot spot
 *		R2 == y offset of hot spot
 *
 * On exit:	--
 *
 * Use:		Set the pointer sprite to the given name. The sprite area
 *		used is that returned from resspre_area.
 */

extern routine ptr_setShape;

/* --- ptr_resetShape --- *
 *
 * On entry:	--
 *
 * On exit:	--
 *
 * Use:		Resets the pointer shape to the default.
 */

extern routine ptr_resetShape;

/* --- ptr_blinkOn --- *
 *
 * On entry:	--
 *
 * On exit:	--
 *
 * Use:		Makes the caret blink while it is in a window owned by your
 *		application.
 */

extern routine ptr_blinkOn;

/* --- ptr_blinkOff --- *
 *
 * On entry:	--
 *
 * On exit:	--
 *
 * Use:		Turns the caret blinking off.
 */

extern routine ptr_blinkOff;

/* --- ptr_init --- *
 *
 * On entry:	--
 *
 * On exit:	--
 *
 * Use:		Initialises the ptr system.
 */

extern routine ptr_init;

/*----- That's all, folks -------------------------------------------------*/

#endif
