Club Amiga de Montreal

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

/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 294.lha / Mach_v2.6 / MachII.doc < prev next >

Wrap

Text File | 1989-10-08 | 50.6 KB | 1,253 lines

MachII Mouse Accelerator with Hotkeys (and other stuff). Version 2.6 09-25-89. (The unregistered version may be named MachII.UnReg) SetMach MachII configuration program. Version 2.6 09-19-89. Copyright 1988-1989 by Brian Moats --------------------------------------------------------------------- | | | Shareware arrangements have been changed with this release. | | Please note them! | | | | The freely distributable unregistered version has an opening | | window which will remain on screen for 10-15 seconds. | | | | If you send in $15.00, you will receive a registered copy with | | a serial number. The registered copy will have an opening win- | | dow telling you that it's running but it will disappear quickly. | | It is about 3k smaller but in all other ways, it is identical. | | | | MachII is constantly being improved. As a registered owner, you | | will be eligible for free updates and phone support. There are | | two methods for receiving updates. One is to simply send in a | | disk and SASE. When a new version is released, a copy will be | | sent to you. The other way is to wait until there is a new | | release and then send in a disk and SASE. You may send $2.00 | | instead of a disk and SASE. | | | | If you have previously sent in your shareware donation, you are | | already registered and you may send in a disk and SASE and you | | will receive a registered version in a few days. | | Please be sure to include sufficient postage on your SASE! | | | | The unregister version may be freely distributed but may not be | | used in any commercial product without prior written permission. | | The registered version is your personal copy and may NOT be dis- | | tributed. | | | | Contact Brian Moats at: | | Polyglot Software | | 10431 Ardyce Court | | Boise, Idaho 83704 | | (208) 375-3741 | | PeopleLink - BrianM | | CIS - 76167,2334 | |___________________________________________________________________| | >>>>>>>>>>> NOTE TO USERS WITH OTHER KEYBOARDS <<<<<<<<<< MachII's hotkeys now work with other keymaps! The many comments from European users have prompted this improvement. >>>>>>>>>>> NOTE TO 2.5 USERS: <<<<<<<<<<< MachII should load your 2.5 config file successfully but if you have any problems, try changing your settings with SetMach. If you cannot get a Special Function key to work, you probably need to delete your old config file, run MachII with the defaults and change them to what you want and save that. >>>>>>>>>>> NOTE TO 2.4 USERS: <<<<<<<<<<< MachII is now two separate programs. SetMach is the configuring program. SetMach will read both 2.4 and 2.5/6 config files while MachII will read only 2.5/6 configs. Run MachII, cancel the "mach .config Not Found. Using Defaults" requester, run SetMach, load your old config file and save it. >>>>>>>>>>> OTHER NOTES <<<<<<<<<<<< Throughout this document a "*" will indicate a place where some- thing new to 2.5 is discussed. A "**" indicates something new to version 2.6. The unregistered version may be named MachII.UnReg. If it is, use that name in place of MachII throughout this document. UDK indicates that the key is a user definable key. >>>>>>>>>>> INTRODUCTION <<<<<<<<<<< For those who hate doc files, just type "run MachII" and then "Cancel" the "mach.config Not Found. Using Defaults". Now acti- vate the clock window with your mouse and press the right button. The requester displayed has all of your options and hot- keys. Change them to what you like and save it. And try this: hit Alternate-Escape, then Amiga-F1, then type (for example) "diskcopy df0: to df1:", then hit Alternate-Escape again. Now press Amiga-F1. Also look at F1 in the requester. Read on if you're still interested. FEATURES Hotkeys 30 macros activated with the Function keys or the Amiga or Ctl-Amiga-Function keys or by typing the first few letters of the macro. Macros may be automatically recorded and may include mouse buttons. * Configurations Multiple configurations may be used and attached to windows by their title. Auto Execute Automatically execute macros at startup or at a specific preset time. Help Screen Display a chart with the current macro def- initions. Accelerator Speeds up mouse movements. Adjustable. PopCli Execute a NewCLI or any other command. Screen Blanker Blank or dim the screen after an adjustable period of time. Mouse Off Turn off the mouse after a specified number of seconds of no mouse activity or when a key is pressed. SunMouse Activate a window by moving the mouse into it. ClickToFront Move a window to the front by single or double clicking in any part of it. Cycle Move a window (or screen) to the back with the left then right mouse button combination. * Window Shuffler Send the front window to the back and the back window to the front with Left-Amiga-K and Left-Amiga-J. (User definable keys) Screen Shuffler Use Left_Amiga-M to push any screen to the back. (Instead of just the Workbench) Clock Optional title bar clock with memory display, date and low memory warning. Alarm Set one alarm. Beeper Beep every 15 minutes. Adjustable. Meter Maintain online costs. Adjustable rates. Qualifier Accum Accumulate qualifiers to be added to a key or to mouse activity such as Workbench's extended selection. * Reset Preferences Reset your preferences to what they were when MachII was first started using Ctl-LShift- LAlt-LAmiga-ESCape. * Set Preferences Set preferences from a macro using \pconfig ** Mouse Buttons Lets you set remap all 3 mouse buttons to any key or qualifier. Or add qualifiers to mouse buttons. All features may be turned off. Unused hotkeys are passed through and may be defined on the fly. See the SPECIAL KEYS section near the end for a description of all user definable keys. 2.6 UPDATE: a. Other keymaps are now supported. b. Ctl-Left-Amiga-S (UDK) suspends everything and turns off the clock. MachII will wait for Ctl-Left-Amiga-S to start again. c. Mouse buttons may be remaped to any key or qualifier, even a middle button whose default is set to Shift. d. The mouse accelerator has been modified. Should be more useful with small movements. e. Mouse Off has been changed. Instead of using SetPrefs() to turn it on or off, MachII uses the OFF_SPRITE macro which will turn off all sprites. f. SetMach now has a larger, better organized window. g. The text for the Special Functions gadget may be cus- tomized for non-English users. h. The text for month and day names may also be customized and the date display may be changed to other formats. i. The normal and playback priorities may be adjusted. j. You can copy macros from one key to another with the "Copy" gadget. k. A help screen with all escaped characters is available by pressing "Help" from SetMach. OVERVIEW: Note: UDK indicates that the key is a user definable key. MachII is a utility program that provides many optional features for both CLI and WorkBench users (although it cannot be started from an icon). Your own configuration may be saved to disk. Each function key may be used as a hotkey and their macros may be recorded on the fly. They may also include mouse button clicks. Other features include a SunMouse that automatically activates the window that the pointer is over, ClickToFront which allows you to bring a window to the front by single or double clicking in any part of it and many clock features. It is very easily configurable to your own desires. If you don't like a feature, just turn it off. Run the configuration program by either activating the clock and pressing the right button or by typing Control-Left-Amiga-Escape (UDK). A configuration file is not necessary but without one you will get the defaults. You will also get a "mach.config Not Found. Using Defaults" requester. After you have setup your macros and other options, you can save this to the file s:mach.config by clicking on "Save". * New to 2.5 are multiple configurations. A linked list is kept which you can add or delete too. Each configuration may be attached to a window and activated by clicking in that window. As an example of the flexibility and power of MachII, (and to show why there is so many seemingly useless escaped characters) this macro will toggle the Workbench screen to interlace and change your preferences: (Assuming that you have wbLace in c: and a system-configuration (preferences) file named sys-con.lace in devs:) Endcli\N\z\Xc:wbLace\\pdevs:sys-con.lace\\z\XNewShell "Newcon:0/0 /640/400/AShell" It ends the current shell, toggles the clock off, executes the program wbLace, changes preferences, toggles the clock back on, and finally creates a new shell. USAGE: * First, place SetMach and MachII in your current or c: directory. Then type: Run MachII (or "ARun MachII NOIO" if you have ARun). After it is running, you may either activate the clock with the mouse and press the right button or press Control-Left-Amiga-ESC (UDK) or type SetMach. You do not need to use "Run". This will run SetMach which has a requester jammed full of gadgets. All options and hotkeys may be modified here. You may put "Run MachII" in your startup-sequence (after your path command). EndCLI will not close the CLI window unless you use either "ARun MachII NOIO" or "RunBack MachII". ARun is from ARP and RunBack is public domain. NOTE: Do not rename SetMach or MachII won't be able to find it. SETMACH: The gadgets are grouped somewhat into common categories. Near the top are: Toggle between Amiga, Control-Amiga and no qualifier hotkeys. * Move through the configurations with the up/down gadgets. * Title of window to attach this configuration too. * Add a new configuration to the list. * Delete a configuration. The maximum macro size. Select each hotkey with the 'Fn' gadgets. The macro definition for the selected hotkey. * Clear 1 macro with 1 click or up to 10 with 2 clicks. c/ce ** Copy a macro to another key. Amiga-ESC execute string. Mouse Features: Activate/deactivate SunMouse. Select 0, 1 or 2 clicks for Click To Front. See Caution below. Select Window Cycle on or off. Mouse Off delay (0-99 seconds). Mouse acceleration rate (0-9). Clock Features: Toggle the Clock. Select Clock Front or Clock Depth. Select WBScreen, Screen Depth, or Clock To Top. Select Clock Only, Mem Only or Clock+Mem. * Toggle between 12 and 24 hour clock time. Set the alarm time. 24 hour format. Toggle Online Meter. Reset Online Meter. Select online rate. ($00.00 - $99.99) Set the Clock's left edge. Set the Clock's top edge. Set the seconds to alternate time and date. 0=time only. Set the memory level to receive low memory warning. Select beep interval (0-999 minutes). Special Functions: Step through the special functions. Click on the left side to step down and on the right side to step up. Select a key for the special function. Select the qualifiers for the Special Functions Keys. ** Priorities: Change the normal and playback priorities. Blanking: Select blanking delay (0-99 minutes). Dimness level. 0 = Black, 15 = no change. Extras: Activate/deactivate the Amiga-M Screen Shuffler. Activate/deactivate the Qualifier Accumulator. Configuration File Handling: Configuration file name. Load configuration file. Save configuration file. Miscellaneous: Done (can also press <return>). ** Help - Display a help screen with escape characters. Remove MachII. HOTKEYS: There are 30 hotkeys; 10 Function keys, 10 Amiga-Function keys and 10 Ctl-Amiga-Function keys. "Hotkey" referred to here will mean any one of these. Macro will mean the definition given to a hotkey. In the requester you can select each Function key with the 'Fn' gadgets and select the Ctl-Amiga/Amiga/None gadget. The macros may be edited in the string gadget. The default maximum macro size is 255 characters but this may be changed in the size gadget. You cannot change the size while you are creating a new macro and the new macro size will not take effect until you select "Done". This controls the size of dynamic buffers which are allocated only during macro definition or when the requester is up. The actual macros take up only as much space as they need. The hotkeys may be toggled on/off by pressing Left-Amiga-H (UDK). When they are off, a red or orange (pen 3) bar is displayed on the right edge of the clock. Macros are invoked either by hitting the hotkey or by hitting Shift-Alternate-Escape (UDK), then type some of the first letters of the macro and then return. The first macro found that matches will be executed. If none is found there will be a beep. See the Special Keys section for changing the keys used. * New to 2.5 is the "c/ce" gadget. Clicking once will clear the selected macro. Clicking twice will clear all macros from the selected one up to F10 for the active qualifier. When a macro is executed that is longer than 40 characters or has a pause in it, "Executing Macro..." is displayed in the clock. ** You can copy a macro from one key to another. First, select the macro to copy from, then click on "Copy". With the pointer that now says "TO", click on the Fn gadget of the macro to copy to. You may first click on the qualifier gadget before the Fn gadget. Defining Macros: To define a macro, type Alternate-ESCape (UDK), then a hotkey and then type your macro. During these steps, you will be prompted by messages in the clock and by beeps. You may use any keys in- cluding qualifiers, arrow keys, numeric keypad keys and mouse buttons. When finished, hit Alternate-ESCape (UDK) again. You may now use your macro by hitting the selected hotkey or by hitting Shift-Alternate ESCape (UDK), enough characters to uniquely match the macro followed by return. You may also edit the macro in a string gadget by hitting Control-Amiga-ESCape (UDK) or by act- ivating the clock window and pressing the right mouse button. You may also enter your macro directly in the string gadget but NOT while recording. Some people have been trying to press Alt-ESC, a function key, and then clicking in the string gadget. That is not what should be done...either record it live, or enter it in the gadget...not both! Sample recording and playback session: Special keys are in <>. <Alt-ESC><Amiga-F1>Diskcopy df0: to df1:<Alt-ESC> 'Diskcopy df0: to df1:' is now bound to the Amiga-F1 combination. To play this back, you can type either: <Amiga-F1> Or <Shift-Alt-ESC>dis<Return> The second method searches until it finds a macro whose first letters match 'dis' and then plays the rest back. This is useful if you don't remember the function key but do remember what it begins with. If you also had a macro that began with 'disp' and it was before 'diskc...', and you typed only 'dis' the first one matching 'dis' would be played back. In this case you would need to type 'disk'. You may start a recording period, do a series of complex editing commands and then replay all of it. Or edit it and save for later use. This is especially useful when using word processors that don't have macro abilities built in. * Control-H may be used to correct a keystroke without recording the backspace. (If you are using a keymap that has "H" in a dif- ferent location, you must use the key that has the key code of 0x25.) ** MachII will now correctly record and playback keys when other keymaps are used. Although dead keys will be recorded, they can- not be played back. Help Screens: A help screen with the macro definitions partially displayed in a * chart can be popped up by pressing Alternate-Help (UDK). Press it again to close the screen. \hnnn may be used in a macro to specify the height of the screen and display the help. Help opens an interlaced screen if the front screen is interlaced. Use \h or Alternate-Help to remove the screen. ** A help screen with all of the escape characters is available by either clicking on the "Help" gadget or by pressing the Help key. Recording mouse clicks: Mouse clicks may be recorded or entered in the string gadget. When a click is detected, MachII puts in the mouse's position, which button and whether it is pressed or released. For example: "\Mx155\My075\Mld" when played back, the mouse will be moved to x = 155, y = 75 and a left button down will be sent. A \Pnn will be inserted for every second delay between clicks. This will allow for menus to drop or requesters and windows to open. You may delete them from your macro if not needed. Do not depend on the SunMouse to activate a window on playback. The mouse will be moved to the same position as when recorded which may or may not be over the desired gadget or icon. A qualifier such as Shift (\S) will be placed before a \M and will have effect over the mouse movement and the first click. e.g. \S\Mx330\My122\Mld. When a menu item has a subitem it may be neccessary to bring the mouse down to the menu item, click the left button on it, then move the mouse over the subitem and click the left button or re- lease the right button. Sometimes gadgets will not respond to a quick button down/up. It may require a pause of 1 second between the down and up (\P1). Escaped keys: (These are shown in SetMach's help window) The escape character "\" may be used for the following: \N Newline (return). \T TAB. \E ESCape. \D DELete. \B BACKSPACE. \\ Backslash. \H HELP. \u Up arrow. \d Down arrow. \l Left arrow. \r Right arrow. \0 Numeric pad 0. . . \9 Numeric pad 9. \. Numeric pad ".". \- Numeric pad "-". \e Numeric pad ENTER. $ Numeric pad "(". (Amigas 500 and 2000 only) $ Numeric pad ")". " " \* Numeric pad "*". " " \+ Numeric pad "+". " " \/ Numeric pad "/". " " \F1 Function key 1. . . \F0 Function key 10. Note that is F0, not F10! \y Write the current date in the short form. \Y Write the current date in the long form. See Date Text in the Clock section for more about \y and \Y. \b Instant screen blanking. \f Load config file using name following f. * \c Change to the configuration whose title follows c. * \p Set preferences to the config file following p. * \z Toggle the clock on or off. \X Execute the string following X. \Pnn Pause nn seconds. \Q Quit. Remove MachII. \G Beep. \a Automatically execute the macro following "\a" upon startup. More than one macro may have the \a and all will be executed. First executed are the Amiga Function keys 1-10, then the Ctl-Amiga Function keys 1-10, then the Function keys 1-10 with no qualifiers. The \a may be followed by a time in 24 hour format. The macro will be executed at that time. e.g. "\a1045\G" At 10:45, beep. \h Display or close a help screen with macro def- initions. Use \hnnn to specify the screen height. Minimum height = 52. More commonly used in 2.5 and later is the Alternate-HELP (UDK) key. These last thirteen are unique in that they cannot be recorded live but must be entered in the string gadget. (The \P is however also recorded between mouse clicks). * If \ffilename and \ctitle are terminated with a "\", execution will continue after the new configuration is made active at the first character position of the same hotkey. Otherwise, execution will stop after the configuration is loaded or changed. \Xstring and \pconfiguration must be terminated with a "\" if not at the end of the macro. e.g. "\XNewCLI\Dir\N" or "\XRun Comm\\F1\F2". Note the two \s after "Comm". One terminates the "\XRun Comm" string and one introduces a function key. Usually, you would want to use "Run" in your command string to keep from suspending MachII. \M Mouse info follows this. \Mxnnn Set Mouse x coordinates. \Mynnn Set Mouse y coordinates. \Mld Send left button down. \Mlu Send left button up. \Mrd Send right button down. \Mru Send right button up. If you turned on recording and simply pressed the left button, you might see something like this for the macro: \Mx152\My\095\Mld\Mx152\My095\Mlu unless you moved the mouse between clicks in which case the x and y values would change. Qualifiers modify the key or mouse activity immediately following these: \C Control. \S Shift (either one). \A Alternate (either one). \L Left-Amiga. \R Right-Amiga. An example: \Cc\u\A\S\l This plays back the key combinations: 'Control-c' 'up-arrow' and 'alternate-shift-left-arrow' ** You do not need \S or \A before any character that is print- able. For example Alernate-e displays the copyright symbol. You can use just © instead of \Ae. Auto Execution: \annnn is the auto execution command. If nnnn = 0 or is omitted, the macro will be automatically executed when MachII is started. An example: "\a\XNewCli" will open a new CLI window automatically when MachII is first run. If nnnn equals a time of 0001 to 2359, the macro will be executed at that time. Another example: "\a930\XNewcli CON:220/50/200/50/Alarm\Call Joe\G\P3\CX EndCLI>nil:\N" At 9:30 this will open a newcli in the center of the screen, print the text "Call Joe", beep, pause 3 seconds, delete (control-x) the text and end the CLI window. Note the "\" terminating the newcli string. One more example: "\a1200\Xecho >speak: "Lunch time. Why not take 2 hours?" Assuming that you have mounted the device "speak:", at 1200 o'clock your generous Amiga will say what is in the quotes. The first macros executed are the Amiga Function keys 1-10, then the Ctl-Amiga Function keys 1-10, then the Function keys 1-10 with no qualifiers. \a macros may also be executed manually. The clock need not be displayed for this feature to work. Preference setting: You can change your preference settings by using \pconfiguration in a macro. The "configuration" is a file saved by Preferences. For example: "\pdf0:devs/RedConfig" will read in a file in df0:devs named RedConfig and set your preferences to that. You can recall your original preferences with the awkward combo: Ctl-LShift-LAlt-LAmiga-ESC (Not UDK) MULTIPLE CONFIGURATIONS: Let's assume that you've set up the SunMouse, some Function keys, and other features that work well in a shell. Now you want to run a program like WordPerfect. Well, WordPerfect doesn't like the SunMouse and it uses the Function keys. You could disable MachII when running WP, but I, for one, don't want to do that. Another alternative is to add another configuration to the one that you have already set up and modify it to work with WP. To do this, select "Add" in SetMach. This will make a duplicate configuration and number it "2". Deselect the SunMouse and select "None" for your qualifiers for the hotkeys and double click on "c/ce". This clears all no-qualifier function key macros. Next, in the gadget to the left of "Add", type in " WordP" (notice the space before the WordP, that's like it is in the title bar). Now whenever you click in a WordPerfect window, this configuration will become the active one. In your first configuration, you should type in the title "AmigaShell" or whatever is in the title bar of your shell. * You may have as many configurations as you like. Each one may be attached to a window through its title and activated by clicking in its window. The first null titled configuration will be activated when no title matches. The title need be just long enough to uniquely match a window's title. The "@" as the 1st character will lock a configuration which may then only be changed with SetMach or by executing a macro that has a title following \c or with Control-Left-Amiga-C (UDK). Delete a configuration with the "Del" gadget. Multiple configurations are all saved together under one filename. When a new configuration is made active, its title will appear in the clock for about one second. If the clock is identical to the clock in the previously active configuration, it will not be closed and reopened. Note that you must click in the window to change configs, even if SunMouse activates it. MISCELLANEOUS: * Left-Amiga-H (UDK) toggles all hotkeys on/off. Function keys not assigned to a hotkey string are passed through. Escaped letters are case sensitive. Function key numbers are single digits. This means that 0 is F10, 1 is F1, 9 is F9. Macros may not be used for input during a \Pause, but other keys may be. A macro may be aborted during execution with the ESCape key. ** When a macro is played back to the console device, and the play- back priority is set above the console device, the entire macro is pumped into the system before any of it is displayed. You may set the priority to 5 or lower for simultaneous playback and display. If a hotkey is embedded in a macro and the macro for that hotkey is null, the key is passed through. Otherwise the macro is executed. ACCELERATOR: The accelerator speeds up mouse movements. Set this from 0 - 9. 0 = no acceleration. NEWCLI: The Amiga and ESCape combination will create a NewCLI. You need to have NewCLI and Run in the c: directory. The NewCLI will have the same size stack as MachII. You can change this command in the execute string gadget. A full window example is: "NewCLI CON:0/0/640/200/MyCLI" or "NewShell NEWCON:0/0/640/200/ MachShell". You can also use the \X feature in a macro to execute a string. For AmigaDos 1.3 you can, of course, use NewShell instead of NewCLI. The default string is "NewCLI" SCREEN BLANKER: After 5 minutes of no mouse or keyboard activity, the screen will dim. You can change the delay and dimness defaults in the "Delay" and "Dim" gadgets. Valid dim values are 0-15 with 0 equaling black and 15 no dimming. The numbers 0-6 are the only really useful values. 0 blanks the screen by opening a new screen in front. The other values dim only the front screen. You can use \b in a macro for instant blanking. 0 delay disables blanking. MOUSE OFF: After 10 seconds of no mouse activity, the mouse pointer will disappear. The delay is adjustable with the "Mouse Off" gadget. ** Turning the mouse off is done by turning off ALL sprites. This technique is different from earlier versions. There were too many conflicts with other programs when Preferences were changed. Normally, sprites are used only in games so if you are playing a game and you lose something, it may be the mouse that did it! Sometimes a program will turn the mouse back on and it'll stay on until you move it to reset its timer. You may get a vertical bar occasionally when the mouse turns off. This is most likely to happen on a "morerowed" screen with the mouse near the bottom. If this happens, simply move the mouse. SUN MOUSE: The window that the pointer is over becomes the active window after the first mouse movement. To be able to drag icons, the SunMouse is disabled while the left button is held down. The top window will also become active when Amiga-N or Amiga-M is used. You still need to click in the window to change configurations. Turn on or off with the "SunMouse" gadget. CLICK TO FRONT: You can single or double click in any part of a window and bring it to the front. CAUTION! Due to a bug in the intuition.library, clicking to front over an icon may cause a lockup. You may run a program by David Jenkins called WTFPatch3 (included in this archive) to fix this. Select 0, 1, or 2 clicks with the "Click" gadget. Default is 2: CYCLE: You can push the window that is under the mouse to the back by holding the left button down and clicking the right button (the opposite of extended menu selection). If there are fewer than 2 windows, the screen will be pushed to the back. Turn on or off with the "Cycle" gadget. * WINDOW SHUFFLER: You can use Left-Amiga-J (UDK) to bring the back window to the front and Left-Amiga-K (UDK) to send the front window to the back. The new top window will become the active window. SCREEN SHUFFLER: Left_Amiga-M will push the front screen to the back instead of pushing workbench to the back. Left_Amiga-N will still bring the workbench to the front. This is useful if you have more than two screens on at once, especially if they don't have screen depth gadgets. The window under the mouse will become the active window. Turn on or off with the "Amiga-M" gadget. ** PRIORITIES: You can set both the normal and playback priorities. The console device has a priority of 5 so when the playback priority is set above this, the entire macro is pumped into the system before any of it is displayed. You may set the priority to 5 or lower for simultaneous playback and display. You may set the normal priority anywhere from -99 to 99, but you should use only values from -5 to 6. MachII will not respond if its priority is below that of a task that is hogging the CPU. This means that PopCLI and many other features will not work until the other task does a Wait() or terminates. Normally you should use a priority of 0-5 but you may just want MachII to wait and you should then use -1. If you really just want MachII to wait, you can use Ctl-Left-Amiga-S to suspend it. Use the lowest priority that works for you. I use 1 for both. QUALIFIER ACCUMULATOR: Many disabled people find it difficult if not impossible to type key combinations such as Control-Shift-F1. MachII has the ability to remember qualifiers that are pressed and add them to the first non-qualifier key pressed. So you could for example, type Shift, Alternate, and then F1. The Shift and Alternate would be added to the F1 just as if they were pressed at the same time. This is not intended for someone who doesn't need it as it sometimes may cause unexpected results. For example, if you type Alternate and then change your mind, the Alternate will still be added to the next key pressed. Pressing Caps Lock or the right mouse button will reset the qualifier accumulator. This may also be used with Workbench's extended selection. Hit the Shift key, then click on your icons. Hit any non-qualifier key or the right mouse button to clear the Shift. * Pressing a qualifier twice will clear that qualifier. An orange or red (pen 3) bar will appear on the clock's left edge when there are qualifiers accumulating. All qualifiers will stay on until pressed again time if you first press Alternate-CapsLock. Turn on or off with the "Qual Accum" gadget. CLOCK: There is a title bar clock that displays available memory and the time. The clock is updated every second and brings itself to the front (if covered up) every 4 seconds. Sometimes this covers up information in the title bar so if you don't like this use the "Clock Front" / "Clock Depth" gadget. This disables the auto to front and adds an (almost) invisible depth gadget. The date can alternate with the time and memory display. The length of time that the time is displayed is adjustable with the "Date Delay" gadget. Select 0 to display the time only. The date is also dis- played when the clock window is active. ** Date Text: If MachII finds the file s:mach.names, it will read it in and set the month and day names and the date format. This file must be in the following format: No lines longer than 10 characters, 12 lines of month names fol- lowed by 7 lines of day names followed by 1 line of 3 characters of date format. The date format can be mdy, dmy, ymd etc. The date output by the short form \y will be displayed accordingly as will the "Clock Only" display. If you select dmy, the long form \Y and the "Clock+Mem" will display DD. Month Year. You cannot display the year first or second this way. (y = year, m = month, d = day). A German file might look like this: Januar Febuar Marz April Mai Juni Juli August September Oktober November Dezember Sonntag Montag Dienstag Mittwoch Donnerstag Freitag Samstag dmy Clock and Memory Only: You can select "Clock Only" and get the clock and date displayed together in the format "mm-dd-yy hh:mm:ss" or select "Mem Only" and get the memory display without the clock. Low Memory Warning: The time and memory are displayed in red (pen 3) if your total free memory falls below 50k. You can change this value in the "Low Mem" gadget. Twenty-four hour clock: * You can toggle between a 12 and 24 hour clock with the "Hrs" gadget. * You can put \z in a macro to toggle the clock on or off. Positioning the clock: You can change the clock's left and top edge in the requester gadgets "ClockLE" and "ClockTE". These are the current left edge and top edge for the clock. You can position the clock then run SetMach and save the new pos- ition. The width for the clock alone is 146 pixels. Memory only display is 170 pixels. The clock with memory display is 250 pixels wide. The Clock and other screens: There is a gadget above the "ClockTE" gadget that will let you make three choices. 1. WBScreen - The clock will remain on the workbench screen. 2. Screen Depth - This adds an invisible depth gadget to the left edge of the clock. With it you can place the clock on other screens. 3. Clock To Top - The clock will automatically pop to the top screen. Options 2 and 3 replace the CloseScreen vector to allow MachII to close its windows. Selecting option 1 or removing MachII will put back the original vector. If another program also replaced the vector, you will be given the opportunity to terminate that program before the original vector is replaced. If you get a requester with the message "CloseScreen Vectors Were Changed!", either terminate the program that changed the vectors and click Retry or just click Cancel. You cannot change these options while on another screen. If WBScreen is selected, the vectors are NOT changed. * You can use Left-Amiga-C (UDK) to pop the clock to the top screen. Screen Depth mode will be automatically be selected. Turn the clock on or off with the "Clock" gadget. A bar drawn with pen 3 (usually red or orange) will appear on the right edge of the clock when the hotkeys are disabled. ALARM: You may set 1 alarm time in 24 hour format. When it goes off, it will beep longer than the interval beeper and the screen will flash. Set to greater than 2400 for no alarm. Note that with the auto execute feature (\annnn) you may create all sorts of fancy alarms. BEEPER: There is a beeper (to keep you awake) which defaults to a 15 minute interval. Change this in the Beeping gadget. \G may be used in a macro to beep; prompt for user input for example. METER: MachII has an online cost meter. Use the "Meter" gadget to toggle between the meter and the clock. Use the "Reset" gadget to reset the meter. The rate that it uses may be set in the "Rate" gadget. The meter runs continuously whether visible or not. The default rate is $4.75. * RESET PREFS: Use Ctl-LShift-LAlternate-LAmiga-ESCape to reset your preferences to what the were when MachII was first started. SPECIAL KEYS / USER DEFINABLE KEYS / MOUSE BUTTONS: There are 14 special functions selectable from all possible keys and qualifiers. They all have default values but these may be changed in the requester. Clicking on the right half on the gad- get will cycle up through the functions, clicking on the left half will cycle down. If there is a file named "s:mach.functions" it will be read in and the text substituted for the default text. Start/Stop This starts or stops a macro definition or learning period. Type the key combination, then type the hotkey that you want this macro to be bound to, then type your macro. When finished, type the key combination again. This ends the learning period. You may now execute the macro by typing the hotkey. You may also view or edit the macro in the string gadget in the requester. Default key = Alternate-ESCape. Execute This executes the NewCli command. You may change the executed command in the requester. Default key = Left-Amiga-ESCape. SetMach This executes SetMach just like activating the clock and pressing the right button does. Default key = Control-Left-Amiga-ESCape. Matcher This is used to find and execute a macro. To match, type the key combination, then type enough letters to match the desired macro, then type 'return'. The rest of the macro will be executed. Default key = Shift-Alternate-ESCape. * W To Back Send the front window to the back and activate the top window. Default key = Left-Amiga-K. * W To Front Send the back window to the front and activate the top window. Default key = Left-Amiga-J. * Clock Top Pop the clock to the top screen. Default key = Left-Amiga-C. * Next Confi Make the next configuration in the list the active one. Default key = Control-Left-Amiga-C. * Help Display the help screen. Default key = Alternate-HELP. ** Suspend Toggle MachII on and off. Just puts MachII in the background waiting for the keystroke again. Default key = Control-Left-Amiga-S ** L Button This (also M Button and R Button) enables you to set your mouse buttons to a key or qualifier. If you select a qualifier only, that qualifier will be added to your mouse clicks. If you select a key that key will be sent instead of the mouse button. Pressing your selected qualifier with the button will pass a normal mouse button through. Select nothing in the "Key" gadget and no qualifiers to omit this feature. A common usage for this is to set no key for the left mouse button and the Shift qualifier. This will allow you to do extended sel- ection in Workbench without holding down Shift.You must hold down the Shift key and press the left button for a normal deselect. If you have a middle mouse button, you may use it for the shift key. Default for left and right button: Key = Nothing Qualifier = Nothing. Default for middle button: Key = Shift Qualifier = Shift. ** M Button See above. ** R Button See above. * Mac On/Off Toggle the macros on and off. A red bar (pen 3) will appear on the right edge of the clock when the macros are off. Default key = Left-Amiga-H * Note that selecting both C= and Amiga means that you must use both the Left-Amiga (C=) key and the Right-Amiga key. The special keys are entered in the "Key:" gadget. You may use any key but they must be entered correctly. Usually just the first two letters are needed for these: TAB, ESC, F1-F10, DEL, BACKSPACE RETURN, HELP, UP, DOWN, LEFT, RIGHT, ENTER, SHIFT, AMIGA, C=, LALT, RALT, CTRL and CAPS. All numeric keypad keys must be prefaced with "K". All other keys by just using what is on the keycaps. If you use a qualifier, be sure to also select that qualifier just below it. Example: "K" is the letter "K" while "K9" is the keypad 9 key. A "." is the period while "K." is the keypad period. The 500 and 2000 have 5 keys that the 1000 doesn't, the numeric keypad "(", ")", "*", "+", "/" which all should be K(, K), K*, K+, K/. ** Non-English users may customize the text used to describe each key. If there is a file named "s:mach.functions" it will be read in and the text substituted for the default text. There must be no more than 10 characters per line and 14 lines total. They must be in order! The default file would look like this: Start/Stop Execute SetMach Matcher W To Back W To Front Clock Top Next Confi Help Suspend L Button M Button R Button Mac On/Off UNINSTALL: Use the Remove gadget in SetMach to uninstall MachII or \Q in a macro. * Or run MachII a second time. MISCELLANEOUS: When a string gadget (or any gadget anywhere) is active, the SunMouse will not work. When WordPerfect has a requester up, it tries to keep the requester's window active. If MachII has the SunMouse option on, every mouse move will activate a window and then WP will activate its requester's window. The only thing to do is turn off the SunMouse or hold down the left button. (I use a second con- figuration (with a title of WordP) with sunmouse turned off and the clock moved over off of the extra gadget.) This program will NOT work from Workbench. Put it in your startup- sequence. In order to keep the current path, MachII does not detach from the CLI. Use RunBack or ARun to allow the CLI window to close. Also, run MachII after you have set your "path". MachII may fail to run for any number of reasons (e.g. no free signals, insufficient memory). You will be informed of this if it is started with the Run command. If started from RunBack (public domain program that will allow the CLI window to close and available on Fred Fish disk # 65) and MachII fails, you won't get any messages. The ARP command ARun may also be used. The NewCLI brought up by Amiga-ESC will have a stack the size that was set when MachII was run. Many programs that you may run from this CLI need a larger stack, so either set the stack before running MachII, or after you get a NewCLI, use the stack command to set your stack to a larger value. If programs mysteriously crash when run from the NewCLI, it may be caused by a small stack size. The default stack size is 4000. Many programs need 10000. MachII uses the Execute function "Run" which will not be found if it has been made resident. MachII will inherit the path as it was set when MachII was run. If you bring up a new CLI and find yourself in a directory that you don't want, it is because that was the current directory when MachII was run. This is commonly SYS:c. If the macro size is set too small and you try to load a config file with longer macros, the macro size gadget will be updated to the largest macro . If you set the size too small and then select "Done" then activate the requester again, the macro size will be set to the size needed for the largest macro. Let me know if you find any incompatibilities with other pro- grams. UPDATES: a. Other keymaps are now supported. b. Ctl-Left-Amiga-S (UDK) suspends everything and turns off the clock. MachII will wait for Ctl-Left-Amiga-S to start again. c. The mouse buttons may be remaped to any key or qualifier. Even a middle button whose default is set to Shift. d. The mouse accelerator has been modified. Should be more useful with small movements. e. Mouse Off has been changed. Instead of using SetPrefs() to turn it on or off, MachII uses the OFF_SPRITE macro which will turn off all sprites. f. SetMach now has a larger, better organized window. g. The text for the Special Functions gadget may be cus- tomized for non-English users. h. The text for month and day names may also be customized and the date display may be changed to other formats. i. The normal and playback priorities may be adjusted. j. You can copy macros from one key to another with the "Copy" gadget. k. A help screen with all escaped characters is available by pressing "Help" from SetMach. 2.5b Internal. 2.5a a. You may use Ctl-H for backspace when recording macros without the backspace being recorded. You cannot delete mouse clicks though. (!) b. When recording, each keypress has an audible click. c. MachII's priority has been lowered to 5. 2.5 a. MachII has been split into two separate programs. A configuring program SetMach, and MachII itself. SetMach may be invoked either by running it like any program, by activating the clock and clicking the right button or with the combination Control-Left-Amiga-ESC (UDK). It will detach so you don't need to "Run" it. b. Multiple configurations are supported and each may be attached to a window by its title. Select a config- uration by clicking in a window that has a config- uration with the same title. Cycle through the con- figurations with Control-Left-Amiga-C (UDK), or with the up and down gadgets in SetMach. c. Mouse Off works better with some programs (like UEdit) and turns the mouse off when any non-qualifier key is pressed. d. Has a 12 or 24 hour clock. (*Some* people still like a clock). e. Running MachII a second time will remove it. Running SetMach a second time simply pops the first one to the top. f. Select a configuration from a macro with \ctitle. g. Send the front window to the back. Left-Amiga-K (UDK). h. Send the back window to the front. Left-Amiga-J (UDK). i. Pop the clock to the top screen. Left-Amiga-C (UDK). j. Pop up the help screen. Alternate-HELP (UDK). k. Disable/enable hotkeys. Left-Amiga-H (UDK). (Now Ctl- Left-Amiga-S) l. A red dot appears on the clock's right edge when hotkeys are disabled. (Obsolete) m. LeftMouse-RightMouse Cycle combination will send the screen to the back if the pointer is not over a window or is over a backdrop window. n. The special key qualifiers Left and Right Amiga are separate. o. A red dot appears on the clock's left edge when qualifiers are accumulating and qualifiers may be held if Alternate-CapsLock is first pressed. p. A hotkey may call itself without crashing. q. Use Ctl-LShift-LAlt-LAmiga-ESC to reset preferences to what they were when MachII was first run. r. Set preferences using \pconfiguration. Configuration is a file saved by Preferences. s. Toggle the clock from a macro with \z. Copyright 1988 by Brian Moats Polyglot Software 10431 Ardyce Court Boise, Idaho 83704 (208) 375-3741 PeopleLink - BrianM CI$ - 76167,2334 Other programs for the Amiga 500/1000/2000 from Polyglot Software: M18Cheater Lets you cheat in Mean 18 by causing your opponent to slice. Public domain. ----------------------------------------------------------------- FunBut Lets you use the F1 key instead of the left mouse button. It's useful when playing games like Defender of the Crown because it sends repeat mouse clicks. Public Domain. ----------------------------------------------------------------- 4 IN ONE Four easy to play games on one disk. SlotCars For 1 or 2 players, arcade type driving and shooting game. Seven screens, great graphics. CircuitMania For 1 or 2 players, surround your opponent in a maze of wires. ShufflePuzzle Like the sliding number puzzles that you used to play as a kid but this uses beautiful color pictures. Follow That Tune Follow the bouncing boy as he jumps from pedestal to pedestal playing musical notes. These games are integrated into an easy to use package. Enjoyable for all ages. All use digitized sound. Now only $14.95 ----------------------------------------------------------------- Dominoes 3d graphics, speech, tutorial. More entertaining and challenging than Shanghai. $12.95 ----------------------------------------------------------------- The Crossword Creator Make or solve crossword puzzles. 40,000+ word pattern matching dictionary, med-res or interlace, IFF compatible and many more features. $49.95