Short:        Places a 2 color picture on the Workbench backdrop.
Uploader:     fintaeph io org (Chris Poirier)
Type:         util/wb
Architecture: m68k-amigaos


                         Tapestry -- Version 2
           Copyright 1989 Joe Hitchens, All Rights Reserved.

          Permission is given to distribute this software and
        attached data files freely, so long as the entire package
       is left intact and unaltered, and no profit is made from the
                              transaction.



  Tapestry is a little utility for attaching a pretty picture (or ugly if
you prefer) to your normal workbench display.  Any 1 bitplane (2 color) IFF
picture can be loaded, though you may want to use one which has roughly the
same dimenstions and pixel aspect ratio as your Workbench screen.

  Tapestry (Version 2) is only usable from the CLI.  I normally have it
run as a background process from my startup-sequence.  Usage is as follows:

      1> tapestry picfile [ picfile2 picfile3 ... ]
            or
      1> run tapestry picfile [ picfile2 picfile3 ... ]
            or
      1> run >nil: tapestry picfile [ picfile2 picfile3 ... ]

  At least one picture filename parameter is required.  If more than one
picture filename is provided, Tapestry will choose one of the filenames
at random.
  If the first usage is used, a ^C will exit tapestry.  If the second or
third usage is used, the BREAK command can be used to exit tapestry.
  If the third usage is used, and you are working under Version 1.3 of
WorkBench, the CLI can be closed after Tapestry has been 'run'.
  If no usage is used, ^C or BREAK will not be necessary.

  The WorkBench screen will not close when Tapestry is running.  To save
memory by closing the WorkBench screen, you will have to BREAK Tapestry
first.
 
  Possible return codes for tapestry are as follows:

     0   Everything went fine.  No problem.
     1   Allocation of the display memory failed.
     2   There was a problem loading the IFF picture file.
         Either the file was not found, or not a readable IFF ILBM, or some
         other such nonsense.
     3   The Intuition and Graphics libraries couldn't be opened.
     4   The WorkBench screen couldn't be found.
     5   There is something odd about the WorkBench screen.
         If the WB screen has more than 2 bitplanes (4 colors), or if
         Tapestry is already running, or you already have a DUALPF, HAM
         or EXTRA_HALFBRITE WorkBench (How would it be?), This will occur.
     6   An attempt was made to run tapestry from an icon.
         This is not supported yet.
     7   Tapestry couldn't open the invisible ID window.
         This is done so that calls to CloseWorkBench() will fail.

  Tapestry eats up a certain amount of CHIP memory, in addition to the
program, stack and data.  This is how much:
     Normal non-interlace WorkBench         16K
	 Normal interlace WorkBench             32K
  Also, if your WorkBench has overscan, even more will be consumed.

  The picture files included with Tapestry and listed below were all created
by me and are "Copyright Joe Hitchens".  They are, however, part of the
package as described at the top of this document.
entire package.  They are:
     Lyssette       This is the only LARGE format picture.  Use it if
                    you have an interlaced WorkBench.
	 Lyssette.200   This is a 200 line tall version for normal WorkBench's.
	 Lion
	 Rects
	 Window

  Send comments, suggestions to me.  I'll find the lovely, vivacious and
available bachelorettes myself:
         Name : Joe Hitchens
         Phone: (801) 292-2190
         UUCP : joe@vixen.uucp

j.h.
March 18, 1989
---------------------------------------------------------------------------
  
  Look for these features in future versions of Tapestry.

  * 2 bitplane images (will use still more CHIP memory, beware)
  * Repeating images.  This will allow a small brush ILBM to be used and
    repeated in a tile pattern to fill the entire screen.
  * Icon launch.
  * Animating tapestries. :-)