ED PAT
Copyright 1994 by m.j.waters
Text updated October 17 1994

DISTRIBUTION:

     This program may be freely distributed in any of the usual channels
for shareware and PD programs as long as the original files are included,
unaltered. 
 
WHAT IT IS:

     ED PAT is designed to help you edit monochrome IMG images for use as
wallpaper in NeoDesk4.  It can load and save images from 16*16 to 80*80
pixels in size (or, if you use a screen resolution of at least 1000
horizontal pixels and 590 vertical pixels, it will allow you to go up to
135*135).  It is not a full-featured drawing tool, but it does have one
feature most drawing programs lack: it lets you see a grid of nine of the
images all together to let you see what the effects are of your editing.

FEATURES:

     GEM Interface.
     Multitasks under Geneva.
     Writes to its mom.
     Loads and saves standard monochrome IMG files.
     Resizes image (adds pixels on, or chops pixels off, top or bottom)
     Shifts image around in the frame, wrapping the data over to the other
          side.
     Rotates and flips tile.
     
WHAT YOU NEED:

     An ST (or TT, etc.) with at least 200KB free RAM.
     ST Hi-res or better.
     Some .IMG files.  You really don't want to start from scratch with
          this little guy.  I have included a few I worked on
          while slaving over ED PAT.

HOW TO USE IT:

     Run ED-PAT.PRG.  After the obligatory dialog box, you will see a
window and a GEM menu bar.  An empty frame in the top-left corner of the
window holds the image at 5X magnification (4X if it's large).  It is empty
now because the image is currently blank.  This is where you will do your
actual mouse drawing.  To the right is a space that will hold nine copies
of the image in a 3*3 grid, like this:

     IMG IMG IMG
     IMG IMG IMG
     IMG IMG IMG

     This will let you see what it really looks like when tiled.

     The major program functions, under the "File" heading, can be selected
with the mouse or by keyboard.

Press:
     L  : to load an .IMG file.
     S  : to save .IMG.
 <Esc>  : to quit the program.

     In addition, there is an "Option" menu heading which contains six
items, also available from the keyboard.  Press:
     W  : to change the width of the image.
     H  : to change the height.
     M  : to enter Move mode, which is how you shift the image around
          in the frame (see below).
     V  : will Flip the tile vertically.
     F  : will flip the tile horizontally.
<Help>  : will display a pretty useless help screen.

EDITING:

     This is a very basic editor.  No line or fill modes, just clicking on
a pixel to toggle it on or off - keep holding it down and you can drag it
around and draw with it.  All on the enlarged image, of course.

MOVE MODE:
     
     When you enter Move mode, you can use the cursor keys - you know, the
ones with the little arrows on them - to shift the image around in the
frame 1 pixel row or column at a time.  Pixels are wrapped - if you shift
up, the top row wraps down to the bottom.  I felt it took too long to
redraw the image after every shift, so instead of seeing the image you just
get a running count of your shifting.
     Pressing <Return> brings you back to the main screen.
     You can type ahead in Move mode.  If you want to shift the image 20
pixels up and 20 pixels left, just press the up arrow 20 times, the left
arrow 20 times, and <Return> - the program will catch up with you and
return you to the main screen.

UNDOCUMENTED FEATURE:

     I added a little function while troubleshooting that I have decided to
leave in.  You probably won't find it useful but hey, it's there if you're
curious.  Pressing 'G' when on the main screen will cause ED PAT to grab an
image, saved in a sort of raw-data format (one byte each for the width and
height and 1 byte for each pixel in the image) from the directory ED PAT
is in.  The file is called BLOCK.DAT.
     Pressing 'P' will save your current image as BLOCK.DAT.

FREEWARE:

     I am releasing ED PAT as "freeware".  Feel free to use it, keep it on
your hard disks and floppies, give it to friends, upload, download, and so
forth.  Just make sure that any copies you distribute have the original,
unaltered files.


HOW TO REACH ME:

        GEnie: myeck.waters
     InterNet: myeck.waters@genie.geis.com
      FIDOnet: myeck waters of 1:107/662.4
     AtariNet: myeck waters of 51:4/4.4

    Snailmail: myeck waters
               886 North Concourse
               Keyport, NJ  07735
               USA

     I am very interested in bug reports and any image that might not
load or save properly.  Please do not hesitate to contact me about them. 
If you're on GEnie or the InterNet, you can e-mail the offending file to
me, which would be very much appreciated.
 
HISTORY:

Version of 94/09/29:
     First release.

Version of 94/10/17:
bugs fixed:    
     Previous Version mis-translated IMGs with 1-byte repeating patterns.
     A few minor things you probably wouldn't have experienced.
new features:
     Handles tiles up to 80*80 - 135*135 on large screens (1000*590 min).
     Real Drawing mode added.
     Rotate and Flip functions added.
other improvements:
     Much faster on many functions, including re-draw, shifting, etc.
     Adjusts for extra-large resolutions.

 
Extra treat for those of you who actually read down this far:
Load CHERYL_1.IMG.  Now use the Vertical Flip function.  Look!  
It's E.T.!  :^)