*********************************************************
*                         CEKANI                        *
*           .ANI File Loader Library to DJGPP.          *
*      Copyright (c) 2000 by Cristian EmmericK (CEK)    *
*                E-mail: cek@mailbr.com.br              *
*                   ICQ(UIN): 52438873                  *
*                http://cekpage.tripod.com              *
*********************************************************


***********************
     INTRODUCTION
***********************

	CEKANI is a .ANI File Loader Library to DJGPP,
created by Cristian EmmericK (CEK) in Sunday, August 6,
2000. It needs of Allegro Library, DJGPP and BGUI to com-
pile. if you want to use another library, you can change
the source of CEKANI however if you will pass on the li-
brary with your changes, notify me before. 
	


***********************
       COPYRIGHT
***********************

	CEKANI is FREEWARE. You can use it in your pro-
gram, modify (with the requirements above) and you don
't have to pay anything. But I would be grateful if you
mentioned CEKANI in the credits. :)
  

                     ** DISCLAIMER **
 " I, Cristian EmmericK, do not accept responsibility for
 any effects, adverse or otherwise, that this library may
 have on you, your computer, or elsewhere and anything
 else that you can think of. Use it at your own risk."
                     ** DISCLAIMER **


***********************
INSTALLING
***********************

	To intall CEKANI you have to unzip the file:
CEKANI.ZIP, into any directory you want. 
	The file ANIVIEW.ZIP is the BINARY of a CEKANI's
tool, to install it you'll have to do the same as above.

	
***********************
         FILES
***********************

	The CEKANI files are:

\SRC\LOAD_ANI.C         - .ANI Loader Source Code
\SRC\CEKANI.H           - .ANI Loader Include
\EXAMPLES\CMASTREE.ANI  - .ANI File
\EXAMPLES\DOGFIGHT.ANI  - .ANI File
\EXAMPLES\FRANK.ANI     - .ANI File
\EXAMPLES\EX01.C        - Example 01
\EXAMPLES\EX02.C        - Example 02
\LIB\LIBANI.A           - CEKANI Library
\OBJ\LOAD_ANI.O         - Load_ani Object

 


***********************
       COMPILING
***********************

	To compile, you have to enter in the directory
that CEKANI were unzipped and type:
  
  MAKE ALL       - Compile the library and the examples
  MAKE INSTALL   - Install CEKANI to your DJGPP directory
  MAKE CLEAN     - Delete the compiled examples and the
                   library
  MAKE UNINSTALL - Uninstall the CEKANI from your DJGPP
                   directory
  MAKE EXAMPLES  - Compile the examples




***********************
         USING
***********************

	When you make a program that uses CEKANI, you ha-
ve to include the file CEKANI.H and link the program with
LIBANI.A. 
        You can do this like:


  - Paste this line above in the begginning of your pro-
gram's code:

  #include <cekani.h>

  
  - When compiled in the command line or makefiles add   
"-lani" to the end of gcc command, like:

  gcc myprg.c -o myprg.exe -lani


  - If you are using RHIDE, go to the Options/Libraries
menu, type 'ani' into any empty space (after "alleg"),
and make sure the box next to it is checked.




***********************
       FUNCTIONS
***********************

	Here is the list of all functions and variables
of CEKANI library:

struct CURSOR;
CURSOR *load_ani(unsigned char *filename)
unsigned char *cursor_getname(CURSOR *cursor)
unsigned char *cursor_getauthor(CURSOR *cursor)
unsigned long cursor_getsize(CURSOR *cursor)
int cursor_width(CURSOR *cursor)
int cursor_height(CURSOR *cursor)
int cursor_frames(CURSOR *cursor)
int cursor_steps(CURSOR *cursor)
int cursor_getcolordepth(CURSOR *cursor)
int cursor_rate(CURSOR *cursor, unsigned long number)
int cursor_seq(CURSOR *cursor, unsigned long number)
int cursor_xhotspot(CURSOR *cursor, unsigned long number)
int cursor_yhotspot(CURSOR *cursor, unsigned long number)
BITMAP *cursor_image(CURSOR *cursor, unsigned long number
)
PALLETE *cursor_pallete(CURSOR *cursor, unsigned long
number)
void cursor_blit(BITMAP *dest, CURSOR *cursor, unsigned
long number, unsigned long x, unsigned long y)



***********************
       ANIVIEWER
***********************

	ANIViewer is a CEKANI library's tool. It converts
the .ANI file's frames to .BMP files. And it saves the
.ANI information.

  -- EXPORT Options --
 
	ANIViewer gives you the option to export a .ANI
objects like its frames to .BMP files and its info to a
.TXT file.                  
	The option "ALL" will exports all the .ANI frames
to .BMP files like: ANIM0000.BMP,  ANIM0001.BMP and so
on.  But you  have to give the first four characters, and
be careful because it won't tell you if such name already
exist and it will overwrite them  without asking!!!!
	The option "FRAME" will export only the current
frame.          
  	The option "INFO" will exports the .ANI info like
its sequence, their frame's rate and so on.




***********************
        CREDITS
***********************

  PROGRAMMING:

  Cristian EmmericK (CEK)


  SPECIAL THANKS TO:

  DJ Delorie (DJGPP)  
  Shawn Hargreaves (ALLEGRO)
  Dan Huizenga (BGUI)




***********************
        CONTACT
***********************

  You can contact me for any question at:

  URL: http://cekpage.tripod.com
  E-mail: cek@mailbr.com.br
  ICQ(UIN): 52438873