home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / WIN_BMP / FRCICN13.ZIP / FORCEICO.DOC < prev    next >
Text File  |  1994-02-15  |  15KB  |  453 lines
  1.    Welcome to ForcerIcon v1.3. This is a short description on how to
  2. use the program and how to configure it. ForceIcon is a utility mainly
  3. written for users of CDRom drives.
  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.
  10.  
  11. ForceIcon is (C) 1993 Kai Iske, GiftWare
  12.  
  13.    The UserInterface was built using GadToolsBox 2.0c (37.300) by Jan
  14. van den Baard
  15.  
  16. Copyright
  17. *********
  18.  
  19.    You are allowed to copy and spread this program but only if you do
  20. not make any commercial profit out of the program itself and all
  21. supported files. The source of ForceIcon is considered teachware and
  22. the author claims the right to be the only one to produce and
  23. distribute new versions of ForceIcon. Public Domain vendors are not
  24. allowed to sell ForceIcon for more than the price of a regular disk,
  25. which should not be higher than 5 Dollars.
  26.  
  27.    ForceIcon is GiftWare, so if you like it and you you want to express
  28. your feelings, feel free to send me anything you think of being suited.
  29. Postcards, cookies, money, simply anything ;)
  30.  
  31. Guarantee
  32. *********
  33.  
  34.    The author does not give any guarantee that the program ForceIcon
  35. works perfectly.  The program was tested and it is used every day,
  36. anyway nobody is perfect and that is why I can not take the
  37. responsibilty for any damages occured during the usage of ForceIcon.
  38.  
  39. Evolution
  40. *********
  41.  
  42.    When I bought my CDRom drive I found out that the Workbench chooses
  43. quite *stupid* positions for icons with no absolute position (from my
  44. point of view). Furthermore some CDRom publishers do not seem to care
  45. for good looking disk icons (again, from my point of view; if they even
  46. supply one).  Since I could not snapshot the supplied icon, nor replace
  47. it with one of my icons, I thought it would be a good idea to have an
  48. utility which does the "snapshotting" or "replacment". This was when
  49. ForceIcon came to live.
  50.  
  51.    ForceIcon allows the user to select positions for his/her Disk.info
  52. files, either device dependant or volume dependant, ie. ForceIcon will
  53. either monitor *all* volumes inserted into a device, or just those
  54. specified by the user. It is also possible to override the settings for
  55. a device if you specify the name of a volume, too.
  56.  
  57. Installing ForceIcon
  58. ********************
  59.  
  60.    Installing ForceIcon is not that hard. Simply copy it to your
  61. `SYS:WBStartUp' drawer (including the supplied icon), or place it
  62. somewhere else and start ForceIcon from within your `S:User-StartUp'
  63. file. I suggest you better start ForceIcon from within
  64. `S:User-StartUp', so that ForceIcon may apply all patches *before*
  65. Workbench is loaded.
  66.  
  67.    When starting from within `S:User-StartUp' issue the following line :
  68.  
  69.                        Run <NIL: >NIL: ForceIcon
  70.  
  71.    You may configure ForceIcon using the following
  72. ToolTypes/CommandLine options.
  73.  
  74. `CX_PRIORITY=n'
  75.      Sets the priority for the program`s section which controls the
  76.      HotKey.  If you issue a priority > 0 it may be that HotKeys
  77.      initialized by other programs may not be reached anymore if
  78.      ForceIcon uses the same.  Default: It`s neutral 0.
  79.  
  80. `CX_POPUP=YES|NO'
  81.      Per default the control window will be opened on startup. You may
  82.      suppress this behaviour by issuing *CX_POPUP=NO*
  83.  
  84. `CX_POPKEY=s'
  85.      Using this option you may override the default settings for the
  86.      openup HotKey.  This HotKey is used to open the control window.
  87.      Default HotKey definition is *lalt lshift i*. See HotKey, for more
  88.      about describing a HotKey.
  89.  
  90.    These options may be used within the icon`s ToolType field or on the
  91. CommandLine.
  92.  
  93. HotKey definition
  94. =================
  95.  
  96.    To ease the definition of a HotKey here is a list of
  97. key-descriptions the system "knows".
  98.  
  99.    Here is a list of qualifiers.
  100.  
  101. `ALT'
  102.      Any Alt key.
  103.  
  104. `RALT'
  105.      Only the right Alt key.
  106.  
  107. `LALT'
  108.      Only the left Alt key.
  109.  
  110. `SHIFT'
  111.      Either Shift key.
  112.  
  113. `RSHIFT'
  114.      The right Shift key.
  115.  
  116. `LSHIFT'
  117.      Only the left Shift Key.
  118.  
  119. `CAPSLOCK'
  120.      Capslock must be pressed.
  121.  
  122. `LCOMMAND'
  123.      Left Amiga key.
  124.  
  125. `RCOMMAND'
  126.      Right Amiga key.
  127.  
  128. `CONTROL'
  129.      Control Key.
  130.  
  131. `NUMERICPAD'
  132.      Keys of the Numeric Keypad are accepted.
  133.  
  134. `RBUTTON'
  135.      Right mousebutton.
  136.  
  137. `MIDBUTTON'
  138.      Middle mousebutton.
  139.  
  140. `LEFTBUTTON'
  141.      Left mousebutton.
  142.  
  143. `NEWPREFS'
  144.      Preferences have been changed. Maybe a new font was selected.
  145.  
  146. `DISKREMOVED'
  147.      A disk was removed from a drive.
  148.  
  149. `DISKINSERTED'
  150.      A disk was inserted into a drive.
  151.  
  152.    These are the qualifiers you can use in almost every combination.
  153. Now we come to the descriptions of "normal" keys.
  154.  
  155. `A - Z, 0 - 9, etc.pp.'
  156.      Normal keys, as you see them on the keyboard.
  157.  
  158. `F1 - F10'
  159.      The ten function keys.
  160.  
  161. `UP, DOWN, LEFT, RIGHT'
  162.      The cursor keys up, down, left, and right.
  163.  
  164. `HELP'
  165.      The Help key.
  166.  
  167. `DEL'
  168.      Delete key (beside HELP).
  169.  
  170. `BACKSPACE'
  171.      Backspace key
  172.  
  173. `RETURN'
  174.      Return key.
  175.  
  176. `ENTER'
  177.      Enter on Numeric Keyboard (only, if NUMERICPAD was specified).
  178.  
  179. `ESC'
  180.      Escape key.
  181.  
  182. `SPACE'
  183.      Space.
  184.  
  185. `COMMA'
  186.      A comma.
  187.  
  188. `UPSTROKE'
  189.      The apostroph (to the left of the 1).
  190.  
  191.    You can use as many qualifiers as you wish, but only one key per
  192. description.  This is the syntax for a HotKey definition:
  193.  
  194.                     [QUALIFIER [QUALIFIER ...]] KEY
  195.  
  196.    As you can see the qualifiers can be totally left out, but in how
  197. far this is usefull depends on you. Entering "None" (without quotes)
  198. will disable a HotKey.
  199.  
  200. Using ForceIcon
  201. ***************
  202.  
  203.    From within the main window you may configure ForceIcon to suit your
  204. needs and disks. The main window is divided into two parts.
  205.  
  206.    The five gadgets at the bottom of the window are to be used as
  207. follows:
  208.  
  209. `Use'
  210.      Will copy the current settings to `ENV:ForceIcon_prefs.iff', thus
  211.      leading to temporary storage.
  212.  
  213. `Save'
  214.      Will copy the current settings to `ENV:ForceIcon_prefs.iff' *and*
  215.      to `ENVARC:ForceIcon_prefs.iff', thus leading to permanent storage
  216.      of your settings.
  217.  
  218. `About'
  219.      Displays about notices
  220.  
  221. `Hide'
  222.      Will close all windows.
  223.  
  224. `Quit'
  225.      Will close all windows *and* remove ForceIcon from memory.
  226.  
  227. Left ListView and buttons
  228. =========================
  229.  
  230.    The ListView gadget labeled 'Used Volumes/Devices' at the left side
  231. of the window shows all devices/volumes ForceIcon will act on. This is
  232. the list of entries you may edit. Double clicking on an entry from the
  233. list will bring up the edit window so you may edit the selected entry
  234. (see EditEntry).
  235.  
  236.    Every time an entry is added to the list, the list will be sorted,
  237. so that volumes are shown first. This is due to the fact, that volumes
  238. have a higher priority over devices, so that you may force a volume`s
  239. icon to an other position than the position specified for the device,
  240. the volume was mounted from.
  241.  
  242.    Below there are three buttons for editing, these are :
  243.  
  244. `Edit entry...'
  245.      Same as double clicking on an entry from the list. It will bring
  246.      up the edit window with all the data of the selected entry (see
  247.      EditEntry).
  248.  
  249. `Copy...'
  250.      This will let you copy the selected entry with all the settings
  251.      that come with it. The manual input window will pop up asking for
  252.      a new name for the copied entry, so that no doubles will be added
  253.      to the list (see ManualInput). ForceIcon will reject to accept
  254.      doubles.
  255.  
  256. `Remove from list'
  257.      Simple, I guess. This one will remove the selected entry from the
  258.      list of used devices/volumes. *Note:* There will be no warning;
  259.      just a delete.
  260.  
  261. Right ListView and buttons
  262. ==========================
  263.  
  264.    This ListView gadget labeled 'Available volumes/devices' keeps a
  265. list of all available volumes/devices currently known to the system.
  266. You may double click on an entry in order to copy it to the 'Used
  267. volumes/devices' ListView (see Left part).  Again, there are three
  268. gadgets below that ListView, which are :
  269.  
  270. `Add to list'
  271.      This will act as if you have double clicked on an entry from the
  272.      list. It will copy the selected entry to the 'Used
  273.      volumes/devices' list, as long as it wasn`t added before, ie. you
  274.      may not have more than one instance of an entry in that list.
  275.  
  276. `Add manually...'
  277.      If a volume/device isn`t mounted yet, you may add it`s name
  278.      manually using the manual input window (see ManualInput).
  279.  
  280. `Rescan list'
  281.      Will cause ForceIcon to re-scan the list of available
  282.      volumes/devices in order to update the list of the ListView
  283.      gadget. This might be of use, when a volume/device gets mounted
  284.      *after* you`ve opened the main window.
  285.  
  286. Edit an entry
  287. -------------
  288.  
  289.    This is the window containing all the gadgets to customize an entry.
  290. There are 9 gadgets which will be explained more in detail now.
  291.  
  292. `Volume'
  293.      This is the String gadget containing the volume`s/device`s name.
  294.      Simply edit it, if you want to change the name of the monitored
  295.      entry.
  296.  
  297. `Type'
  298.      Allows you to change the type of entry you are editing. You may
  299.      choose between 'Volume' and 'Device'.
  300.  
  301. `CurrentX / CurrentY'
  302.      These Integer gadgets may be used to manually set the icon`s
  303.      position. They will be updated if you move the position window.
  304.      These gadgets won`t be active as long as you don`t specifiy
  305.      'IconPos'
  306.  
  307. `Position'
  308.      Using this gadget you may open the position window, a small window
  309.      which may be moved around your Workbench in order to determine the
  310.      position of the icon. This gadget won`t be available as long as
  311.      you don`t specify 'IconPos'
  312.  
  313. `IconPos'
  314.      Using this gadget you may tell ForceIcon to 'patch' the position
  315.      of the entry`s Disk.info file. If selected you may use the
  316.      Position window or the Integer gadgets to determine the position
  317.      of the icon. If not selected, the position of the selected entry`s
  318.      Disk.info file will be set to NO_ICON_POSITION so that Workbench
  319.      may choose a suitable location for it.
  320.  
  321. `Icon'
  322.      Using this String gadget you may set the name of an alternative
  323.      icon which should be used in place of the original Disk.info file.
  324.      This one can only be used as long as 'Use Icon' is active. The
  325.      GetFile gadget at the right of the String gadget may be used to
  326.      select an icon file using a FileRequester.
  327.  
  328. `Use Icon'
  329.      If you want to substitute the Disk.info of an entry, check 'Use
  330.      Icon' and you may select an alternative Icon file.
  331.  
  332. Manual input
  333. ------------
  334.  
  335.    This window is used to manually add a new name to the list of used
  336. devices/volumes or if you try to copy an entry. A window will pop up
  337. containing a String gadget and a Cycle gadget.
  338.  
  339.    The String gadget may be used to enter the new device`s/volume`s
  340. name.  *Note*, that you have to leave out the trailing colon of the
  341. device`s/volume`s name.
  342.  
  343.    To determine the type of entry you are editing, use the Cycle gadget
  344. at the bottom of the window. You may choose between 'Device' and
  345. 'Volume'.  This step is necessary because ForceIcon has to know how to
  346. deal with the entry.
  347.  
  348. Whom I must say 'thank you'
  349. ***************************
  350.  
  351.    I would like to thank the following people
  352.  
  353. `Martin Taillefer'
  354.      For answering several questions
  355.  
  356. `Olaf 'Olsen' Barthel'
  357.      For suggestions and beta-testing
  358.  
  359. `Ralph Babel'
  360.      For suggestions on how to implement device dependancy and for
  361.      pointing me to a "bug".
  362.  
  363. `My girlfriend'
  364.      Who accepts what I`m doing
  365.  
  366.      ...and all the others I forgot
  367.  
  368. How to obtain updates
  369. *********************
  370.  
  371.    ForceIcon will be available on ADS, FRAS, FTP, and Fred Fish disks
  372. (CDs) as soon as there is a new release available.
  373.  
  374. How to contact the author
  375. *************************
  376.  
  377.    If you have any questions, suggestions, bug reports or anything else
  378. you want to tell me, you may contact me under one of these addresses.
  379.  
  380.    Either use normal snail mail:
  381.  
  382.      Kai Iske
  383.      Brucknerstrasse 18
  384.      63452 Hanau
  385.      Germany
  386.      Tel.: +49-(0)6181-850181
  387.  
  388.    or reach me using electronical mail
  389.  
  390.      USENET:   kai@iske.adsp.sub.org
  391.      INTERNET: iske@informatik.uni-frankfurt.de
  392.      FIDO:     Kai Iske, 2:244/6302.11
  393.      ZNET:     KAI@SWEET.ZER
  394.  
  395. Program history
  396. ***************
  397.  
  398.      Revision V1.3
  399.      --------------
  400.      created on Sunday, 02.01.94 15:31:32  by  Kai Iske.   LogMessage :
  401.        - Code cleanup
  402.        - Partial rewrite of docs
  403.      
  404.      Revision V1.2
  405.      --------------
  406.      created on Tuesday, 07.12.93 18:10:09  by  Kai Iske.   LogMessage :
  407.        - Entries may be copied now
  408.      
  409.      Revision V1.1
  410.      --------------
  411.      created on Tuesday, 02.11.93 23:11:14  by  Kai Iske.   LogMessage :
  412.       -*-  changed on Saturday, 27.11.93 02:12:59  by  Kai Iske.   LogMessage :
  413.        - Recompiled using SAS 6.50
  414.       -*-  changed on Saturday, 20.11.93 18:14:21  by  Kai Iske.   LogMessage :
  415.        - ForceIcon will adopt the orig. window position and size now.
  416.          (Suggested by : Michael 'Mick' Hohmann and me)
  417.       -*-  changed on Saturday, 20.11.93 18:03:08  by  Kai Iske.   LogMessage :
  418.        - Icons weren`t positions as set with the Position window.
  419.          (Reported by : Michael 'Mick' Hohmann)
  420.        - Misleading explanation removed from docs
  421.          (Reported by : Michael 'Mick' Hohmann)
  422.       -*-  changed on Saturday, 20.11.93 17:33:51  by  Kai Iske.   LogMessage :
  423.        - The X/Y coordinates may be set manually, now.
  424.          (Requested by : Michael 'Mick' Hohmann)
  425.       -*-  changed on Saturday, 20.11.93 17:24:20  by  Kai Iske.   LogMessage :
  426.        - Edit Entry window`s gadget used 'I' twice
  427.          (Reported by : Michael 'Mick' Hohmann)
  428.       -*-  changed on Thursday, 11.11.93 18:43:27  by  Kai Iske.   LogMessage :
  429.        - You may now tell ForceIcon not to patch the position, but
  430.          rather let WB chose a good place. (Good when importing
  431.          volumes via network)
  432.       -*-  changed on Tuesday, 02.11.93 23:23:00  by  Kai Iske.   LogMessage :
  433.        - ListView gadgets weren`t adjusted for OS 2.x. - Should check
  434.          for OS 2.x sometime ;)
  435.          (Reported by : Bernhard Moellemann)
  436.        - Changed needed Versions of some libraries from 37 to 36
  437.       -*-  created on Tuesday, 02.11.93 23:11:14  by  Kai Iske.   LogMessage :
  438.        - If there wasn`t a filename for the Icon-File the
  439.          FileRequester sometimes showed a weird Drawer-Name
  440.          (Reported by : Dirk Federlein)
  441.      
  442.      Revision V1.0
  443.      --------------
  444.      created on Wednesday, 20.10.93 17:19:27  by  Kai Iske.   LogMessage :
  445.       -*-  changed on Thursday, 28.10.93 17:35:28  by  Kai Iske.   LogMessage :
  446.        - Suggestions for device dependancy by Ralph Babel
  447.        - Bug "found" by Ralph Babel
  448.        - Pos window used to open on default pubscreen, not on WB.
  449.          (Reported by : Bernhard Moellemann)
  450.       -*-  created on Wednesday, 20.10.93 17:19:27  by  Kai Iske.   LogMessage :
  451.          --- Initial release ---
  452.  
  453.