home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 104.lha / wIconify.doc < prev    next >
Encoding:
Text File  |  1980-07-10  |  7.2 KB  |  164 lines
  1. OVERVIEW:
  2.  
  3. wIconify is a program that allows you to turn windows on the workbench screen
  4. into small icons on the workbench, similar to the disk icons.  These can be
  5. moved about, double-clicked to open, and acted on by workbench OPEN and CLOSE
  6. menus.  wIconify also provides additional menus to clean up the workbench,
  7. organize the window icons, and open all the window icons.
  8.  
  9. WARNING:  wIcoinfy works in sneaky and devious ways; it modifies structures
  10. that it does not own, and probably will not work in a future release of the 
  11. Amiga system software.  Use it at your own risk.  No warranty is either
  12. expressed or implied by this distribution.
  13.  
  14.  
  15. SETTING UP WICONIFY:
  16.  
  17. wIconify comes in two parts:  wIconify and wIconify-Handler.  wIconify should 
  18. be placed in your C: directory if you are using it from a CLI or 
  19. startup-sequence, or in a drawer with its .INFO file if you are using it from 
  20. the workbench.  wIconify-Handler should be placed in the L: directory.
  21.  
  22.  
  23. HOW TO USE WICONIFY:
  24.  
  25. To start up wIconify, simply double-click on its workbench icon, or type
  26.  
  27.     1> wIconify
  28.  
  29. in a CLI window.  You do not need to RUN wIconify.
  30.  
  31. To iconify a window, select it, and while holding down the left button, click 
  32. the right button.  This sounds awkward, but is quite easy and natural with a
  33. little practice.  Be sure that you are holding down the left button when you 
  34. LET GO of the right button.  We will call this a "left-right click."  It is
  35. the same as selecting multiple menu items, but with the buttons reversed.
  36.  
  37. When you left-right click in a window, it will disappear, and will be replaced
  38. by a small window-shaped icon on the workbench window.  The icon will be
  39. labeled with the window's title.  You can move the icon to a new position on
  40. the workbench by dragging it the same way you would drag a disk icon.
  41.  
  42. To open a window icon, select it and choose the OPEN item in the WORKBENCH
  43. menu, or just double click on the window icon.  The iconified window will be
  44. restored, and its icon removed from the workbench.
  45.  
  46. If the iconified window has a close gadget, then the CLOSE item in the
  47. WORKBENCH menu can be used to close the window while it is iconified.  Left-
  48. right clicking on the window icon of a window that has a close gadget has the
  49. same effect.
  50.  
  51. You can select multiple window icons by holding down the shift key when you
  52. select the second and any additional window icons, but you can not select both
  53. disk and window icons at the same time.  You can move multiple icons just as 
  54. you would move individual icons.  The OPEN and CLOSE menu items work on ALL 
  55. the selected icons, as do the double click (open) and left-right click (close) 
  56. operations.
  57.  
  58.  
  59. THE ICONIFY MENU:
  60.  
  61. When wIcoinfy is running, you will find an additional menu item in the
  62. WORKBENCH menu of the workbench screen.  Below the DISCARD item you should see
  63. an ICONIFY item.  This menu has five sub-menu items with the following effects:
  64.  
  65. The VERSION item displays the version number and copyright notice for wIconify.
  66.  
  67. The CLEAN UP item moves all of the window icons to the "grid" position that is
  68. closest to their current position.  This tends to make the workbench look a
  69. bit "cleaner."  The ICONIFY CLEAN UP item does not affect disk or tool icons.
  70.  
  71. The ORGANIZE item moves all of the window icons to the bottom of the screen,
  72. where they can be easily seen (or uncovered, if a window covers them).  
  73. ORGANIZE does not affect the disk or tool icons.
  74.  
  75. The OPEN ALL item opens all the window icons (use OPEN from the WORKBENCH menu 
  76. if you want to open only the selected icons).  OPEN ALL does not affect the
  77. disk or tool icons.
  78.  
  79. The END item causes wIcoinfy to end.  Any iconified windows are restored first.
  80. You can also end wIconify by running wIconify a second time from either the
  81. CLI or the workbench.
  82.  
  83.  
  84. USAGE NOTES:
  85.  
  86. The workbench MUST be loaded BEFORE you run wIconify.  If you want to use
  87. wIconify in your startup-sequence, you should put wIconify AFTER the loadwb. 
  88. To avoid disk thrashing, it is a good idea to put a WAIT between the loadwb
  89. and wIconify commands.  For example:
  90.  
  91.     LoadWB
  92.     Wait 4
  93.     wIconify
  94.     EndCLI > NIL:
  95.  
  96.  
  97. Icons are placed on the workbench starting at the lower left corner. 
  98. Subsequent icons are placed farther to the right.  When the bottom row is
  99. filled, they begin at the left of the next row up.  Since the window-sizing 
  100. gadget is in the lower right of a window, it is easiest to make room to the 
  101. right and below a window (you shrink it to the left or up).  Since disk icons 
  102. already are to the right of the workbench, it seems natural to put the window 
  103. icons at the bottom, where they are easily uncovered.
  104.  
  105. Only windows on the workbench screen can be iconified by wIconify.
  106.  
  107. Iconifying a disk or drawer window causes the window to close rather than
  108. iconify (since disks and drawer already have their own icons).
  109.  
  110. Programs can supply their own icon images for windows that they open.  
  111. wIconify uses a default image for windows that do not provide their own.
  112. This is discussed in greater detail in the wIconify programmer's documentation.
  113.  
  114. Output that goes to a window while it is iconified will not be lost.  For 
  115. smart-refresh windows, their contents will be restored immediately after they
  116. are de-iconified.  Simple-refresh windows will receive a REFRESHWINDOW event,
  117. and should update their contents under program control.  Super-bitmap windows
  118. will be updated from their bitmaps.
  119.  
  120. Note that iconifying a window DOES NOT save any chip memory; indeed, it will use
  121. up MORE if the window is a smart-refresh window.  Iconifying a window is just
  122. like covering it up with another window as far as memory usage is concerned.
  123.  
  124. If chip memory is very low, you may not be able to iconify smart-refresh
  125. windows.  Their icons will still appear, but the windows will not disappear. 
  126. If this happens, just double click on the icon to remove it.  You will have to
  127. free up some chip memory before you can iconify the window.
  128.  
  129. wIconify takes about 21K of memory when it is running.  As windows are
  130. iconified, additional memory is allocated for the icons.  wIconify should free
  131. all the memory that it allocated when it exits.
  132.  
  133.  
  134. DUPLICATION AGREEMENT:
  135.  
  136. wIconify, Copyright (c) 1987,1988 by Davide P. Cervone.
  137.  
  138. You may use, copy, and distribute wIconify as much as you want, provided this
  139. copyright notice is kept intact; you are not permitted, however, to charge
  140. money for wIcoinfy in any way, except to cover media and distribution costs.
  141. If you wish to use wIconify as part of a commercial product, please contact
  142. the author.
  143.  
  144.  
  145. PLEA FOR MAIL:
  146.  
  147. I am NOT asking for money from you if you use this.  I AM asking that you send
  148. me electronic mail if you like and use wIcoinfy.  All I want is to get a little
  149. "thank you" note now and then for my efforts.  There is nothing that pleases
  150. me more than to hear that someone is using and likes one of my programs.  If
  151. that someone is YOU, then please let me know.  If you do not have access to an
  152. electronic network, please send a postcard with your favorite bit of Amiga
  153. trivia.  Of course, you can still use wIconify even if you don't.  I try to
  154. answer all my mail, even when it bounces.
  155.  
  156.  
  157. AUTHOR:
  158.  
  159. Davide P. Cervone
  160. University of Rochester Computing Center        dpvc@tut.cc.rochester.EDU
  161. Taylor Hall                                     dpvc@ur-tut.UUCP
  162. Rochester, New York  14627                      DPVC@UORDBV.BITNET
  163. (716) 275-2811
  164.