home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD1.img / d1xx / d105 / ipo2c / ipo2c.doc < prev    next >
Text File  |  1987-10-25  |  3KB  |  99 lines
  1. /**********************************************************************/
  2.                        INTUITION POINTER TO C
  3.                             ( IPo2C )
  4.                         By: Alex Livshits
  5.                             20-Sep-87
  6. /**********************************************************************/
  7.  
  8. IMPORTANT
  9. ---------
  10.     The following files are placed in Public Domain by the author:
  11.  
  12.         - IPo2C              executable,
  13.         - IPo2C.c            source,
  14.         - inputhandler.c     source,
  15.         - IPo2C.o            object,
  16.         - inputhandler.o     object,
  17.         - handlerinterface.o object,
  18.         - link               BLINK 'with' file
  19.         - IPo2C.doc          this file
  20.  
  21.     ON CONDITION that they are distributed all together and for
  22.     NON-COMMERCIAL purposes only.
  23.  
  24.  
  25.  
  26. WHAT IT DOES
  27. ------------
  28.  
  29.     This small utility writes to a file the C-language
  30.     definition of the CURRENT intuition pointer. The data in the file
  31.     created by IPo2C is ready to be used by SetPointer().
  32.     I wrote this utility because I wanted to include in my programs
  33.     the intuition ZZz-pointer. It worked fine for this one and for any
  34.     other custom pointer I tried. By the way, IPo2C allows you to use
  35.     Preference's Set Pointer option as an editor for your own pointers.
  36.  
  37.  
  38. HOW IT WORKS
  39. ------------
  40.     IPo2C waits in the background until the keys ALT-P are pressed together.
  41.     Then, it grabs the pointer sprite definition in IntuitionBase
  42.     (APointer etc..) and writes it to the specified file in C-language
  43.     format.
  44.  
  45.  
  46. HOW TO USE IT
  47. -------------
  48.     Just RUN IPo2C <file name>. When the pointer you want appears, press
  49.     ALT and P keys together. IPo2C will write out to <file name> this
  50.     pointer definition in C format. If file <file name> already exists,
  51.     the new data will be appended to the end of <file name>. You can press
  52.     ALT-P several times, each time new data will be apppended to
  53.     <file name>. Press ALT and F keys together to stop IPo2C.
  54.  
  55.     Compile or #INCLUDE the file with your code. Use SetPointer() function
  56.     in intuition.library to change appearence of your sprite. The data
  57.     format created by IPo2C especially designed to be used as the parameters
  58.     for SetPointer() function.
  59.  
  60.     Don't forget to place the pointer sprite definition into CHIP memory.
  61.     I use ATOM <infile.o> <outfile.o> -pc -cdb.
  62.  
  63.  
  64. TO COMPILE
  65. ----------
  66.     You MUST use Lattice C (3.10 or 3.03) to compile IPo2C.
  67.     I'm reasonably confident that it will NOT compile correctly with Manx C.
  68.  
  69.     The steps are:
  70.         Compile IPo2C.c and  inputhandler.c as follows:
  71.  
  72.         LC1 -ccws -oram: <file>
  73.         LC2 -v -oRAM: ram:<file>
  74.         copy ram:<file>.o to <file>.o
  75.  
  76.  
  77.         Assembly handlerinterface.asm
  78.  
  79.  
  80.         Link them all:
  81.  
  82.         BLINK with link
  83.         (link file included)
  84.  
  85.  
  86. CONTACT
  87. -------
  88.         Alex Livshits,
  89.         15 rue Durantin,
  90.         75018 Paris,
  91.         FRANCE
  92.  
  93.  
  94.         Enjoy!
  95.  
  96.  
  97.  
  98.  
  99.