Otherware

home *** CD-ROM | disk | FTP | other *** search

/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / toolmana.lha / ToolManager / Docs / TM_English.doc < prev next >

Wrap

Text File | 1992-09-26 | 47.1 KB | 1,369 lines

ToolManager 2.0 Documentation ****************************** Copyright and other legal stuff ******************************** Copyright (C) 1990-92 Stefan Becker Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. No guarantee of any kind is given that the programs described in this document are 100% reliable. You are using this material at your own risk. The author *can not* be made responsible for any damage which is caused by using these programs. This package is freely distributable, but still copyright by Stefan Becker. This means that you can copy it freely as long as you don't ask for a more than nominal copying fee. This fee *must not* be more than US $5 or 5 DM. *This limit applies to German Public-Domain dealers too!!* Permission is granted to include this package in Public-Domain collections, especially in Fred Fishs Amiga Disk Library (including CD ROM versions of it). The distribution file may be uploaded to Bulletin Board Systems or FTP servers. If you want to distribute this program you *must* use the original distribution archive `ToolManager2_0.lha'. None of the programs nor the source code (nor parts of it) may be included or used in commercial programs unless by written permission from the author. *None* of the programs *nor* the source code (nor parts of it) may be used on any machine which is used for the research, development, construction, testing or production of weapons or other military applications. This also includes any machine which is used for training persons for *any* of the above mentioned purposes. Important notes **************** Welcome to the wonderful world of ToolManager 2.0 :-) - ToolManager and its concepts have drastically changed (see History) since the last release (1.5). - Starting with the ToolManager 2.0 release, this program has a *GiftWare* option. If you like the program and use it very often, you should consider to send a little donation to honor the work that the author has put into this program. I suggest a donation of US $10-$20 or 10-20 DM. Please don't send cheques or money orders from outside Europe, because most often cashing those items costs more than what they amount to. If you don't send the donation or can't afford it, you needn't feel bad about it. Please send me a note saying that you are using ToolManager anyway (I like to get fan mail :-). See Authors address. - Users of ToolManager 1.X can start with the quick installation chapter (see Quick installation). Some features haven't changed and the rest is fairly easy to find out by trial & error. For a detailed description of the new concept & features browse the reference part of this document (see Objects). You *must* remove any running ToolManager 1.X or the new version won't work. The new version cannot read the old configuration file format (Sorry). - First-time users should read the entire document to understand the concept and purpose of the program. Start with Introduction. - ToolManager 2.0 uses some features of AmigaOS Release V38, which should (hopefully) be available to all Amiga users by the time you read this. But if you are still using Release 2.0 (referred to as V37 in this document), you need not worry since ToolManager doesn't rely on these features. All extended V38 features are marked in this documentation. Where to send bug reports, comments & donations ************************************************ The author can be reached at the following addresses: Postal address: Stefan Becker Holsteinstrasse 9 5100 Aachen GERMANY InterNet Electronic Mail: stefanb@pool.informatik.rwth-aachen.de How to install ToolManager 2.0 the fast way ******************************************** The basic ToolManager 2.0 installation consists of the following four parts: `Libs/toolmanager.library' => `LIBS:' This is the main program of ToolManager. It handles all programs, menus, icons and docks (see Library). `Prefs/ToolManager*' => `SYS:Prefs' This is the editor for the configuration (see Preferences). `WBStartup/ToolManager*' => `SYS:WBStartup' With this utility you can start and stop ToolManager. If it resides in the WBStartup drawer, ToolManager gets always loaded when your machine boots up. `L/WBStart-Handler' => `L:' This program starts programs by the Workbench startup method. It is a seperate process, so that you can quit ToolManager even if you have still programs running that were started by it with the WB method. After copying these files, you should quit any older version of ToolManager running on your machine and double-click the ToolManager icon in the WBStartup drawer. Now you can start the preferences editor and play around (Use the "Test" button instead of the "Use" button while testing). You should be able to figure out most features with trial & error, for further information look into the ToolManager object descriptions (see Objects). What is ToolManager? ********************* ToolManager is a flexible program to manage the tools in your working environment. It can start Workbench and CLI programs as well as ARexx scripts. The user interface consists of menus, icons or dock windows. If you like a noisy computer, you can associate a sound to each of these items. See Sound. ToolManager can add items to the Workbench `Tools' menu. If you select such a menu item, the program associated with it will be started. Every selected icon on the Workbench will be used as an argument for the program. This feature is only available when the Workbench is running. See Menu. ToolManager can add icons to the Workbench window. When you double-click such an icon, the program associated with it will be started. If you drop some icons on this icon, the program will be started with these icons as arguments. This feature is only available when the Workbench is running. See Icon. ToolManager can create a dock window from a collection of programs. This window can be opened on every public screen. Each program is represented by an image or a button gadget. To start a program you simply click on the image or the button gadget. If the dock window has been opened on the Workbench screen and the Workbench is running, you can also drop some icons on the image or the button gadget to start the program with arguments. See Dock. Additionally you can assign a Hot Key to each program. If you press this Hot Key, the program will be started. Note that *no* arguments can be passed to the program if you use this startup method. See Exec. The concepts behind ToolManager ******************************** ToolManager 2.0 uses a new object-oriented approach to provide a flexible and extendable system. This approach made it possible to enhance several ToolManager features of the 1.X versions, e.g. you can now have multiple docks. An object is a collection of data which describes its features. Each object has a name and a type. You can create as many objects of each type as you want, but the name of each object has to be unique, because it is used as a reference to this object. Currently there are six different types of objects: Exec, Image, Sound, Menu, Icon and Dock. The first three of them are basic objects; that means they don't reference other objects. They provide data or services for the complex objects. The last three object types are complex objects; that means they reference simple objects and rely on them to get access to data or services. The reference is done by name, and if no simple object with this name exists, the complex object will ignore it. Note that this may reduce the functionality of the complex object, e.g. an Icon object *needs* the data from an Image object, so if this object doesn't exist it won't create an icon. For a detailed description of all object parameters see Objects. Description of all files in the distribution ********************************************* The ToolManager 2.0 distribution consists of several directories which are explained below. The Docs directory =================== This directory contains the documentation for ToolManager. The documentation is available in four different formats and several languages. Additionally there is a file in AutoDoc format describing the ToolManager shared library interface. Prefix `TM_<language>' This file contains the documentation for the specified language. Currently available languages are: Deutsch, English, Svenska. Postfix `.doc' This file contains the documentation as plain ASCII text. Postfix `.dvi' This file contains the documentation in TeXs DVI format. To get a printed manual, run this file through a TeX printer driver. Postfix `.guide' This file contains the documentation in AmigaGuide format. Although it is only plain ASCII with some commands, you need AmigaGuide to exploit the hypertext links in it. The author hopes that AmigaGuide will be available soon to all Amiga users. Postfix `.tex' This file contains the documentation in Texinfo format, as specified by the Free Software Foundation (FSF). Together with the `texinfo.tex' macro package, you can use TeX and `texindex' to create a file in DVI format (see above). `toolmanager.doc' This file contains the ToolManager shared library interface description in AutoDoc format. The Goodies directory ====================== This directory contains additional program packages which are useful for ToolManagers operation. `GetPubName.lha' This little program prints the name of the frontmost public screen either to stdout or into an environment variable. It was written by Michael "Mick" Hohmann. `upd1_20.lha' The program `upd' was written by Jonas Petersson. It is a small program which opens an ARexx port and waits for commands. Via ARexx you can order `upd' to play sampled files. ToolManager uses this feature to implement its Sound objects. See Sound. Users of ToolManager 1.5 may wonder why the utility `DeleteTool' is missing in this release. This utility may be replaced by the program `BlackHole' on Fish Disk #662. The Graphics directory ======================= This directory contains a rich collection of images from which you can choose your favourite ones. Just load them as Image objects into ToolManager (see Image). The files were contributed by various people (see Credits). Each of them got a seperate sub-directory in the distribution. As the files were created by different authors, they come from different environments (palette, depth, resolution, size) and have different design styles. So not all images may look good on your machine. To differentiate the image formats that are supported by ToolManager, each file has a postfix which describes the file format: `.anmb' This is an IFF ANIM file created by a paint/animation program. It can contain several pictures. Although ToolManager can load complete ANIM files, you must use something like DPaints "AnimBrush" feature to cut out the interesting part of the animation. `.brush' This is an IFF ILBM file created by a paint program. It contains only one image. `.info' This is a normal Amiga Icon created with IconEdit (or something similiar). It can contain two images. The L directory ================ This directory contains only one file, namely `WBStart-Handler'. You *must* copy this file to the `L:' directory, or otherwise ToolManager won't be able to start any Exec objects by the WB startup method (see Exec). The complete package WBStart 1.2 may be found on a Fish Disk. The Libs directory =================== This directory contains only one file, `toolmanager.library'. This is the main program for ToolManager and must be copied to the `LIBS:' directory. The Locale directory ===================== This directory contains all files for ToolManagers Locale support. As locale.library is new with V38, you need not copy these files if you are using V37. If you are using V38, choose the files for your language and copy them to the appropriate places. `Catalogs/<language>/toolmanager.catalog' This is a translation file for the specified language. Copy the file for your language to the directory `LOCALE:Catalogs/<language>'. `Languages/<language>.language' Some languages are not supported by the standard V38 Locale distribution. So some of the translators have supplied a `.language' file, so that ToolManager can use their translation files. Copy the file for your language to the directory `LOCALE:Languages'. Additional available languages are: Finnish (suomi), Eefeler Platt (eifel). The Prefs directory ==================== The ToolManager preferences editor and its icon reside in this directory. Copy both files to the directory `SYS:Prefs'. For further information on the editor see Preferences. The Programmers directory ========================== This directory contains all files which are needed by the various computer languages and their compilers to use the ToolManager shared library interface. Look into the sub-directory `examples' for some examples on how to use this interface. For a complete interface description read the file `Docs/toolmanager.doc'. Currently supported languages/compilers are: AmigaOberon, DICE C, M2Amiga Modula, MANX Aztec C and SAS C. The Scripts directory ====================== This directory contains a collection of ARexx or Shell scripts which can be used in ToolManagers Exec objects. Note that they may be specific to the authors environment or shell, so you may have to modify them. The Source directory ===================== This directory contains the complete source code to ToolManager 2.0 and its utilities. Each program has its own sub-directory. The author provides the source code as an example for OS 2.0 programming. The `locale' sub-directory is of interest for translators. If your language is not supported in this release and you want to do the translation, look at the file `empty.ct'. Just fill in the empty lines and send the file to me. Maybe it will be included in the next release. The WBStartup directory ======================== Only one program resides in this directory: `ToolManager'. This utility starts and stops ToolManager 2.0. Most of the time this utility will reside in the `SYS:WBStartup' directory, but it can be used from the Shell too. ToolManager objects reference ****************************** This chapter describes the ToolManager objects in detail. Each object has a type and a name. The name is used to reference the object. There are six different types of objects: Exec objects ============= Exec objects describe programs which are started by ToolManager. Three different types of programs are supported: CLI, Workbench and ARexx. Each Exec object has the following parameters. The defaults are set in parantheses: `Arguments' (Yes) This switch controls the handing over of arguments to the program. If a program doesn't support arguments or doesn't need them, you can switch off the argument passing. `Command' The file name of the program to start. This name may be relative to the current directory. `Current Directory' (`SYS:') The name of the current directory for the program. Note: ARexx programs ignore this parameter. `Delay' (0) After activation of an Exec object, ToolManager waits `Delay' seconds before it starts the program. If this value is negative, the program will be started every `Delay' seconds. To stop an Exec object which is waiting for execution, just activate it again. Note: If `Delay' is set, the program will be started without arguments. `Exec Type' (CLI) This specifies the type of the program. It can be one of: CLI, WB or ARexx. `Hot Key' You can set a Hot Key for each Exec object. If this Hot Key event is generated, the program will be started. Note: The program will be started with no arguments. `Output File' (`NIL:') This is the file name of the output file. This is only useful for CLI programs. `Path' (path from ToolManager process) This string sets the command search path for the program. You can specify several directories by seperating the names with a ";". This is only useful for CLI programs. `Priority' (0) This sets the priority of the new process which runs the program. `Public Screen' (default public screen) You can set the name of the public screen which should be moved to front before the program is started. This only works in conjunction with the `To Front' parameter. `Stack' (4096) This sets the stack size of the new process which runs the program. `To Front' (No) If you set this parameter the public screen specified by `Public Screen' is moved to front before the program is started. Image objects ============== Image objects specify the image data which is used by ToolManager for icons or docks. This object type has only one parameter: `File Name' This specifies the name of the file from which ToolManager should read the image data. ToolManager tries to detect the type of image data automatically: 1. It tries to load it as IFF data. Currently ToolManager can read ILBM (one image) or ANIM (two or more images) files. 2. It tries to read in an icon file. An icon can have one or two images. Animations are currently only supported by Dock objects. Icon objects only retrieve the first and the second image from the animation to build a two image icon. If you want to make an animation for ToolManager, you should follow these design rules: Image 1 This should be an image which represents the inactive state. Image 2 This should be an image which represents the selected state. Normally this is an inverted copy of the first image. Image 3 to N-1 These are the images for the animation. Each image will be shown for 1/3 of a second. Image N The last picture of the animation will be shown one second. After this the first picture will be shown again. Sound objects ============== A Sound object can be used to make ToolManager noisy. ToolManager itself has no ability builtin to play sound data, it uses ARexx to activate an external sound player daemon. This object type has two parameters: `Command' This sets the ARexx command which ToolManager sends to activate the external sound player. For `upd' this could be something like `file samples:boing' which instructs `upd' to play the IFF sample `samples:boing'. See Goodies. `ARexx Port' This specifies the ARexx port where ToolManager should send `command' to. The default is `PLAY' which is the port for the program `upd'. Menu objects ============= Menu objects control the entries in the Workbench Tools menu. The object name is used as the menu text. To activate such an object, just select the menu entry. Menu objects only work when the Workbench is running. This object type has two parameters: `Exec Object' This is the name of an Exec object which should be activated when the menu entry is selected. Every icon which is selected at this time will be used as an argument for the program. `Sound Object' This is the name of a Sound object which should be activated when the menu entry is selected. Note to ToolManager 1.X users: To simulate the old tool type "Dummy" just create a Menu object and specify *no* Exec and Sound object. Icon objects ============= Icon objects describe application icons in the Workbench window. Such an object can be activated by double-clicking the icon or by dropping some icons on the application icon. Icon objects only work when the Workbench is running. The parameters for this object type are as follows: `Exec Object' This is the name of an Exec object which should be activated when the icon is selected. Every icon which is dropped on the application icon will be used as an argument for the program. `Image Object' This is the name of an Image object. The image data of this object is used to build the application icon. `Left Edge' (default: 0) This sets the left edge for the application icon. `Show Name' (default: Yes) If this parameter is set, the object name will be used as the name for the application icon. `Sound Object' This is the name of a Sound object which should be activated when the icon is selected. `Top Edge' (default: 0) This sets the top edge for the application icon. Note: The Workbench is *very* picky about the position of icons. If you specify coordinates which the Workbench doesn't like, it will ignore them and place the icon somewhere else. Dock objects ============= Dock objects describe windows. These windows combine several tools which are represented by images or gadgets. To start such a tool just click on its image or gadget. Of course you can drop some icons on the image or gadget to supply arguments for the tool. Each dock object has several parameters. The defaults are set in parentheses: `Activated' (Yes) A dock window can be active (open) or unactive (closed). `Centered' (No) If this parameter is set, the window will always be centered to the current mouse position when it opens. `Columns' (1) This parameter sets the the number of tool columns. Tools are always sorted row-wise, starting at the leftmost column and filling up to the rightmost column. `Font' (Screen font) If you have a dock window with the parameter `Text' set, you can choose the font for the button gadgets with this parameter. `Frontmost' (No) If you set this parameter, the dock window will always open on the frontmost public screen. `Hot Key' You can set a Hot Key for each Dock object. If this Hot Key event is generated, the activation status of the dock window will be toggled; that is it will be closed or opened. `Left Edge' (0) This parameter sets the left edge of the dock window. If the parameter `Centered' is set, this parameter will be ignored. `Menu' (No) You can add a small menu to each dock window. This menu has two items: * `Close Dock' Close dock window. * `Quit TM' Quit ToolManager `Pattern' (No) The dock window automatically adjusts its size to the largest image. Each dock entry has the same size, and smaller images are centered, so they have a blank border around them. If you don't like this blank border, set this parameter and the border will be filled with a pattern. `PopUp' (No) When this parameter is set the dock window will be closed automatically after selecting one dock entry. This is especially useful in conjunction with the parameters `Centered', `Frontmost' and a Hot Key of the class `rawmouse' (see Hot Keys). `Public Screen' (Default public screen) Specifies the public screen on which the dock window should open. If the dock window was opened via Hot Key, the public screen will be moved to front after the window has been opened. This parameter will be ignored if the parameter `Frontmost' is set. `Text' (No) You can choose between images and button gadgets in dock windows with this parameter. Button dock windows are especially useful when used in conjunction with the parameter `PopUp'. `Title' This specifies the dock window title. If you supply a title, the dock window will be a normal OS 2.0 window with dragbar, close gadget, depth gadget and a border. If you *don't* supply a title, you will get a dock window with only a dragbar and *no* border. `Top Edge' (0) This parameter sets the top edge of the dock window. If the parameter `Centered' is set, this parameter will be ignored. `Vertical' (No) If the dock window has the new window design (that is: only a dragbar and no border), this parameter sets the orientation of the dragbar. This parameter is ignored if you supplied a window title with the parameter `Title'. The ToolManager preferences editor *********************************** With the preferences editor you can manage the global configuration of ToolManager. This configuration gets automatically loaded when you start ToolManager. To start the editor just double click its icon. You will then see the main window. Main window gadgets ==================== The main window has several groups of gadgets: Object type With this cycle gadget you can choose the type of objects that you want to create or edit. Object list This gadget shows the list of all objects of the current type. You can select an object by clicking on its name. If you double-click one item, an edit window will open. Move object When an object is selected, you can move it around in the list with these gadgets. If you click on the `Sort' gadget, the items in the list will be sorted alphabetically. Manipulate object These gadgets manipulate objects. The `New' gadget creates a new object of the current type which is selected automatically. When you click on the `Edit' gadget, an edit window for the selected object will open. With the `Copy' gadget you can make a copy of the selected object. The `Remove' gadget deletes the selected object. Configuration You have several choices to save the configuration. With the `Save' gadget you can save the configuration permanently into the file `ENVARC:ToolManager.prefs'. For a temporary change use the `Use' gadget, which will save the configuration into the file `ENV:ToolManager.prefs'. This file will not survive a machine reset. To test the new configuration without leaving the editor, use the `Test' gadget. The `Cancel' gadget will quit the editor without saving. Main window menus ================== The main window has several menu items: `Project' With the menu items `Open' and `Save As' you can load and save the configuration. The `About' item opens an information requester. Selecting the `Quit' item will leave the editor without saving. `Edit' With these menu items you can restore older configurations. The `Last Saved' item loads the last saved configuration from the file `ENVARC:ToolManager.prefs'. With the item `Restore' you can load the configuration that was active before you started the editor from the file `ENV:ToolManager.prefs'. `Settings' You can choose with the `Create Icons' item wether the menu item `Save As' should create an icon or not. Edit windows ============= Each object type has a different edit window to set the object parameters. For a detailed list of all object parameters see Objects. Every edit window has a string gadget for the object name. This name is important, because it is used to reference this object. Note that there is currently no builtin cross-reference. So if you change the name of an object which is already referenced by another object, this reference will *not* be updated. You have to update this reference by hand. The button gadgets in the edit windows open different types of requesters. You can choose an item by clicking on it and pressing the `OK' gadget, or you simply double-click it. To leave a requester without changes, use the `Cancel' gadget. If you wish to clear a field which can only be choosen by a requester, open the requester and press the `OK' gadget *without* selecting an item. The edit windows for the object types Exec and Image have an additional feature. You can simply drop an icon on them to set the parameters from this icon. Tooltypes ========== When you start the preferences editor from the Workbench you can set several tooltypes in the program icon or configuration file icons to control it. `USE' If you set this tooltype in an icon for a preferences file, the editor will install this file as current configuration file. `SAVE' If you set this tooltype in an icon for a preferences file, the editor will install this file as current and as permanent configuration file. `PUBSCREEN' This tooltype tells the editor to open its windows on a specific public screen. If you don't supply this tooltype, the default public screen will be used. `CREATEICONS' When this tooltype is set to `YES', the editor will create an icon for every preferences file that is created with the `Save As' menu item. `DEFAULTFONT' The editor normally uses the public screen font to draw its gadgets. If you set this tooltype to `YES', the editor will use the system default font instead. CLI Arguments ============== When the preferences editor is started from the shell, it uses the following command line template: FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,DEFAULTFONT/S `FROM' This parameter specifies the name of the preferences file which the editor should load. `USE' If you use this parameter, the editor will install the file specified as the `FROM' parameter as current configuration file. `SAVE' If you use this parameter, the editor will install the file specified as the `FROM' parameter as current and as permanent configuration file. `PUBSCREEN' This parameter tells the editor to open its windows on a specific public screen. If you don't supply this tooltype the default public screen will be used. `DEFAULTFONT' The editor normally uses the public screen font to draw its gadgets. If you use this parameter the editor will use the system default font instead. The ToolManager shared library interface ***************************************** The ToolManager handler is embedded into a Amiga shared library. This library offers several functions to create and manipulate ToolManager objects, so that you can use them in your programs. There are currently six functions available: `AllocTMHandle()' In order to create ToolManager objects you must first allocate a TMHandle. This handle stores all information about your objects and is used to reference them. Note that the information stored in this handle is *only* accessable by the program which creates it. `FreeTMHandle()' This function frees a TMHandle and all ToolManager objects associated with it. Each `AllocTMHandle()' must be matched with a `FreeTMHandle()'! `CreateTMObjectTags()' `CreateTMObjectTagList()' This function creates a ToolManager object. You must supply a name, the object type and various tags for the object parameters. The name of the object is important, as it is used to reference the object. `ChangeTMObjectTags()' `ChangeTMObjectTagList()' You can modify the parameters of a ToolManager object with this function. The object state will be updated to reflect the new parameters. Note: Currently Image objects can't be modified. `DeleteTMObject()' With this function you can delete a ToolManager object. If the object is linked to other objects, these objects will be notified to update their state. `QuitToolManager()' This function tells the ToolManager handler to quit as soon as possible. The complete library interface description is available in AutoDoc format (see Docs). How to define a Hot Key ************************ This chapter describes how to define a Hot Key as an Input Description String, which is then parsed by Commodities. Each time a Hot Key is activated Commodities generates an event which is used by ToolManager to activate Exec objects or to toggle Dock objects. A description string has the following syntax: [<class>] {[-][<qualifier>]} [-][upstroke] [<key code>] All keywords are case insensitive. `class' describes the InputEvent class. This parameter is optional and if it is missing the default `rawkey' is used. See InputEvent classes. Qualifiers are "signals" that must be set or cleared by the time the Hot Key is activated; otherwise no event will be generated. For each qualifier that must be set you supply its keyword. All other qualifiers are expected to be cleared by default. If you want to ignore a qualifier, just set a `-' before its keyword. See Qualifiers. Normally a Hot Key event is generated when a key is pressed. If the event should be generated when the key is released, supply the keyword `upstroke'. When both press and release of the key should generate an event, use `-upstroke'. The key code is depending on the InputEvent class. See Key codes. Note: Choose your hot keys *carefully*, because Commodities has a high priority in the InputEvent handler chain (i.e. will override existing definitions). InputEvent classes =================== Commodities supports most of the InputEvent classes that are generated by the input.device. This section describes those classes that are most useful for ToolManager Hot Keys. `rawkey' This is the default class and covers all keyboard events. For example `rawkey a' or `a' creates an event every time when the key "a" is pressed. You must specify a key code for this class. See rawkey key codes. `rawmouse' This class describes all mouse button events. You must specify a key code for this class. See rawmouse key codes. `diskinserted' Events of this class are generated when a disk is inserted in a drive. This class has no key codes. `diskremoved' Events of this class are generated when a disk is removed from a drive. This class has no key codes. Qualifiers =========== Some keyword synonyms were added to Commodities V38. These are marked with an `*'. `lshift', `left_shift' * Left shift key. `rshift', `right_shift' * Right shift key. `shift' Either shift key. `capslock', `caps_lock' * Caps lock key. `caps' Either shift key or caps lock key. `control', `ctrl' * Control key. `lalt', `left_alt' * Left alt key. `ralt', `right_alt' * Right alt key. `alt' Either alt key. `lcommand', `lamiga' *, `left_amiga' *, `left_command' * Left Amiga/Command key. `rcommand', `ramiga' *, `right_amiga' *, `right_command' * Right Amiga/Command key. `numericpad', `numpad' *, `num_pad' *, `numeric_pad' * This keyword *must* be used for any key on the numeric pad. `leftbutton', `lbutton' *, `left_button' * Left mouse button. See note below. `midbutton', `mbutton' *, `middlebutton' *, `middle_button' * Middle mouse button. See note below. `rbutton', `rightbutton' *, `right_button' * Right mouse button. See note below. `repeat' This qualifier is set when the keyboard repeat is active. Only useful for InputEvent class `rawkey'. Note: Commodities V37 has a bug which prevents the use of `leftbutton', `midbutton' and `rbutton' as qualifiers. This bug is fixed in V38. Key codes ========== Each InputEvent class has its own key codes: Key codes for InputEvent class `rawkey' ---------------------------------------- Some keywords and synonyms were added to Commodities V38. These are marked with an `*'. `a'-`z', `0'-`9', ... ASCII characters. `f1', `f2', ..., `f10', `f11' *, `f12' * Function keys. `up', `cursor_up' *, `down', `cursor_down' * `left', `cursor_left' *, `right', `cursor_right' * Cursor keys. `esc', `escape' *, `backspace', `del', `help' `tab', `comma', `return', `space', `spacebar' * Special keys. `enter', `insert' *, `delete' * `page_up' *, `page_down' *, `home' *, `end' * Numeric Pad keys. Each of these key codes *must* be used with the `numericpad' qualifier keyword! Key codes for InputEvent class `rawmouse' ------------------------------------------ These keywords were added to Commodities V38. They are not available in V37. `mouse_leftpress' Press left mouse button. `mouse_middlepress' Press middle mouse button. `mouse_rightpress' Press right mouse button. Note: To use one of these key codes, you must also set the corresponding qualifier keyword, e.g. rawmouse leftbutton mouse_leftpress Examples for Hot Keys ====================== `ralt t' Hold right Alt key and press "t" `ralt lalt t' Hold left *and* right Alt key and press "t" `alt t' Hold either Alt key and press "t" `rcommand f2' Hold right Amiga key and press the second function key `numericpad enter' Press the Enter key on the numeric pad `rawmouse midbutton leftbutton mouse_leftpress' Hold middle mouse button and press the the left mouse button `diskinserted' Insert a disk in any drive. The History of ToolManager *************************** 2.0, Release date 26.09.1992 - Complete new concept (object oriented) - (Almost) Complete rewrite - ToolManager is now split up into two parts - Main handler is now embedded into a shared library - Configuration is now handled by a Preferences program - Configuration file format has changed again :-) It is an IFF File now and resides in ENV: - Multiple Docks and multi-column Docks - Docks with new window design - Dock automatically detects largest image size - Sound support - Direct ARexx support for Exec objects - ToolManager can be used without the Workbench. If the Workbench isn't running, it won't use any App* features. - Locale support - Path from Workbench will be used for CLI tools - Seperate Handler Task for starting WB processes 1.5, Release date 10.10.1991, Fish Disk #551 - Status Window: New/Open/Append/Save As menu items for config file - Edit Window: File requesters for file string gadgets - Added a Dock Window (a la NeXT) - Added a DeleteTool - A list of all active HotKeys can be shown - Tools can be moved around in the list - Icon positioning in the edit window added - Name of the program icon can be set - CLI tools can have an output file and a path list - Uses UserShell for CLI tools - Maximum command line length for CLI tools is now 4096 Bytes - AppIcons without a name are supported now - Workbench screen will be moved to front if you pop up the Status window - Workbench screen can be moved to front before starting a tool via HotKey - TM will wait up to 20 seconds for the workbench.library - Added a DELAY switch which causes TM to wait <num> seconds before adding any App* stuff - renamed some tooltypes/parameters - some visual cues added - some internal changes 1.4, Release date 09.07.1991, Fish Disk #527 - Keyboard short cuts for tools - AppIcons for tools - Menu item can be switched off - Configuration file format completely changed (hopefully the last time) - CLI commandline parsing is now done by ReadArgs() - Status & edit window updated to new features - Safety check before program shutdown added - Menu item "Open TM Window" only appears if the program icon is disabled - WB startup method changed. Now supports project icons - several internal changes 1.3, Release date 13.03.1991, Fish Disk #476 - Now supports different configuration files - Format of the configuration file slightly changed - Tool definitions can be changed at runtime - Now supports CLI & Workbench startup method - Selected icons are passed as parameters to the tools - Now uses the startup icon as program icon if started from Workbench - The position of the icon can now be supplied in the configuration file - The program icon can now be disabled - New menu entry "Show TM Window" - Every new started ToolManager passes its startup parameters to the already running ToolManager process 1.2, Release date 12.01.1991, Fish Disk #442 - Status window changed to a no-GZZ & simple refresh type (this should save some bytes) - Status window remembers its last position - New status window gadget "Save Configuration": saves the actual tool list in the configuration file - Small bugs removed in the ListView gadget handling - Name of the icon hard-wired to "ToolManager" 1.1, Release date 01.01.1991 - Icons can be dropped on the status window - Status window contains a list of all tool names - Tools can be removed from the list 1.0, Release date 04.11.1990 - Initial release The author would like to thank... ********************************** ToolManager has gone through many major evolutionary phases since its first implementation in mid-1990. This development would have been impossible if I hadn't received the enormous feedback from various ToolManager users. Many ideas & features resulted from this source... Therefore I would like to thank: For Alpha/Beta testing, ideas & bug reports: Amiga section of our local computer club (Computerclub an der RWTH Aachen), Olaf 'Olsen' Barthel, Georg Hessmann (Gucky), Markus Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda), Juergen Weinelt, Brian Wright (SteveVai), Petra Zeidler (stargazer) and many others... Matthew Dillon Without your *excellent* C development system DICE and various other tools, ToolManager wouldn't exist! For their excellent graphics work: Andreas Harrenberg, Georg Hessmann, Michael "Mick" Hohmann, Markus Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan Peter, Matthias Scheler, Brian Wright For the Locale translations: Tomi Blinnikka (Finnish), Dr. Peter Kittel (German), Klaus Melchior (Eifel Platt), Rickard Olsson (Swedish), Marc Schaefer (French & Italiano) All gals & guys at West Chester: For developing the Amiga and its superb operating system. All users who sent me money: I didn't ask for it in the 1.X releases, but it's nice to see when someone appreciates my work. All users who sent me a note: I really enjoyed reading your letters! and all I forgot to mention... Index ****** TeX Docs ARexx scripts Scripts ASCII documentation Docs Address Authors address AmigaGuide Docs Bug reports Authors address CLI Arguments CLI Arguments Catalog files Locale Comments Authors address Compiler support Programmers Concepts Concepts Configuration Preferences Contributed images Graphics Copyright Copyright Credits Credits DeleteTool Goodies Diskinserted InputEvent classes Diskremoved InputEvent classes Distribution Copyright Distribution files Distribution files Dock objects Dock Docs directory Docs Documentation Docs Donations Authors address E-Mail Authors address Example images Graphics Examples for Hot Keys Hot Key examples Exec objects Exec Fast installation Quick installation GetPubName Goodies GiftWare Important Goodies directory Goodies Graphics directory Graphics History History Hot Keys Hot Keys Icon objects Icon Image objects Image Important notes Important InputEvent classes InputEvent classes Installation (quick) Quick installation InterNet address Authors address Introduction to Hot Keys Hot Keys Introduction to ToolManager Introduction Introduction to ToolManager objects Concepts Key codes for rawkey rawkey key codes Key codes for rawmouse rawmouse key codes L directory L Language files Locale Languages Locale Legal stuff Copyright Library documentation Docs Library interface Library Libs directory Libs List: rawkey key codes rawkey key codes List: rawmouse key codes rawmouse key codes List: Qualifiers Qualifiers Locale directory Locale Localization Locale Menu objects Menu Objects Objects Permissions Copyright Postal address Authors address Preferences editor Preferences Prefs directory Prefs Printed documentation Docs Probibitions Copyright Program concepts Concepts Programm versions History Programmers directory Programmers Qualifiers Qualifiers Quick installation Quick installation Rawkey InputEvent classes Rawmouse InputEvent classes Reference: Distribution files Distribution files Reference: Hot Keys Hot Keys Reference: Library interface Library Reference: Preferences editor Preferences Reference: ToolManager objects Objects Scripts directory Scripts Shared library interface Library Shell scripts Scripts Sound objects Sound Sound player Goodies Source code Source Source directory Source Texinfo Docs Thanks Credits ToolManager objects Objects ToolManager shared library interface Library Tooltypes Tooltypes Translations Locale Translators Source UPD Goodies V38 features Important Versions History WBStart 1.2 L WBStart-Handler L WBStartup directory WBStartup