Welcome to ForcerIcon v1.3. 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 absolute positions or images.

ForceIcon is © 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 absolute 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.

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: >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 definition, 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. The main window is divided into two parts.

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.

Left ListView and buttons
=========================

The ListView gadget labeled 'Used Volumes/Devices' at the left side of the window shows all devices/volumes ForceIcon will act on. This is the list of entries you may edit. Double clicking on an entry from the list will bring up the edit window so you may edit the selected entry (see Edit entry).

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.

Below there are three buttons for editing, these are :

Edit entry...
     Same as double clicking on an entry from the list. It will bring up the edit window with all the data of the selected entry (see Edit entry).

Copy...
     This will let you copy the selected entry with all the settings that come with it. The manual input window will pop up asking for a new name for the copied entry, so that no doubles will be added to the list (see Manual input). ForceIcon will reject to accept doubles.

Remove from list
     Simple, I guess. This one will remove the selected entry from the list of used devices/volumes. Note: There will be no warning; just a delete.

Right ListView and buttons
==========================

This ListView gadget labeled 'Available volumes/devices' keeps a list of all available volumes/devices currently known to the system. You may double click on an entry in order to copy it to the 'Used volumes/devices' ListView (see Left ListView and buttons). Again, there are three gadgets below that ListView, which are :

Add to list
     This will act as if you have double clicked on an entry from the list. It will copy the selected entry to the 'Used volumes/devices' list, as long as it wasn`t added before, ie. you may not have more than one instance of an entry in that list.

Add manually...
     If a volume/device isn`t mounted yet, you may add it`s name manually using the manual input window (see Manual input).

Rescan list
     Will cause ForceIcon to re-scan the list of available volumes/devices in order to update the list of the ListView gadget. This might be of use, when a volume/device gets mounted after you`ve opened the main window.

Edit an entry
-------------

This is the window containing all the gadgets to customize an entry. There are 9 gadgets which will be explained more in detail now.

Volume
     This is the String gadget containing the volume`s/device`s name. Simply edit it, if you want to change the name of the monitored entry.

Type
     Allows you to change the type of entry you are editing. You may choose between 'Volume' and 'Device'.

CurrentX / CurrentY
     These Integer gadgets may be used to manually set the icon`s position. They will be updated if you move the position window. These gadgets won`t be active as long as you don`t specifiy 'IconPos'

Position
     Using this gadget you may open the position window, a small window which may be moved around your Workbench in order to determine the position of the icon. This gadget won`t be available as long as you don`t specify 'IconPos'

IconPos
     Using this gadget you may tell ForceIcon to 'patch' the position of the entry`s Disk.info file. If selected you may use the Position window or the Integer gadgets to determine the position of the icon. If not selected, the position of the selected entry`s Disk.info file will be set to NO_ICON_POSITION so that Workbench may choose a suitable location for it.

Icon
     Using this String gadget you may set the name of an alternative icon which should be used in place of the original Disk.info file. This one can only be used as long as 'Use Icon' is active. The GetFile gadget at the right of the String gadget may be used to select an icon file using a FileRequester.

Use Icon
     If you want to substitute the Disk.info of an entry, check 'Use Icon' and you may select an alternative Icon file.

Manual input
------------

This window is used to manually add a new name to the list of used devices/volumes or if you try to copy an entry. A window will pop up containing a String gadget and a Cycle gadget.

The String gadget may be used to enter the new device`s/volume`s name. Note, that you have to leave out the trailing colon of the device`s/volume`s name.

To determine the type of entry you are editing, use the Cycle gadget at the bottom of the window. You may choose between 'Device' and 'Volume'. This step is necessary because ForceIcon has to know how to deal with the entry.

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

Program history
***************

     Revision V1.3
     --------------
     created on Sunday, 02.01.94 15:31:32  by  Kai Iske.   LogMessage :
       - Code cleanup
       - Partial rewrite of docs

     Revision V1.2
     --------------
     created on Tuesday, 07.12.93 18:10:09  by  Kai Iske.   LogMessage :
       - Entries may be copied now

     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 ---