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. :-)