home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / dde / datatoaof / Examples / Example2 / !HideTest / h / resspr+
Encoding:
Text File  |  1992-11-14  |  2.0 KB  |  56 lines
  1. /* Title:       resspr+.h
  2.  * Pupose:      Access to sprite resources that have been
  3.  *              hidden within your program using !DataToAOF
  4.  * Author:      (c) Paul Fidler 1992
  5.  * Use:         This headed file is designed to be used in
  6.  *              place of RISCOSLib.h.resspr . It provides
  7.  *              The same two fuctions as resspr.h, but 
  8.  *              resspr_init() now takes two parameters.
  9.  */
  10.  
  11. #ifndef __resspr_h
  12. #define __resspr_h
  13.  
  14. # ifndef __sprite_h
  15. # include "sprite.h"
  16. # endif
  17.  
  18. /* ----------------------------- resspr_init -------------------------------
  19.  * Description:   Initialises, ready for calls to resspr functions.
  20.  *
  21.  * Parameters:    sprite_area *sprites - The address of the hidden sprite
  22.  *                                       file.
  23.  *                int length           - The length of the hidden sprite
  24.  *                                       file.
  25.  * Returns:       void.
  26.  * Other Info:    call before using any resspr functions and before using
  27.  *                template_init() !! This function reads in your sprites.
  28.  *                This fuction is NOT exactly the same as the RISCOSLib
  29.  *                fuction it replaces.
  30.  *
  31.  */
  32.  
  33. extern void resspr_init(sprite_area *sprites, int length);
  34.  
  35. /* ------------------------------ resspr_area ------------------------------
  36.  * Description:   Return pointer to sprite area being used.
  37.  *
  38.  * Parameters:    void
  39.  * Returns:       pointer to sprite area being used.
  40.  * Other Info:    useful for passing params to functions like baricon which
  41.  *                expect to be told sprite area to use.
  42.  *                This fuction has exactly the same functionality as the
  43.  *                RISCOSLib fuction it replaces. Please note that you MUST
  44.  *                use this fuction to discover the address of the sprite
  45.  *                area. Do not assume that it is the same as the address
  46.  *                of the sprite file that you passed to resspr_init().
  47.  *                              ~~~~
  48.  *
  49.  */
  50.  
  51. extern sprite_area *resspr_area(void);
  52.  
  53.  
  54.  
  55. #endif
  56.