
 A Programmers Intuition & Graphics Library
  ^ARexx

Version 3.1  Mar. 1992



What is APIG ?  
--------------

APIG is an external AREXX function library which gives
AREXX programs access to many of the resident Amiga Libraries.
APIG (attempts to) provide AREXX programmers with the same tools/functions
that 'C' programmers use to build applications.  As much as possible APIG
stays out of your way as programmer, you should find that most of the
flexibility/functionality afforded to 'C' programmers is available to you
via APIG.  I STRONGLY recommend that you have the latest copy of the
ROM Kernal Includes & Autodocs manual.  The doc file included here only
documents the 'native' APIG functions, and does not document the functions
of the Amiga resident libraries.


Testimonial
-----------

I probably should not admit this but, I have only written 3 or 4 small 
programs in 'C' which use the new features of 2.04, and that was only
to understand how a function worked so that I could incorporate it into
APIG.  ALL of the 2.04 programming I have done has been with AREXX using
the APIG library. (APIG is written entirely in asm, NOT 'C')


Disclaimer
----------

What works and what doesnt ?

I dont know.  Release 2.04 (v37) has a lot in it that I have not played
with in order to determine if it is APIG friendly. I have not used every 
tag and flag defined in 2.04.  I simply rely on the RKM and that the 
Functions will function as documented if given the appropriate parameters
in the appropriate registers.  Of course I could screw that up.



What you have here
------------------

 This is version 3.1 of APIG, most of the 2.04 (v37) features have been
 added.  You will probably notice that the library is larger, almost 
 twice as large as version 1.1.  The reason for this is simple, their
 is a lot more code. In addition APIG "includes" more than 600 global
 constants/flags.  On top of that, APIG 3.1 was assembled using large 
 code/data, where as version 1.1 used small code/data, it makes up a
 difference of about 5K.  Besides, you all have big spacious hard disks
 anyway so Im not gonna worry about it.


 This archive should contain the following files

    apig.library        version 3.1
                        (place this in your LIBS: directory)

    iff.library         C. Weber's IFF library version 18.5
                        (place this in your LIBS: directory)

    RexxRMF.library     cuz the earlier version had a bug
                        no docs are included, I assume you have'em.
                        if you do not have the docs, check with your
                        local PD software library (FF559).
                        (place this in your LIBS: directory)
                         


    apig.doc            <---- PRINT & READ THIS !!!  (50+ pages)
    apig_errorcodes.txt
    readme.txt
    old_release_info
    new_release_info

    bitmap              a small iff
    bitmap2             a small iff
    uparrow.bitmap      a small iff
    downarrow.bitmap    a small iff
    octalbuttonbitmap   a small iff
    checkedbuttonbitmap a small iff
    gorilla             a iff picture (LORES)
    robotarm            a iff picture (HIRES)
    almaden             a iff picture (HAM)
    
    req6bitmap          a small iff

    and the following example Rexx pgms

Old examples from earlier distribution:

    e1_window.rexx
    e2_window.rexx      
    e3_drawing.rexx     
    e4_areafills.rexx   
    e5_menus.rexx       
    e6_requesters.rexx  
    e7_images.rexx      
    e7_images2.rexx      
    e8_blits.rexx       
    e9_layers.rexx      
    e10_superwindow.rexx 
    e11_followmouse.rexx
    e12_gadgets.rexx    
    e13_fonts.rexx      
    e14_iffintoscr.rexx 
    e15_borders.rexx 
    e16_pointers.rexx 
    e17_execlist.rexx 
    e18_cedparody.rexx
    e19_preferences.rexx

New examples for version 3.1 

    aslfile1.rexx
    aslfile2.rexx
    aslfile3.rexx
    aslfile4.rexx
    aslfont1.rexx
    aslfont2.rexx
    bitmapscale.rexx
    bitmapscaleiff.rexx
    boopsi_images.rexx
    boopsi_gadgets.rexx
    easyrequest1.rexx
    easyrequest2.rexx
    easyrequest3.rexx
    easyrequest4.rexx
    gadtools1.rexx
    gadtools2.rexx
    gadtools3.rexx
    gadtools4.rexx
    graphicsdb.rexx
    newmenus1.rexx
    newmenus2.rexx
    newmenus3.rexx
    newscreen0.rexx
    util1.rexx
    util2.rexx
    util3.rexx
    util4.rexx
    util5.rexx
    wintaglist0.rexx
    wintaglist1.rexx


   addressbook.rexx  (uses RexxRMF.library & apig.library)

 ---------------------------------------------------------------------------

 If you have comments, suggestions, complaints, bug reports, etc. I can be
 reached on PORTAL. I also make a charitable contribution to COMPUSERVE
 every month but rarely ever visit there, my id is 72460,1754.

 Let me know what you think,   Ronnie E. Kelly  (Mar 1992)


