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