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

             GEngine shared library version 0.1
                (c)2001-2002 by Pablo Roldan

note: this archive replaces geavl.lzh (avl trees in PCQ Pascal)
      which were not working at all (I prefer not to talk about it).


1. The library
   -----------

   This library was thought at a first moment to gather all de graphic
   and GUI routines that I had written. Later on, this become into a
   library that allow AmigaOS1.3 users to create screen and font
   sensitive GUIs. Therefore allowing 1.3 programs to show a correct
   GUI in  both 1.3 and 2.0+ systems.

   Although this goal has not been achieved at the time,
   the library incorporates:

   - Colour matching routines, as GetBestPen, that returns the closest
     palette entry to the passed RGB value.

   - AVL trees routines, search, insert & delete criteria
     customizable via hooks.

   - Memory pools. Auto-expand/shrink in user defined chunks

   - Object oriented system. A copy of BOOPSI, currently only the root
     class implemented in the library.

   - Taglists routines, also a copy of the ones in utility.library

2. The pascal sources
   ------------------

   The pascal source include some test programs as well as gengine_d.i,
   a include file containing the following:

   - A custom slider gadget, capable of displaying text inside the knob
     just like the MUI ones. Also is font sensitive.
     Note: The current implementation has problems with visualprefs.

   - A scalable & rotable vector graphics engine.

   - A 'event handler', not the best one, but does it's job until now.

   - A pop-up menu, font sensitive.

   The test programs:

   - testpop.p : This is the oldest one, it demoes the sliders,
     vectors, pop-up menus and the color matching routines in
     the library.

   - test1.p : Test the color matching routines, opens 2 windows,
     the 1st contains 3 sliders, one for each primary color, at the
     right is a rectangle filled of the nearest color in the palette
     that matched the values on the sliders.
     The 2nd window display the standard GUI colors, DrawInfo like.

   - test2.p : Test the scalable-rotable vector engine. Again the
     program opens 2 windows, one contains a vector shape, the second
     2 sliders that controls the angle and size of the vector shape
     respectively.

   - test3.p : Test AVL trees, only text displayed on
     the CLI window. This is not the best test, as I discover later.

   - testtag.p : Test both the taglist routines and class adding and
     removing.

   - testiclass.p : The last one, test a pascal-implemented imageclass,
     this time 4 sliders allows you to move an image object (currently
     only a box). The image moves by using the methods GIM_ERASE,
     GM_SET and GM_DRAW.

3. The pascal includes
   -------------------

   These are the PCQ pascal includes to use the library with this
   compiler.
   Some of these have pascal source of some routines that have not been
   yet added to the shared library.

4. Compiling
   ---------

   The library has been written entirely in assembler, I use
   phxass+blink to compile and link it.

   To compile the pascal test programs you will need the PCQ pascal
   compiler, you will also need to compile gengine/asm/gengine_pcq.asm
   to gengine/asm/gengine_pcq.lib (glue routines) and 
   gengine/test/callhook.asm to gengine/asm/callhook.o (hook routines).
   Then link the object code that created the pascal compiler with this
   two files (and offcourse the pascal library).

5. Compatibility
   -------------

   Only an early version of the library has been tested on my real
   Amiga 500. The entire development of the library has been doned on
   a PeeCee running WinUAE.

   However, I has tested the library under various kickstarts and 
   workbench configurations, and only found a visual problem with the
   custom slider gadgets and the program visualprefs, this can be fixed
   by making the slider BORDERLESS and letting it to refresh it's
   border.

6. The future
   ----------

   Currently the development is temporarily stopped, as I'm busy with
   other GUI/Gfx related project. When I finish it (or get bored of it,
   whatever happens first) I will continue developing the library.

   Anyway... the future will bring us:

   - fixed color matching routines to use the same API that the
     included in kickstart v39+.

   - further development will be done in C
     (rewritting de Pascal code into asm is a REALLY slow process)

   - code will take more advantage of newer OS versions.

   - built in image class (among others)

   - finished gadget class and vector graphics engine converted into a
     built in class.

   - better docs.

   - nicer test programs.

   - and a heap of things more...

7. Distribution
   ------------

   The contents of this archive are all FREEWARE, you can use the
   library and the source codes as you want.
   If you find usefull some of this, write a program that uses the
   library or, for some obscure reason you want to continue developing
   the library, pleas e-mail me at the address listed below.

8. Contact
   -------

   You can reach me via e-mail at:
 
     pdroldan@yahoo.com

   or by snail mail:

     Rivadavia 249 dto 6B
     (9100) Trelew
     Pcia. del Chubut
     Argentina

   My web page:

     http://www.geocities.com/soft154i/index.htm

   As you can see at my web page I'm very insterested in old 8/16 bits
   computers, so any donation, either hardware, software or
   documentation *is* VERY welcome.

9. Disclaimer
   ---------

   No warranties of any kind are made as to the functionality of this
   library and programs. You are using it at YOUR own risk.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[MS-DOS]                   258     511  50.5% -lh5- f485 Sep 22  2001 gengine/test/callhook.asm
[MS-DOS]                 13630   43863  31.1% -lh5- ea91 Jan 26  2002 gengine/test/gengine_d.i
[MS-DOS]                   984    2902  33.9% -lh5- 6faa Aug 30  2001 gengine/test/getags.i
[MS-DOS]                  1410    3519  40.1% -lh5- f601 Jul 29  2001 gengine/test/test1.p
[MS-DOS]                  1495    3861  38.7% -lh5- d713 Aug 14  2001 gengine/test/test2.p
[MS-DOS]                  1146    3801  30.1% -lh5- 65e0 Dec 10  2001 gengine/test/test3.p
[MS-DOS]                  2295    6419  35.8% -lh5- 174d Feb  7  2002 gengine/test/testiclass.p
[MS-DOS]                  1516    3844  39.4% -lh5- 7836 Sep  1  2001 gengine/test/testpop.p
[MS-DOS]                  1030    3275  31.5% -lh5- 5b99 Dec 28  2001 gengine/test/testtag.p
[MS-DOS]                   420    1166  36.0% -lh5- a486 Oct  8  2001 gengine/include/libraries/ge_avl.i
[MS-DOS]                  1937    5333  36.3% -lh5- f60f Feb  7  2002 gengine/include/libraries/ge_classes.i
[MS-DOS]                  5432   17383  31.2% -lh5- db12 Feb 26  2002 gengine/include/libraries/ge_gadgetclass.i
[MS-DOS]                  2876    9641  29.8% -lh5- 659b Feb 12  2002 gengine/include/libraries/ge_imageclass.i
[MS-DOS]                  1142    2950  38.7% -lh5- b73e Feb 26  2002 gengine/include/libraries/ge_intui.i
[MS-DOS]                   503    1158  43.4% -lh5- 3435 Oct 31  2001 gengine/include/libraries/ge_mempools.i
[MS-DOS]                  1783    5092  35.0% -lh5- e60c Jan 26  2002 gengine/include/libraries/ge_tagitem.i
[MS-DOS]                  1085    2739  39.6% -lh5- 4aa6 Feb  8  2002 gengine/include/libraries/gengine.i
[MS-DOS]                   210     378  55.6% -lh5- 9bd9 Dec  3  2001 gengine/include/utils/ge_hooks.i
[MS-DOS]                  2745   12803  21.4% -lh5- ddde Feb 15  2002 gengine/asm/ge_avl.i
[MS-DOS]                  1410    5252  26.8% -lh5- c65a Feb  7  2002 gengine/asm/ge_classes.i
[MS-DOS]                  1709    7060  24.2% -lh5- 7fc4 Feb 12  2002 gengine/asm/ge_mempools.i
[MS-DOS]                   509    1335  38.1% -lh5- 13d4 Jan  1  2002 gengine/asm/ge_tagitem.i
[MS-DOS]                  1645    4100  40.1% -lh5- f5ab Feb  8  2002 gengine/asm/gengine.i
[MS-DOS]                  9388   34098  27.5% -lh5- f642 Feb 12  2002 gengine/asm/gengine.library.asm
[MS-DOS]                  1442    4164  34.6% -lh5- 8123 Oct 16  2001 gengine/asm/gengine_lib.i
[MS-DOS]                  1759   13149  13.4% -lh5- 4a37 Feb  7  2002 gengine/asm/gengine_pcq.asm
[MS-DOS]                   393    1071  36.7% -lh5- ef78 Oct 27  2001 gengine/asm/gengine_rev.i
[MS-DOS]                   656    1976  33.2% -lh5- 9fe4 Feb  8  2002 gengine/asm/genginebase.i
[MS-DOS]                   156     280  55.7% -lh5- 1590 Jul 10  2001 gengine/asm/graphicsp.i
[MS-DOS]                   162     281  57.7% -lh5- 483f Sep 21  2001 gengine/asm/hook.i
[MS-DOS]                  1254    2883  43.5% -lh5- 69ce May 18  2000 gengine/asm/asmsupp.i
[MS-DOS]                  4284    6776  63.2% -lh5- 815b Feb 15  2002 gengine/libs/gengine.library
[MS-DOS]                  2654    6163  43.1% -lh5- 79f3 May 12  2002 gengine.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        33 files   69318  219226  31.6%            May 19  2002