home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 2 / af002.adf / DropCloth / DropCloth.DOC < prev    next >
Text File  |  1989-04-24  |  6KB  |  150 lines
  1.                              DropCloth
  2.                             Version 2.4
  3.                           By Eric Lavitsky
  4.                           29-February-1988
  5.                    (C) 1987, 1988 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. If you are using ARC to unpack DropCloth, please do
  11. the following from the CLI:
  12.  
  13.     1> execute execute.me
  14.  
  15. this will rename all of the files in the archive to their proper
  16. names.
  17.  
  18. To use DropCloth from the CLI, type:
  19.  
  20.         1>dropcloth [-d number] [-i filename [-c]]
  21.  
  22. where "number" is between 0 and 64 inclusive, and "filename" is a
  23. valid IFF image file. The number after '-d' specifies the intensity
  24. of the pattern used for the backdrop, 0 will render a clear pattern
  25. into the display, while 64 will render a solid backdrop. If you 
  26. don't specify a pattern, DropCloth will default to 0, a clear pattern.
  27. The '-c' switch causes DropCloth to temporarily set the WorkBench
  28. colors to those contained in the IFF image file. The Preferences
  29. colors will be restored upon exitting DropCloth. To remove DropCloth
  30. and any pattern or image it has rendered into the backdrop, simply run
  31. DropCloth a second time. It is generally recommended that DropCloth be
  32. "RUN" or "RUNBACKED" from the CLI.
  33.  
  34. To use DropCloth from the WorkBench:
  35.  
  36.         Double click directly on the DropCloth Icon or
  37.         Double click on an IFF image Icon whose default
  38.         tool points to DropCloth.
  39.  
  40. The image must be an IFF image (ILBM). Change it's default tool to
  41. point to DropCloth. Assuming DropCloth resides in the C: directory,
  42. select the image icon and then select "Info" from the WorkBench menu.
  43. The next to last field in the Icon is the default tool:
  44.                   ____________________________
  45.         DEFAULT TOOL  | C:DropCloth              |
  46.                   ----------------------------
  47.  
  48. If your image does not have an Icon, you may create an Icon for it by
  49. copying one of the Icons normally created by DPaint. If you want 
  50. DropCloth to render a pattern, specify the pattern you want in the
  51. ToolTypes of the DropCloth Icon (if you are rendering a pattern only)
  52. or in the ToolTypes of the image Icon (if you are rendering an image
  53. along with a pattern). Again, select the Icon in question, pull down
  54. "Info" from the WorkBench menu, go down to the ToolTypes field, select
  55. "ADD", click in the ToolTypes text gadget and enter:
  56.         _________________________________
  57.         |PATTERN=n            |
  58.         ---------------------------------
  59.  
  60. where n is again a number between 0 and 64 inclusive. If you wish
  61. DropCloth to change the WorkBench colors to those contained in the IFF
  62. image, add another ToolType that looks like the following:
  63.  
  64.         _________________________________
  65.         |USECOLORS=YES            |
  66.         ---------------------------------
  67.  
  68. To remove dropcloth and any pattern or image it has rendered into the
  69. WorkBench backdrop, simply run DropCloth a second time by double
  70. clicking on it's Icon.
  71.  
  72. - Features and Limitations
  73.     - Current version will accept any size image - patterns work fine
  74.     in any size screen including "morerowed" (overscan) screens.
  75.     - Please note that DropCloth works best with images that have had
  76.     their colors set to look right with 4 colors (2 bitplanes). I would
  77.     suggest looking at PixMate from Progressive Peripherals and Software
  78.     for modifying the colors of your IFF images.
  79.      - The fuel gauge in main disk windows is not properly refreshed by
  80.     RefreshWindowFrame() ... (sigh)
  81.     - Requires V1.2 or greater of KickStart to run
  82.  
  83. - Future considerations
  84.     - We could give an option to add bitplanes to the workbench screen for
  85.     images > 2 bitplanes or try and map colors to 2 bitplanes. This would
  86.     slow things down and eat lots of CHIP memory (ugh!).
  87.     - Allow the user to select the pen number used to render the backdrop
  88.     pattern.
  89.  
  90. - V 2.4 Additions
  91.     - Temporarily change WorkBench colors to that of the image being
  92.     rendered and restore the old colors upon exit.
  93.  
  94. - V 2.3 Fixes
  95.     - Fixed bug where disk icons weren't correctly refreshed when no
  96.     pattern was selected to be rendered.
  97.     - Garbage is no longer rendered into the display when a picture of
  98.     resolution lower than the WorkBench screen is rendered.
  99.  
  100. GENERAL INFO
  101.  
  102. - How it started
  103.     - When I first got my Amiga way back in August '85, I was
  104. dissapointed to find that I couldn't put an image or pattern in my
  105. backdrop like we could on the AI workstations and Macintoshes at Rutgers.
  106.     - One day, someone posted on the net that at a gathering in the
  107. Apple Computer cafeteria one day, Andy Hertzfeld, of Macintosh design
  108. team fame, was quoted as saying that the Amiga wasn't a serious machine:
  109. "C'mon,    a user interface with windows the same color as the screen?!!!".
  110. I vowed that one day, I'd show him! :-)
  111.     - DropCloth is the answer to Hertzfeld's shortsighted remark.
  112. Maybe one day, he'll realize what the Amiga is for it's true potential.
  113. Remember, the Workbench is just another application - it can be greatly
  114. enhanced or replaced (Can *you* say that about the Mac Finder?)
  115.  
  116. - What it does
  117.     - Things we had to realize about the workbench:
  118.         - The Workbench renders it's icons into a 
  119.         backdrop borderless window.
  120.         - When an icon is moved SetRast() is called to
  121.         clear the layer and all the icons are redrawn.
  122.         This is fairly fast, but destroys anything you
  123.         render yourself into the backdrop.
  124.     - So, get the source to see how it's done! (plug, plug :-)
  125.  
  126. Thanks to:
  127.     Perry Kivolowitz        - Spurring me on, helping fix my bugs
  128.     Jon Trudel            - The DropCloth Icon
  129.     Andy Hertzfeld            - The original incentive
  130.     Kim Devaughn, Rusty Haddock    - Beta Testing
  131.  
  132. Copyright and Shareware Notice:
  133.  
  134. DropCloth is Copyright 1987, 1988 by Eric Lavitsky. DropCloth is a 
  135. shareware product. If you feel this product enhances your environment, 
  136. please send a contribution to:
  137.  
  138.     Eric Lavitsky
  139.     34 Maplehurst Ln.
  140.     Piscatway, NJ 08854
  141.  
  142. Keep the shareware concept alive! Suggested donation is $10. Donations 
  143. of $15 or more will yield a disk replete with the source code to the
  144. latest version of DropCloth. The source code was written using Manx 
  145. Aztec C, V3.6a (Yes Jim, a plug! :-), remains proprietary to Eric 
  146. Lavitsky and may not be redistributed or sold without the expressed
  147. written consent of Eric Lavitsky. The executable version of DropCloth
  148. and it's associated icons may be freely redistributed provided this
  149. document is included in the distribution.
  150.