home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Club Amiga de Montreal - CAM
/
CAM_CD_1.iso
/
files
/
203.lha
/
Mach_v2.5
/
MachII.doc
< prev
next >
Wrap
Text File
|
1988-12-28
|
38KB
|
938 lines
MachII Mouse Accelerator with Hotkeys (and other stuff).
Version 2.5 01-11-88.
SetMach MachII configuration program.
Version 2.5 01-11-88.
Copyright 1988 by Brian Moats
This program may be freely distributed but may not be used in any
commercial product without prior written permission.
Source is available. Shareware donations ACCEPTED.
>>>>>>>>>>> NOTE TO 2.4 USERS: <<<<<<<<<<< >>>>>>>>>>> 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 config files while
MachII will read only 2.5 configs. Run MachII, cancel the "Can't
Find Configuration File" requester, run SetMach, load your old
config file and save it.
Throughout this document a "*" will indicate a place where some-
thing new to 2.5 is discussed.
Note: UDK indicates that the key is a user definable key.
For those who hate doc files, just type "run MachII" and then
"Cancel" the "Can't Open Configuration File!". Now activate the
clock window with your mouse and press the right button. The
requester displayed has all of your options and hotkeys. 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.
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.
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
All features may be turned off. Unused hotkeys are passed through
and may be defined on the fly. The configuration file is saved to
disk. See the SPECIAL KEYS section near the end for a des-
cription of all user definable keys.
UPDATES:
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).
l. A red dot appears on the clock's right edge when
hotkeys are disabled.
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.
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 "Can't Find Configuration File" requester.
After you have setup your macros and other options, you can save
this to the file s:mach.config.
* 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:
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
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.
NOTE: Do not rename SetMach or MachII won't be able to find it.
The gadgets are:
1st ROW
1st: Toggle between Amiga, Control-Amiga and None hotkeys.
* 2nd: Move up or down through the configurations.
* 3rd: Title of window to attach this config too.
* 4th: Add a new configuration to the list.
* 5th: Delete a configuration.
6th: Change the maximum macro size.
2nd ROW
1st: Select each hotkey with the 'Fn' gadgets.
3rd ROW
1st: Selected hotkey macro definition.
* 2nd: Clear 1 macro with 1 click or up to 10 with 2 clicks.
4th ROW
1st: Amiga-ESC execute string.
5th ROW
1st: Activate/deactivate SunMouse.
2nd: Select 0, 1 or 2 clicks for Click To Front.
3rd: Select Cycle on or off.
4th: Activate/deactivate the Amiga-M Screen Shuffler.
6th ROW
1st: Activate/deactivate the Qualifier Accumulator.
2nd: Toggle the Clock.
3rd: Toggle Online Meter.
4th: Reset Online Meter.
7th ROW
1st: Select Clock Front or Clock Depth gadget.
2nd: Select WBScreen, Screen Depth, or Clock To Top.
3rd: Select Clock Only, Mem Only or Clock+Mem.
8th ROW
1st: Set the Clock's left edge.
2nd: Set the Clock's top edge.
* 3rd: Toggle between 12 and 24 hour clock time.
4th: Set the seconds to alternate time and date. 0=time
only.
5th: Select online rate. ($00.00 - $99.99)
9th ROW
1st: Select blanking delay (0-99 minutes).
2nd: Dimness level. 0 = Black, 15 = no change.
3rd: Mouse off delay (0-99 seconds).
4th: Select beep interval (0-999 minutes).
5th: Set the alarm time. 24 hour format.
6th: Change the acceleration rate (0-9).
10th ROW
1st: Step through the special functions.
2nd: Select a key for the special function.
3rd: Set the memory level to receive low memory warning.
11th ROW
1st: Select the Alternate qualifier for a special function.
2nd: Select the Control qualifier for a special function.
3rd: Select the Shift qualifier for a special function.
* 4th: Select the Left-Amiga (C=) qualifier for a special
function.
5th: Select the Right-Amiga qualifier for a special
function.
12th ROW
1st: Configuration file name.
13th ROW
1st: Done.
2nd: Load configuration file.
3rd: Save configuration file.
4th: 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.
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 20 characters or has
a pause in it, "Executing Macro..." is displayed in the clock.
Defining Macros:
To define a macro, type Alternate-ESCape (UDK), then a hotkey and
the 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 or
by running SetMach. All of these special keys can be changed to
your own preferences. You may also enter your macro directly in
the string gadget.
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 learning 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.
Help Screen:
A help screen with the macro definitions partially displayed in a
chart can be popped up by using \h in a macro. Executing that
macro again will close the screen. \hnnn may be used to also
specify the height of the screen. You could use a height of
200, push the clock to that screen and open the requester and
have both available at all times. 52 is the minimum height. The
screen opens an interlaced screen if the front screen is inter-
laced.
* In version 2.5, you may use Alternate-HELP (UDK).
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 not be over
the desired gadget or icon. A qualifier such as Shift (\S) will
be placed before the first \M and will have effect over the mouse
positioning and the first click. e.g. \S\Mx330\My122\Mld.
Escaped keys:
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 ")". (Amigas 500 and 2000 only)
\* Numeric pad "*". (Amigas 500 and 2000 only)
\+ Numeric pad "+". (Amigas 500 and 2000 only)
\/ Numeric pad "/". (Amigas 500 and 2000 only)
\F1 Function key 1.
.
.
\F0 Function key 10.
\Y Write the current date in the long form.
\y Write the current date in the short form.
\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 is
the Alternate-HELP (UDK) key.
These last twelve are unique in that they cannot be recorded live
but must be entered in the string gadget. (The \P is however also
recorded during 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 "\XComm\\F1\F2".
Note the two \s after "Comm". One terminates the "\XComm" string
and one introduces a function key.
\M Mouse info follows this.
\Mxnnn Send Mouse x coordinates.
\Mynnn Send Mouse y coordinates.
\Mld Send left button down.
\Mlu Send left button up.
\Mrd Send right button down.
\Mru Send right button up.
Qualifiers modify the character 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'
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 <Nil: >Nil:" will open a new CLI window
automatically.
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.
The first hotkeys 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
Ctl-LShift-LAlt-LAmiga-ESC
Multiple configurations:
* 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).
Add a new configuration by clicking on the "Add" gadget. The
previous configuration will be copied into the new one as
normally you will want to make only minor changes. Anyway,
undoing a macro is easier than typing it in.
Delete a configuration with the "Del" gadget.
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.
Miscellaneous:
* Left-Amiga-H (UDK) toggles the hotkeys on and off. A small red
dot will appear on the clock's right edge when the hotkeys are
disabled.
Function keys not assigned to a hotkey string are passed through.
Escaped letters are case sensitive.
Note above that 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.
A macro may be aborted during execution with the ESCape key.
Use \A for any Alternate key sequences rather than entering the
actual Alternate-key in the string gadget.
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".
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.
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. This is adjustable with the "Mouse" gadget. CAUTION:
be sure that your pointer is visible when running Preferences. It
is best to turn off the Mouse Off feature by setting its value to
0 before running Preferences. Mouse Off may affect the Pref-
erences settings changed by other programs. When the mouse comes
back on, ALL Preferences settings are set to what they were when
the mouse went off.
* You can use the rather awkward combination of
Ctl-LShift-LAlternate-LAmiga-ESCape
to reset your preferences and restore your pointer.
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.
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.
Select 0, 1, or 2 clicks with the "Click" gadget.
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.
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. A tiny red
dot will appear on the clock's left edge when there are
qualifiers accumulating. All qualifiers will stay on until
pressed a second 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 except when the left button
is held down. 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 upfront 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 displayed when the clock window is
active.
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.
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.
SPECIAL KEYS / USER DEFINABLE KEYS:
There are 10 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.
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.
Requester This executes SetMach just like activating the
clock 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.
* Hot On/Off Toggle the hot keys on and off. Enables all
function keys to be passed through even if macros
have been assigned to them.
Default key = Left-Amiga-H.
* Reset Prefs This key combination is NOT user definable. It is
Ctl-LShift-LAlternate-LAmiga-ESCape and it will
set your preferences to what the were when MachII
was first started.
* 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, and ENTER. All numeric
keypad keys must be prefaced with "K" and all other keys by just
using what is on the keycaps.
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/.
UNINSTALL:
Use the Remove gadget 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 same
size as MachII. Many programs that you may run from this CLI need
a larger stack so either run MachII with a larger stack 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 the stack size.
Because MachII uses the Execute function, "Run" will not be found
if it has been made resident.
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.
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.
$29.95
-----------------------------------------------------------------
Dominoes 3d graphics, speech, tutorial. More entertaining and
challenging than Shanghai. $24.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