padCanvas v2.02 Documentation       November 28, 1996
-----------------------

History:
--------

v2.02
   -- Complete rewrite of earlier version. This version does not use any of
      the IFX GUI options. It brings up it's own window on the "IMAGEFX_SCREEN".
      Also requires IFX v2.6 due to a deficiency in the earlier version of the
      roll command.

--------

Requirements:

Requires IFX v2.6. It expects to find a public screen named "IMAGEFX_SCREEN".
Make sure that it exists; it might not if you run IFX on the WorkBench. If you
aren't running on a big screen (800x600), padCanvas will take up a relatively
large portion of your screen, so a graphics card is recommended.

--------

Description:

padCanvas allows you to 'pad' your image to a larger size by adding area
around it, similar to what PhotoShop does. You can center the original image
or place it flush to any of the sides (top, left-center, bottom, etc.).
This is an enhanced version of the original. You can either manually enter
the final canvas size or you can click on 'short-cut' gadgets that will enter
values that are 1-1/2 or 2 times the original. There is also a gadget that will
match the swap buffer if it exists. If the swap exists, its size is recorded
on the padCanvas window as a reference. A NEW BONUS feature lets you chose
the background color for the expanded canvas with a custom RGB color
requester that comes with padCanvas; otherwise the background is the default
black.


***********************************

Included:

ImageFx:rexx/
   launchPadCanvas.ifx   -- use to start padCanvas.ifx

ImageFx:rexx/ext_tools/
   padCanvas.ifx         -- must be launched with 'launchPadCanvas.ifx'
   colorSelector.ifx     -- RGB color selector, launched padCanvas.ifx

   Place these in the 'ext_tools' subdirectory of 'ImageFx:rexx/'.
   Do not place them out in the open with the other '.ifx' files.

libs:
   rexxsupport.library
   rexxmathlib.library
   rexxarplib.library
   rexxtricks.library

   Place these libraries in your assigned LIBS: directory.

c:
   qsort

   A sorting utility necessary for some functions

***********************************

Caveats:

Always quit padCanvas before you quit ImageFX or something will hang or crash.
Occasionly IFX will hang when quitting padCanvas. I'm not sure why, except there
seems to be some conflict between windows on the IFX screen. Be sure to save
the buffers before quitting padCanvas.

***********************************

How it works:

1) Load an image into the main buffer.

2) Select 'Rexx' and select 'launchPadCanvas.ifx'.

3) The padCanvas window will appear on the IFX screen.

4) Place the padCanvas window where you want, preferably away from the image.
   The gadgets are should be self-explanatory.

5) Save your buffers before you quit padCanvas.

************************************

Ola Eric Olsson
email: oeolsson@tmisnet.com
November 28, 1996