home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / new / amigalibdisks / d984 / forceicon / forceicon.doc next >
Text File  |  1994-04-04  |  30KB  |  685 lines
  1.    Welcome to ForceIcon v1.4. This is a short description on how to use
  2. the program and how to configure it. ForceIcon is a utility mainly
  3. written for users of CDRom drives or networking software of any kind.
  4.  
  5.    Have you ever tried to Snapshot the disk icon (Disk.info) or tried
  6. to replace the disk icon of a CDRom? Well, if not, do not even try,
  7. CDRom drives are read only media (how come). This is where ForceIcon
  8. comes to use. You may tell ForceIcon which volumes/devices to
  9. snoop/trace for forcing absolute positions or images. Furthermore you
  10. may set the window`s size/position and flags for viewing.
  11.  
  12. ForceIcon is (C) 1993/94 Kai Iske, GiftWare
  13.  
  14.    The Prefs program uses MUI; MUI is (C) Stefan Stuntz
  15.  
  16.    MUI version 2.0 or higher (internal version 7) is required
  17.  
  18.    The drawer and document icons were taken from the MagicWB
  19. distribution.  MagicWB was created by Martin 'XEN' Huttenloher. The
  20. icons are distributed with kind permission by the author. Furthermore
  21. the main program`s and the prefs program`s icons were created by
  22. Martin. Thank`s!
  23.  
  24. Copyright
  25. *********
  26.  
  27.    You are allowed to copy and spread this program but only if you do
  28. not make any commercial profit out of the program itself and all
  29. supported files. The source of ForceIcon is considered teachware and
  30. the author claims the right to be the only one to produce and release
  31. new versions of ForceIcon. Public Domain vendors are not allowed to
  32. sell ForceIcon for more than the price of a regular disk, which should
  33. not be higher than 5 Dollars.
  34.  
  35.    ForceIcon is GiftWare, so if you like it and you you want to express
  36. your feelings, feel free to send me anything you think of being suited.
  37. Postcards, cookies, money, simply anything ;)
  38.  
  39. Guarantee
  40. *********
  41.  
  42.    The author does not give any guarantee that the program ForceIcon
  43. works perfectly.  The program was tested and it is used every day,
  44. anyway nobody is perfect and that is why I can not take the
  45. responsibilty for any damages occured during the usage of ForceIcon.
  46.  
  47. Evolution/Overview
  48. ******************
  49.  
  50.    When I bought my CDRom drive I found out that the Workbench chooses
  51. quite *stupid* positions for icons with no absolute position (from my
  52. point of view). Furthermore some CDRom publishers do not seem to care
  53. for good looking disk icons (again, from my point of view; if they even
  54. supply one).  Since I could not snapshot the supplied icon, nor replace
  55. it with one of my icons, I thought it would be a good idea to have an
  56. utility which does the "snapshotting" or "replacment". This was when
  57. ForceIcon came to live.
  58.  
  59.    ForceIcon allows the user to select positions for his/her Disk.info
  60. files, either device dependant or volume dependant, ie. ForceIcon will
  61. either monitor *all* volumes inserted into a device, or just those
  62. specified by the user. It is also possible to override the settings for
  63. a device if you specify the name of a volume, too. Volumes may
  64. 'inherit' specifc settings of the corresponding device entry (as long
  65. as you`ve defined an entry for the device). Furthermore you may set the
  66. root drawer`s window size/position and display modes/flags.
  67.  
  68. Installing ForceIcon
  69. ********************
  70.  
  71.    *NOTE:* ForceIcon (both programs) must have a stack of 8192 bytes or
  72. more (more recommended)
  73.  
  74.    Installing ForceIcon is not that hard. Simply copy the main program
  75. (found in the `WBStartUp' drawer of this archive) and it`s icon to the
  76. `SYS:WBStartUp' drawer, or place it somewhere else and start ForceIcon
  77. from within your `S:User-StartUp' file. I suggest you better start
  78. ForceIcon from within `S:User-StartUp', so that ForceIcon may apply all
  79. patches *before* Workbench is loaded. If you do start it from
  80. `S:User-StartUp' then you`d better not copy it to `SYS:WBStartUp' ;)
  81.  
  82.    When starting from within `S:User-StartUp' issue the following line :
  83.  
  84.                        Run <NIL: >NIL: ForceIcon
  85.  
  86.    If you want to quit the main program, simply start it again, or
  87. select 'Quit' from the Prefs program.
  88.  
  89.    Now copy the Prefs program and it`s icon to a suitable location
  90. (like `SYS:Prefs'). The Prefs program may be found in the `Prefs'
  91. drawer of this archive.
  92.  
  93.    You may configure ForceIcon Prefs using the following
  94. ToolType/Commandline option.
  95.  
  96. `FLUSHMEMORY'
  97.      Due to the fact that the Prefs program uses MUI to create it`s
  98.      UserInterface, it is quite memory consuming. That`s why I added
  99.      this switch, which will cause the Prefs program to flush memory on
  100.      exit, thus removing all the libraries etc.pp not needed anymore
  101.      resulting in more free memory.
  102.  
  103.    This option may be used within the icon`s ToolType field or on the
  104. Commandline.
  105.  
  106. Using ForceIcon; Preferences program
  107. ************************************
  108.  
  109.    If you have installed the AmigaGuide(C) document you may retrieve
  110. online-help by pressing HELP in one of the windows. The main window is
  111. divided into three sensitive areas. The left ListView part, the right
  112. ListView part and the remaining parts of the window. Pressing help in
  113. either of them will bring up a different page of the document, ie. it`s
  114. a context sensitive HELP facility.
  115.  
  116.    From within the main window you may configure ForceIcon to suit your
  117. needs and disks. The main window is divided into two parts.
  118.  
  119.    The entries within the Listview gadgets show volumes/devices.
  120. Devices will be drawn in black, whilst Volumes will be drawn in white.
  121.  
  122.    The five gadgets at the bottom of the window are to be used as
  123. follows:
  124.  
  125. `Save'
  126.      Will copy the current settings to `ENV:ForceIcon_prefs.iff' *and*
  127.      to `ENVARC:ForceIcon_prefs.iff', thus leading to permanent storage
  128.      of your settings. The Prefs program will quit.
  129.  
  130. `Use'
  131.      Will copy the current settings to `ENV:ForceIcon_prefs.iff', thus
  132.      leading to temporary storage. The Prefs program will quit.
  133.  
  134. `About'
  135.      Displays about notices
  136.  
  137. `Hide'
  138.      Will close all windows and quit the Prefs program.
  139.  
  140. `Quit'
  141.      Will close all windows *and* remove ForceIcon (main program) from
  142.      memory.
  143.  
  144. Left ListView and buttons
  145. =========================
  146.  
  147.    The ListView gadget labeled 'Used volumes/devices' at the left side
  148. of the window shows all devices/volumes ForceIcon will act on. This is
  149. the list of entries you may edit. Double clicking on an entry from the
  150. list will bring up the edit window so you may edit the selected entry
  151. (see EditEntry).
  152.  
  153.    Every time an entry is added to the list, the list will be sorted,
  154. so that volumes are shown first. This is due to the fact, that volumes
  155. have a higher priority over devices, so that you may force a volume`s
  156. icon to an other position than the position specified for the device,
  157. the volume was mounted from.
  158.  
  159.    Below there are three buttons for editing, these are :
  160.  
  161. `Edit entry...'
  162.      Same as double clicking on an entry from the list. It will bring
  163.      up the edit window with all the data of the selected entry (see
  164.      EditEntry).
  165.  
  166. `Copy entry...'
  167.      This will let you copy the selected entry with all the settings
  168.      that come with it. The manual input window will pop up asking for
  169.      a new name for the copied entry, so that no doubles will be added
  170.      to the list (see ManualInput). ForceIcon will reject to accept
  171.      doubles.
  172.  
  173. `Remove entry'
  174.      Simple, I guess. This one will remove the selected entry from the
  175.      list of used devices/volumes. *Note:* There will be no warning;
  176.      just a delete.
  177.  
  178. Right ListView and buttons
  179. ==========================
  180.  
  181.    This ListView gadget labeled 'Available volumes/devices' keeps a
  182. list of all available volumes/devices currently known to the system. If
  183. a device handler wasn`t launched before the prefs program was launched,
  184. the device won`t show up in this list, ie. if you mount some devices
  185. with 'Mount=0' then the device won`t show up as long as it hasn`t been
  186. accessed. You may double click on an entry in order to copy it to the
  187. 'Used volumes/devices' ListView (see Left part). Again, there are
  188. three gadgets below that ListView, which are :
  189.  
  190. `Add entry'
  191.      This will act as if you have double clicked on an entry from the
  192.      list. It will copy the selected entry to the 'Used
  193.      volumes/devices' list, as long as it wasn`t added before, ie. you
  194.      may not have more than one instance of an