home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 458.lha / Tapestry_v2.0 / Tapestry.doc < prev    next >
Text File  |  1991-01-03  |  4KB  |  95 lines
  1.  
  2.                          Tapestry -- Version 2
  3.            Copyright 1989 Joe Hitchens, All Rights Reserved.
  4.  
  5.           Permission is given to distribute this software and
  6.         attached data files freely, so long as the entire package
  7.        is left intact and unaltered, and no profit is made from the
  8.                               transaction.
  9.  
  10.  
  11.  
  12.   Tapestry is a little utility for attaching a pretty picture (or ugly if
  13. you prefer) to your normal workbench display.  Any 1 bitplane (2 color) IFF
  14. picture can be loaded, though you may want to use one which has roughly the
  15. same dimenstions and pixel aspect ratio as your Workbench screen.
  16.  
  17.   Tapestry (Version 2) is only usable from the CLI.  I normally have it
  18. run as a background process from my startup-sequence.  Usage is as follows:
  19.  
  20.       1> tapestry picfile [ picfile2 picfile3 ... ]
  21.             or
  22.       1> run tapestry picfile [ picfile2 picfile3 ... ]
  23.             or
  24.       1> run >nil: tapestry picfile [ picfile2 picfile3 ... ]
  25.  
  26.   At least one picture filename parameter is required.  If more than one
  27. picture filename is provided, Tapestry will choose one of the filenames
  28. at random.
  29.   If the first usage is used, a ^C will exit tapestry.  If the second or
  30. third usage is used, the BREAK command can be used to exit tapestry.
  31.   If the third usage is used, and you are working under Version 1.3 of
  32. WorkBench, the CLI can be closed after Tapestry has been 'run'.
  33.   If no usage is used, ^C or BREAK will not be necessary.
  34.  
  35.   The WorkBench screen will not close when Tapestry is running.  To save
  36. memory by closing the WorkBench screen, you will have to BREAK Tapestry
  37. first.
  38.  
  39.   Possible return codes for tapestry are as follows:
  40.  
  41.      0   Everything went fine.  No problem.
  42.      1   Allocation of the display memory failed.
  43.      2   There was a problem loading the IFF picture file.
  44.          Either the file was not found, or not a readable IFF ILBM, or some
  45.          other such nonsense.
  46.      3   The Intuition and Graphics libraries couldn't be opened.
  47.      4   The WorkBench screen couldn't be found.
  48.      5   There is something odd about the WorkBench screen.
  49.          If the WB screen has more than 2 bitplanes (4 colors), or if
  50.          Tapestry is already running, or you already have a DUALPF, HAM
  51.          or EXTRA_HALFBRITE WorkBench (How would it be?), This will occur.
  52.      6   An attempt was made to run tapestry from an icon.
  53.          This is not supported yet.
  54.      7   Tapestry couldn't open the invisible ID window.
  55.          This is done so that calls to CloseWorkBench() will fail.
  56.  
  57.   Tapestry eats up a certain amount of CHIP memory, in addition to the
  58. program, stack and data.  This is how much:
  59.      Normal non-interlace WorkBench         16K
  60.      Normal interlace WorkBench             32K
  61.   Also, if your WorkBench has overscan, even more will be consumed.
  62.  
  63.   The picture files included with Tapestry and listed below were all created
  64. by me and are "Copyright Joe Hitchens".  They are, however, part of the
  65. package as described at the top of this document.
  66. entire package.  They are:
  67.      Lyssette       This is the only LARGE format picture.  Use it if
  68.                     you have an interlaced WorkBench.
  69.      Lyssette.200   This is a 200 line tall version for normal WorkBench's.
  70.      Lion
  71.      Rects
  72.      Window
  73.  
  74.   Send comments, suggestions to me.  I'll find the lovely, vivacious and
  75. available bachelorettes myself:
  76.          Name : Joe Hitchens
  77.          Phone: (801) 292-2190
  78.          UUCP : joe@vixen.uucp
  79.  
  80. j.h.
  81. March 18, 1989
  82. ---------------------------------------------------------------------------
  83.   
  84.   Look for these features in future versions of Tapestry.
  85.  
  86.   * 2 bitplane images (will use still more CHIP memory, beware)
  87.   * Repeating images.  This will allow a small brush ILBM to be used and
  88.     repeated in a tile pattern to fill the entire screen.
  89.   * Icon launch.
  90.   * Animating tapestries. :-)
  91.  
  92.  
  93.  
  94.  
  95.