/*
 * pointer.h
 *
 * Handling of pointer-shape changing
 *
 * © 1994-1998 Straylight
 */

/*----- Licensing note ----------------------------------------------------*
 *
 * This file is part of Straylight's Steel library.
 *
 * Steel is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
 *
 * Steel is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Steel.  If not, write to the Free Software Foundation,
 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

#ifndef __pointer_h
#define __pointer_h

#ifndef __os_h
  #include "os.h"
#endif

#ifndef __sprite_h
  #include "sprite.h"
#endif

/*
 * os_error *pointer_set_shape(sprite_area *a,sprite_id *sid,int x,int y)
 *
 * Use
 *  Sets the pointer shape to be the pointer specified.  If a pointer with
 *  name `name<dx><dy>' is found in the sprite area, that's used instead, and
 *  the active point is scaled assuming that the original was specified in
 *  mode-8 type coordinates.
 *
 * Parameters
 *  sprite_area *a == the sprite area containing the sprite
 *  sprite_id *sid == pointer to the sprite identifier (dumb idea)
 *  int x,int y == coordinates (in pixels) of the hot-spot
 */

os_error *pointer_set_shape(sprite_area *a,sprite_id *sid,int x,int y);

/*
 * void pointer_reset_shape(void)
 *
 * Use
 *  Resets the pointer shape
 */

void pointer_reset_shape(void);

#endif