Welcome to ForcerIcon v1.1. This is a short description on how to use the program and how to configure it. ForceIcon is a utility mainly written for users of CDRom drives. Have you ever tried to Snapshot the disk icon (Disk.info) or tried to replace the disk icon of a CDRom ? Well, if not, do not even try, CDRom drives are read only media (how come). This is where ForceIcon comes to use. You may tell ForceIcon which volumes/devices to snoop/trace for forcing abolute positions or images. ForceIcon is (C) 1993 Kai Iske, GiftWare The UserInterface was built using GadToolsBox 2.0c (37.300) by Jan van den Baard Copyright ********* You are allowed to copy and spread this program but only if you do not make any commercial profit out of the program itself and all supported files. The source of ForceIcon is considered teachware and the author claims the right to be the only one to produce and distribute new versions of ForceIcon. Public Domain vendors are not allowed to sell ForceIcon for more than the price of a regular disk, which should not be higher than 5 Dollars. ForceIcon is GiftWare, so if you like it and you you want to express your feelings, feel free to send me anything you think of being suited. Postcards, cookies, money, simply anything ;) Guarantee ********* The author does not give any guarantee that the program ForceIcon works perfectly. The program was tested and it is used every day, anyway nobody is perfect and that is why I can not take the responsibilty for any damages occured during the usage of ForceIcon. Evolution ********* When I bought my CDRom drive I found out that the Workbench chooses quite *stupid* positions for icons with no abolute position (from my point of view). Furthermore some CDRom publishers do not seem to care for good looking disk icons (again, from my point of view; if they even supply one). Since I could not snapshot the supplied icon, nor replace it with one of my icons, I thought it would be a good idea to have an utility which does the "snapshotting" or "replacment". This was when ForceIcon came to live. ForceIcon allows the user to select positions for his/her Disk.info files, either device dependant or volume dependant, ie. ForceIcon will either monitor *all* volumes inserted into a device, or just those specified by the user. It is also possible to override the settings for a device if you specify the name of a volume, too. Whom I must say 'thank you' *************************** I would like to thank the following people `Martin Taillefer' For answering several questions `Olaf 'Olsen' Barthel' For suggestions and beta-testing `Ralph Babel' For suggestions on how to implement device dependancy and for pointing me to a "bug". `My girlfriend' Who accepts what I`m doing ...and all the others I forgot How to obtain updates ********************* ForceIcon will be available on ADS, FRAS, FTP, and Fred Fish disks (CDs) as soon as there is a new release available. How to contact the author ************************* If you have any questions, suggestions, bug reports or anything else you want to tell me, you may contact me under one of these addresses. Either use normal snail mail: Kai Iske Brucknerstrasse 18 63452 Hanau Germany Tel.: +49-(0)6181-850181 or reach me using electronical mail USENET: kai@iske.adsp.sub.org INTERNET: iske@informatik.uni-frankfurt.de FIDO: Kai Iske, 2:244/6302.11 ZNET: KAI@SWEET.ZER Installing ForceIcon ******************** Installing ForceIcon is not that hard. Simply copy it to your `SYS:WBStartUp' drawer (including the supplied icon), or place it somewhere else and start ForceIcon from within your `S:User-StartUp' file. I suggest you better start ForceIcon from within `S:User-StartUp', so that ForceIcon may apply all patches *before* Workbench is loaded. When starting from within `S:User-StartUp' issue the following line : Run NIL: ForceIcon You may configure ForceIcon using the following ToolTypes/CommandLine options. `CX_PRIORITY=n' Sets the priority for the program`s section which controls the HotKey. If you issue a priority > 0 it may be that HotKeys initialized by other programs may not be reached anymore if ForceIcon uses the same. Default: It`s neutral 0. `CX_POPUP=YES|NO' Per default the control window will be opened on startup. You may suppress this behaviour by issuing *CX_POPUP=NO* `CX_POPKEY=s' Using this option you may override the default settings for the openup HotKey. This HotKey is used to open the control window. Default HotKey definition is *lalt lshift i*. See HotKey, for more about describing a HotKey. These options may be used within the icon`s ToolType field or on the CommandLine. HotKey definition ================= To ease the definition of a HotKey here is a list of key-descriptions the system "knows". Here is a list of qualifiers. `ALT' Any Alt key. `RALT' Only the right Alt key. `LALT' Only the left Alt key. `SHIFT' Either Shift key. `RSHIFT' The right Shift key. `LSHIFT' Only the left Shift Key. `CAPSLOCK' Capslock must be pressed. `LCOMMAND' Left Amiga key. `RCOMMAND' Right Amiga key. `CONTROL' Control Key. `NUMERICPAD' Keys of the Numeric Keypad are accepted. `RBUTTON' Right mousebutton. `MIDBUTTON' Middle mousebutton. `LEFTBUTTON' Left mousebutton. `NEWPREFS' Preferences have been changed. Maybe a new font was selected. `DISKREMOVED' A disk was removed from a drive. `DISKINSERTED' A disk was inserted into a drive. These are the qualifiers you can use in almost every combination. Now we come to the descriptions of "normal" keys. `A - Z, 0 - 9, etc.pp.' Normal keys, as you see them on the keyboard. `F1 - F10' The ten function keys. `UP, DOWN, LEFT, RIGHT' The cursor keys up, down, left, and right. `HELP' The Help key. `DEL' Delete key (beside HELP). `BACKSPACE' Backspace key `RETURN' Return key. `ENTER' Enter on Numeric Keyboard (only, if NUMERICPAD was specified). `ESC' Escape key. `SPACE' Space. `COMMA' A comma. `UPSTROKE' The apostroph (to the left of the 1). You can use as many qualifiers as you wish, but only one key per description. This is the syntax for a HotKey definition: [QUALIFIER [QUALIFIER ...]] KEY As you can see the qualifiers can be totally left out, but in how far this is usefull depends on you. Entering "None" (without quotes) will disable a HotKey. Using ForceIcon *************** From within the main window you may configure ForceIcon to suit your needs and disks. On the right side of the window you will notice a ListView gadget showing all available volumes/devices currently known to the system. From this ListView you may select the volumes/devices to apply changes to. Simply select an entry and click on the *Add to list* gadget and the selected volume/device will be copied to the left ListView gadget named 'Used Volumes/Devices'. You may copy an entry to the select-list by double-clicking on it, too. If the selected entry has already been added to the list, a requester will pop up giving a warning. If a volume/device is not mounted yet you may add it`s name to the 'Used Volumes/Devices' list by clicking on *Add manually...*. A window will pop up, containing a String gadget. Simply enter the new entry`s name *without* a trailing colon. Selecting *Ok* will copy the entered volume to the 'Used Volumes/Devices' list, as long as it is not there yet. 'Cancel' will simply abort. You may determine the type of entry using the *Type* gadget. The third gadget underneith the 'Available Volumes/Devices' ListView called *Rescan list* may be used if a volume/device has been mounted *after* the main window has been opened. Underneith the 'Used Volumes/Devices' ListView there are two Button gadgets. Selecting *Edit entry...*, or double clicking on an entry will open the 'Edit entry' window (see EditEntry). The second gadget labeled *Remove from list*, will simply remove the selected entry from the 'Used Volumes/Devices' list. The Text gadget right underneith the ListView will tell you about the type of entry currently selected. Every time an entry is added to the list, the list will be sorted, so that volumes are shown first. This is due to the fact, that volumes have a higher priority over devices, so that you may force a volume`s icon to an other position than the position specified for the device, the volume was mounted from. The five gadgets at the bottom of the window are to be used as follows: `Use' Will copy the current settings to `ENV:ForceIcon_prefs.iff', thus leading to temporary storage. `Save' Will copy the current settings to `ENV:ForceIcon_prefs.iff' *and* to `ENVARC:ForceIcon_prefs.iff', thus leading to permanent storage of your settings. `About' Displays about notices `Hide' Will close all windows. `Quit' Will close all windows *and* remove ForceIcon from memory. Edit an entry ============= This window may be used to edit an entry. The first gadget is a String gadget, which may be used to change the volume`s name, say the name of the volume/device ForceIcon will react on. The Cycle gadget (*Type*) underneith the String gadget allows you to change the type of entry you are editing. Below there are two Integer gadgets showing the current position of the disk icon of the selected volume. You may either set a position manually, or use the 'Position window', but only if you select *IconPos*. If this gadget is not set, ForceIcon will force the loaded icon to have a position of NO_ICON_POSITION, say it will let the WorkBench position the icon. This might be usefull to override hardcoded positions. The position window may be opened using the *Position* Cycle gadget. Clicking on it once will open the window, whilst another click will close it again. Open the 'Position window' and drag it around your workbench. The values shown within the Number gadgets will be updated as soon as you release your left mouse button. Using this method you may determine the position of a disk`s icon on Workbench, too. Now following are three more gadgets which determine the image of the selected volume`s icon. Using the String gadget labeled *Icon*, you may set a name for a `.info' file which should be used, instead of the volume`s `Disk.info', or it will be used if the volume does not even have a `Disk.info'. Clicking on the GetFile gadget or holding down SHIFT while hitting the String gadget`s shortcut will open up a Filerequester, so that you may select a `.info' file using a more convenient method. These two gadgets are only available if the following gadget is set. Finally, the *Use Icon* gadget determines, whether the supplied icon should really be used, or not. You do not have to worry about the type of the selected `.info' file. ForceIcon will automatically apply all changes to the icon, so that it will be a *real* disk icon. These changes are applied during runtime. The file will not be modified on disk. Program history *************** Revision V1.1 -------------- created on Tuesday, 02.11.93 23:11:14 by Kai Iske. LogMessage : -*- changed on Saturday, 27.11.93 02:12:59 by Kai Iske. LogMessage : - Recompiled using SAS 6.50 -*- changed on Saturday, 20.11.93 18:14:21 by Kai Iske. LogMessage : - ForceIcon will adopt the orig. window position and size now. (Suggested by : Michael 'Mick' Hohmann and me) -*- changed on Saturday, 20.11.93 18:03:08 by Kai Iske. LogMessage : - Icons weren`t positions as set with the Position window. (Reported by : Michael 'Mick' Hohmann) - Misleading explanation removed from docs (Reported by : Michael 'Mick' Hohmann) -*- changed on Saturday, 20.11.93 17:33:51 by Kai Iske. LogMessage : - The X/Y coordinates may be set manually, now. (Requested by : Michael 'Mick' Hohmann) -*- changed on Saturday, 20.11.93 17:24:20 by Kai Iske. LogMessage : - Edit Entry window`s gadget used 'I' twice (Reported by : Michael 'Mick' Hohmann) -*- changed on Thursday, 11.11.93 18:43:27 by Kai Iske. LogMessage : - You may now tell ForceIcon not to patch the position, but rather let WB chose a good place. (Good when importing volumes via network) -*- changed on Tuesday, 02.11.93 23:23:00 by Kai Iske. LogMessage : - ListView gadgets weren`t adjusted for OS 2.x. - Should check for OS 2.x sometime ;) (Reported by : Bernhard Moellemann) - Changed needed Versions of some libraries from 37 to 36 -*- created on Tuesday, 02.11.93 23:11:14 by Kai Iske. LogMessage : - If there wasn`t a filename for the Icon-File the FileRequester sometimes showed a weird Drawer-Name (Reported by : Dirk Federlein) Revision V1.0 -------------- created on Wednesday, 20.10.93 17:19:27 by Kai Iske. LogMessage : -*- changed on Thursday, 28.10.93 17:35:28 by Kai Iske. LogMessage : - Suggestions for device dependancy by Ralph Babel - Bug "found" by Ralph Babel - Pos window used to open on default pubscreen, not on WB. (Reported by : Bernhard Moellemann) -*- created on Wednesday, 20.10.93 17:19:27 by Kai Iske. LogMessage : --- Initial release ---