home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d128 / dropcloth.lha / DropCloth / readme < prev    next >
Text File  |  1988-01-02  |  7KB  |  146 lines
  1.                              DropCloth
  2.                             Version 2.2
  3.                           By Eric Lavitsky
  4.                           10-November-1987
  5.                      (C) 1987 by Eric Lavitsky
  6.  
  7.  
  8. DropCloth lets you place a pattern, a 2 bitplane IFF image or a
  9. combination of a pattern and image into your Amiga's WorkBench
  10. backdrop.
  11.  
  12. To use DropCloth from the CLI, type:
  13.  
  14.         1>dropcloth [-d number] [-i filename]
  15.  
  16. where "number" is between 0 and 64 inclusive and "filename" is a
  17. valid 2 bitplane (4 color) IFF image file. The number specifies
  18. the intensity of the pattern used for the backdrop, 0 will render
  19. a clear pattern    into the display, while    64 will render a solid
  20. backdrop. If you don't specify a pattern, DropCloth will default
  21. to 0, a clear pattern. To remove DropCloth and any pattern or image
  22. it has rendered into the backdrop, simply run DropCloth a second
  23. time. It is generally recommended that DropCloth be "RUN" or
  24. "RUNBACKED" from the CLI.
  25.  
  26. To use DropCloth from the WorkBench:
  27.  
  28.         Double click directly on the DropCloth Icon or
  29.         Double click on an IFF image Icon whose default
  30.         tool points to DropCloth.
  31.  
  32. The image must be an IFF image (ILBM). Change it's default tool to
  33. point to DropCloth. Assuming DropCloth resides in the C: directory,
  34. select the image icon and then select "Info" from the WorkBench menu.
  35. The next to last field in the Icon is the default tool:
  36.                   ____________________________
  37.         DEFAULT TOOL  | C:DropCloth              |
  38.                   ----------------------------
  39.  
  40. If your image does not have an Icon, you may create an Icon for it by
  41. copying one of the Icons normally created by DPaint. If you want 
  42. DropCloth to render a pattern, specify the pattern you want in the
  43. ToolTypes of the DropCloth Icon (if you are rendering a pattern only)
  44. or in the ToolTypes of the image Icon (if you are rendering an image
  45. along with a pattern). Again, select the Icon in question, pull down
  46. "Info" from the WorkBench menu, go down to the ToolTypes field, select
  47. "ADD", click in the ToolTypes text gadget and enter:
  48.         _________________________________
  49.         |PATTERN=n            |
  50.         ---------------------------------
  51.  
  52. where n is again a number between 0 and 64 inclusive.
  53. To remove dropcloth and any pattern or image it has rendered into the
  54. WorkBench backdrop, simply run DropCloth a second time by double
  55. clicking on it's Icon.
  56.  
  57. - Features and Limitations
  58.     - Current version wants 640x200x2 images - patterns work fine in any
  59.     size screen including "morerowed" (overscan) screens.
  60.     - We make a few assumptions about the IFF image that limit us to
  61.     accepting only 2 bitplane images.
  62.     - The fuel gauge in main disk windows is not properly refreshed by
  63.     RefreshWindowFrame() ... (sigh)
  64.     - Requires V1.2 or greater of KickStart to run
  65.  
  66. - Future considerations
  67.     - We could give an option to add bitplanes to the workbench screen for
  68.     images > 2 bitplanes or try and map colors to 2 bitplanes. This would
  69.     slow things down and eat lots of CHIP memory (ugh!).
  70.  
  71. HISTORY
  72.  
  73. - How it started
  74.     - When I first got my Amiga way back in August '85, I was
  75. dissapointed to find that I couldn't put an image or pattern in my
  76. backdrop like we could on the AI workstations and Macintoshes at Rutgers.
  77.     - One day, someone posted on the net that at a gathering in the
  78. Apple Computer cafeteria one day, Andy Hertzfeld, of Macintosh design
  79. team fame, was quoted as saying that the Amiga wasn't a serious machine:
  80. "C'mon,    a user interface with windows the same color as the screen?!!!".
  81. I vowed that one day, I'd show him! :-)
  82.     - One day, in one of our usual hacking sessions, Perry Kivolowitz
  83. and I started fooling with the layers library to see what we could make it
  84. do.  It was here we discovered that the WorkBench backdrop was a backdrop
  85. borderless window and that we could look at it as a layer.
  86.     - On Sunday February 8th, 1987, Perry and I decided to take a trip
  87. over to Rutgers (just 10 minutes away) to take a look at how the Suns and 
  88. Macintoshes allowed you to change backdrop patterns and images.
  89.     - That same night we went to his apartment to begin writing our
  90. own backdrop enhancer for the Amiga. At    eight o'clock the next morning we
  91. had DropCloth in what essentially became release 1.0 (it was heavily
  92. cleaned up first :-)
  93.     - We had hoped that DropCloth would be part of a complete package
  94. of tools and enhancments for the Amiga,    but soon decided that it couldn't
  95. be supported well since it could degrade the preformance of the workbench
  96. (notice the delay incurred from clicking a disk icon to it's being available
  97. to be dragged). So, the project was shelved in favor of other things.
  98.     - Suddenly, we saw other people on Usenet attempting the very same
  99. thing (doesn't it always happen this way, Amiga hackers are always on the
  100. same wavelength). We posted the V1.0 binary so people could have patterns
  101. at last. The V1.0 release was also placed on Fish Disk 59
  102.     - About two weeks before the first AmiExpo in New York,    Perry and 
  103. I were talking about DropCloth again. He asked me if we really couldn't
  104. put an image into the backdrop (at one point we thought we couldn't for
  105. some silly reason). A large rock promptly hit me in the back of the head
  106. and voila! (Get the source to see how it's done).
  107.     - Perry's wrote the initial code for rendering more than just a 
  108. pattern into the backdrop for a nice little demo at AmiExpo. I took his
  109. prototype and extended it to allow all IFF images and put in WorkBench
  110. support as well.
  111.  
  112. - What it does
  113.     - Things we had to realize about the workbench:
  114.         - The Workbench renders it's icons into a 
  115.         backdrop borderless window.
  116.         - When an icon is moved SetRast() is called to
  117.         clear the layer and all the icons are redrawn.
  118.         This is fairly fast, but destroys anything you
  119.         render yourself into the backdrop.
  120.     - So, get the source to see how it's done! (plug, plug :-)
  121.  
  122. Thanks to:
  123.     Perry Kivolowitz    - Spurring me on, helping fix my bugs
  124.     Jon Trudel        - The DropCloth Icon
  125.     Andy Hertzfeld        - The original fire (
  126.  
  127.  
  128. Copyright and Shareware Notice:
  129.  
  130. DropCloth is Copyright 1987 by Eric Lavitsky. DropCloth is a shareware
  131. product. If you feel this product enhances your environment, please
  132. send a contribution to:
  133.  
  134.     Eric Lavitsky
  135.     34 Maplehurst Ln.
  136.     Piscatway, NJ 08854
  137.  
  138. Keep the shareware concept alive! Suggested donation is $10. Donations 
  139. of $15 or more will yield a disk replete with the source code to the
  140. latest version of DropCloth ($20 would be greatly appreciated). The 
  141. source code was written using Manx Aztec C, V3.5a (Yes Jim, a plug! :-),
  142. remains proprietary to Eric Lavitsky and may not be redistributed or
  143. sold without the expressed written consent of Eric Lavitsky. The 
  144. executable version of DropCloth and it's associated icons may be freely 
  145. redistributed provided this document is included in the distribution.
  146.