chiark - git - mdw - ssr/blob - StraySrc/Libraries/Steel/h/pointer

   1 /*
   2  * pointer.h
   3  *
   4  * Handling of pointer-shape changing
   5  *
   6  * © 1994-1998 Straylight
   7  */
   8
   9 /*----- Licensing note ----------------------------------------------------*
  10  *
  11  * This file is part of Straylight's Steel library.
  12  *
  13  * Steel is free software; you can redistribute it and/or modify
  14  * it under the terms of the GNU General Public License as published by
  15  * the Free Software Foundation; either version 2, or (at your option)
  16  * any later version.
  17  *
  18  * Steel is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  * GNU General Public License for more details.
  22  *
  23  * You should have received a copy of the GNU General Public License
  24  * along with Steel.  If not, write to the Free Software Foundation,
  25  * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  26  */
  27
  28 #ifndef __pointer_h
  29 #define __pointer_h
  30
  31 #ifndef __os_h
  32   #include "os.h"
  33 #endif
  34
  35 #ifndef __sprite_h
  36   #include "sprite.h"
  37 #endif
  38
  39 /*
  40  * os_error *pointer_set_shape(sprite_area *a,sprite_id *sid,int x,int y)
  41  *
  42  * Use
  43  *  Sets the pointer shape to be the pointer specified.  If a pointer with
  44  *  name `name<dx><dy>' is found in the sprite area, that's used instead, and
  45  *  the active point is scaled assuming that the original was specified in
  46  *  mode-8 type coordinates.
  47  *
  48  * Parameters
  49  *  sprite_area *a == the sprite area containing the sprite
  50  *  sprite_id *sid == pointer to the sprite identifier (dumb idea)
  51  *  int x,int y == coordinates (in pixels) of the hot-spot
  52  */
  53
  54 os_error *pointer_set_shape(sprite_area *a,sprite_id *sid,int x,int y);
  55
  56 /*
  57  * void pointer_reset_shape(void)
  58  *
  59  * Use
  60  *  Resets the pointer shape
  61  */
  62
  63 void pointer_reset_shape(void);
  64
  65 #endif