home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Club Amiga de Montreal - CAM
/
CAM_CD_1.iso
/
files
/
294.lha
/
Mach_v2.6
/
MachII.doc
next >
Wrap
Text File
|
1989-10-08
|
52KB
|
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
