MSE_TRIX.TXT - A manual for Mouse Tricks and Read Text ½ 1990 Jonathan Lawrence Last modified 25/9/90 1/ Introduction 2/ How to use Mouse Tricks 3/ How to use Read Text 4/ Reference section - extra information. 5/ Notes on existing modes 6/ Getting out of trouble - what to do if you're stuck in a setting you don't want. - commit this to memory! 7/ Compatability and programming information 8/ Trademark acknowlegdements 9/ How to buy Mouse Tricks and Read Text - including overseas orders and foreign currency prices, copyright, file lengths and limitations of liability. *********************** 1/ Introduction Mouse Tricks is a desk accessory mouse utility that gives the user extensive control over mouse movement and menu style, and uses the right hand button to provide a range of special effects. An optional screen saver is also included. Mouse Tricks combines many of the functions of existing mouse utilities (promouse, speed mouse, rattrap, mouser, maccel ...) in a single desk accessory and adds extra functions of its own. All the functions of Mouse Tricks can be adjusted through a pair of dialogue boxes. As many as 25 different settings (or modes) can be named and saved, each having been adapted for use with a particular program. Each mode may then be installed automatically when the program of the same name is run. Mouse Tricks also contains a text reading utility, Read Text, (with find, position mark, block print and save functions) that permits the user to load, read and switch between as many as eight text files within any program that allows access to desk accessories. Originally developed to give easy access to the Mouse Tricks manual, Read Text is now a valuable utility in its own right. And since it's written in assembler, its very fast. In the demonstration version of Mouse Tricks the right hand button special effects and reporting modes are disabled after about 20 minutes running time. Also limited in the demonstration version, Read Text can only hold one text file at a time (instead of eight), and after the time limit has expired no new file can be loaded (although you can return to a document that is already loaded). If you buy Mouse Tricks you'll recieve the full Mouse Tricks accessory plus a stand alone Read Text accessory and a version of Mouse Tricks with the read text function removed (all without time limits of course). This allows you to select which functions you require, and if you want both, whether you want them on separate desk accessories. The non-demonstration version of Mouse Tricks takes up less disc space and memory - as it doesn't include the extra text and program code required by the demonstration version. I'd like to hear any comments you have on Mouse Tricks and Read Text - bugs found; improvements or extra features you would like; any shortcomings in this documentation; need for translations of program and/or documentation . . . . . . ******************* 2/ How to use Mouse Tricks To use Mouse Tricks the MSE_TRIX.ACC and MSE_TRIX.RSC files must be placed in the root directory (i.e. not in any folder) of your boot (or start up) disk. If you change resolution - then 'save desktop' and reset the computer afterwards. This prevents Mouse Tricks being loaded twice - saving memory and ensuring that the screen saver works properly. (reference section; 'screen saver') Once the computer has booted up, Mouse Tricks will install the settings of mode 0. To 'manually' change the mode or settings, or just to experiment, select the 'Mouse Tricks' entry in the 'desk' menu. This calls up the first dialogue box - which is used for the first level of adjustment: '>speed' and '>accn' ('>' prefixes each subject heading) are used to speed up the mouse - useful for programs where you want to cross the screen quickly. 'speed' selects the mouse step size. 'accn' (short for acceleration) magnifies the speed of mouse movement - magnifying it more the faster you move it. It has no effect on the slowest mouse speeds; enabling you to combine fine control (at slow speeds) with easy screen crossing (at faster speeds). 'speed' is adjustable from 1 (no effect) to 99 (unusable! see 'Getting out of trouble') 'accn' is adjustable from 0 (no effect) to 4 My favorite setting for word processing in high resolution is 'speed' = 2, 'accn' = 2 ( or 1,2 in medium or low resolution, with 'med res Xtra' active); the mouse has a nice elastic feel and not too large a step size. For freehand drawing applications you'll probably want no speeding up effects, but for any other application you'll probably find some speed or acceleration useful. (reference section: 'speed' and 'accn') (The character '>' prefixes each subject heading in the three sections 'How to use Mouse Tricks', 'How to use Read Text' and 'Reference section' - so search for '>whatever' to find just the subject headings, rather than each and every mention of 'whatever'.) '>menu style' selects between dropdown (the GEM standard) and pulldown (similar to that used on the Amiga and AppleMacintosh series) menus. The pulldown mode (which requires the left button to be pressed for the menu to drop) is most useful in graphics programs; where it is all too easy to wander accidentally into the menu bar. (reference section; 'menu style') '>screen saver' acts to prevent the image being 'burnt into' the screen when the computer is left unused (and switched on!) for long periods. If neither the mouse nor keyboard are touched for about 4 minutes then screen saving starts. A colour monitor will go black, and a monochrome monitor will periodically switch between a 'black on white' and 'white on black' display. Bumping the mouse or pressing a key (even a Shift, Alternate or Control key) will put the screen back to normal. You could turn the the brightness down instead! (reference section; 'screen saver') '>mouse mend' makes it less likely that GEM will miss changes in button state (for example, when a program fails to realise that you've stopped clicking on a button or scroll bar). 'mouse mend' needs to be deactivated for the text editor Tempus (and a mode has been set up for this purpose). (reference section; 'mouse mend') '>med res Xtra' doubles the horizontal (or X-axis) mouse movement when in medium resolution. This can be desirable because in medium resolution a pixel's (picture element) width is half its height. Right mouse button special effects can be selected within the central panel: '>shift' pretends that a shift key (the right hand one) is depressed. Holding it down allows you to select (or deselect) groups of files on the desktop with an individual left button click on each. Many programs also use the shift key to change the effect of mouse clicks and movements. '>dbl' emulates a left button double click when the right button is depressed - useful if you find double clicking difficult. '>clk delete' emulates a left button click (this is optional) followed by a keypress (usually the delete key - but can be any key combination). A common use is in word processing where a single action 'point and press' will delete a character or word. Emulating the 'Escape' key can be used on the desktop for refreshing the display of a disk drive's contents. Emulating the 'Return' key can be used to select the default button of a alert or dialogue box without actually needing to click on the button. (reference section; 'clk delete') '>hyperspace' has many options: to make the mouse jump around the screen in various ways on depressing and releasing the right button. to change the mouse step size and to magnify the horizontal step size while the right button is depressed. to emulate a left hand click on releasing the right button. (reference section; 'hyperspace') Hyperspace is most useful for menu selection (with the options and variables suitably adjusted): Depressing the right button makes the mouse leap up to the menu bar - whereupon it can be dragged down and released on the desired menu item - just like a pulldown menu. After the right button release the mouse jumps back to where it started. If you decide against selecting a menu item, then (for some versions of the operating system) simply releasing the right button will make the menu dissapear (providing the mouse started off beneath the currently displayed menu). (reference section; 'menu cancelling') If you prefer to jump to a often used menu heading, then hyperspace can be adjusted to jump both vertically AND horizontally to the desired spot. Hyperspace can also be used for jumping to and from blocks of icons (an additional left click, while in hyperspace, would be necessary to select an icon) - or, if the jumping options were disabled, it could be used simply to speed up the mouse. Hyperspace is especially useful on large screens where the are greater distances to be tranversed. These special effects are not often useful in programs that themselves use the right button - but there can be exceptions: when a program uses the right button to exit a particular mode of operation, it may be possible (and even useful) to use hyperspace to combine this function with that of menu selection. 'clk delete' (with the click disabled) may be used to delete objects within version 1.5 of GFA Draft Plus. Since the delete key has no effect in those situations where the program itself uses the right button, there is never any overlap between the right button's two functions (as long as both 'wait' and 'separate' are set to zero). Right button 'reporting' controls what the rest of the computer system is told about the state of the right button. '>hide' pretends that the right button is always up. It enables special effects to be used within programs that do not use the right button - but whose normal working is interfered with while the right button is depressed. (Many GEM programs (1st Word for example) will ignore left button clicks while the right button is depressed - so that right clicks must be hidden in order for 'clk delete' to work properly.) '>hold' improves the handling of programs that use the right button, but require it to be held down for a significant length of time before it is noticed. Once the right button is depressed, 'hold' keeps it depressed until an adjustable time after GEM has noticed that it is down. Thus every click, however brief, will be noticed by the program. (reference section; 'hold') The '>adjust' button calls up a second dialogue box that lets you adjust the 'clk delete', 'hyperspace' and 'hold' options. (reference section; 'clk delete', hyperspace', 'hold') '>OK' sets up the mouse to behave in the way you have just selected. '>CANCEL' cancels the adustments you have just made - and reinstates the previous settings. '>SAVE' functions like 'OK' - and it also saves the settings of all the modes onto disk. (In the demonstration version 'Save' is disable after the 20 minute time limit. This prevents modes that are meant to have right button special effects being saved without them.) '>mode select' Because Mouse Tricks has so many options and variables, it is useful to be able to save the settings that best suit a particular program or situation. You can save as many as 25 settings or modes, and each can be named after the filename (without extension) of the program it is designed for. To do this: Search through the modes (using the up/down arrows next to 'mode select') until you find one that is unwanted or unused. Adjust the settings as desired and type in the name of the mode. If you want the mode to be entered automatically when the program of the same filename is run - then 'auto' should be in normal type (enabled), not grey (disabled). Click on 'OK' to save your mode. If you look at another mode before clicking on 'OK' then all your adjustments will be lost. To save your settings (in all the modes) to disk (so that they are not lost when the computer is switched off), put your boot disk in the disk drive and click on 'save'. (If you have built up a collection of settings on one version of Mouse Tricks, and want to transfer them to another with a different filename - then change the name of the destination file to that of the source (say MSE_TRIX.ACC to MSE_DEMO.ACC) using the 'show info' desktop menu option, save the settings, then change the name back again.) After the computer has booted up, Mouse Tricks will always be in mode 0. It's a good idea to adjust mode 0 to the setting you use most often. Then you only need to use the other modes for programs that require different settings. When a program is run, Mouse Tricks looks through its list of modes for a one of the same name - and if a mode is found and has 'auto' enabled then it is installed. If no matching name is found, the current mode is left installed. You can at any time (whether on the desktop or within a program) select any setting or mode you desire 'manually' using the dialogue boxes. When a program terminates Mouse Tricks switches back to the mode it was in before the program was run. (reference section; 'mode select') *********************** 3/ How to use Read Text '>Read Text' is a mouse controlled text reading utility that can hold up to to eight different files simultaneously - and switch from one to another at the touch of a button. For each loaded file the user can: - scroll up and down through the text (by line or page), - jump to the top or bottom of the file; - mark up to eight places to return to later; - search up or down for any given sequence of letters (case sensitive or insensitive); - print out or save a highlighted section of the text; all by clicking on a single array of buttons. When you quit Read Text, back to the desktop or program you are running, the files that you want to keep are preserved in memory, waiting for you to return. Multiple document handling (not available in the demonstration version): The numbered boxes at the top right of the screen allow you to load up to eight text files into Read Text - and switch between them. Each ticked box holds a file, and clicking on it will display it. Clicking on an unticked box will call up the file selector to load a file. The box that holds the currently displayed file is shown in reversed colours. Clicking on the close button (to the left of the document slots) throws away the currently displayed document, and switches the display back to one of the remaining documents. If none remains, then you quit Read Text back to the desktop or program you are running. (reference section; 'memory management') Handling the displayed document: The double row of buttons along the bottom of the screen affect only the displayed document. The central three pairs of buttons give the basic page/line up/down scrolling functions, and allow you to jump to the top or bottom of the document. A ping sounds when try to look beyond either end of the document. The '>mark'/'>jump' array allows you to mark up to eight places in the document to return to later. You mark a position by clicking in the 'mark' row of numbered buttons. The number then turns from grey to normal type, to show that a position has been marked. Clicking on the number again will unmark it - so you can get rid of old unwanted marks ready to introduce new ones. Clicking on the row of 'jump' buttons will jump to the corresponding marked position, or sound a ping if there isn't one. When at a marked position, the corresponding jump button is displayed in reverse colours. The up/down buttons to the left of the word '>find', search up or down for the sequence of letters that you have typed in to their right. A ping sounds if the sequence isn't found. The 'Aa' button on the far right selects between a case sensitive or insensitive search. Keying in RETURN or ENTER has the same effect as clicking the find down button. Typing in a desired sequence and pressing RETURN will therefore search for its next occurance. You define a block (displayed in reversed colours) for printing or saving by clicking on the displayed text itself. Clicking in the left most 1/4 of the screen selects the line to start the block, clicking in the right hand 3/4 selects the line to end it. Blocks can only consist of a whole number of lines. To get rid of a block, make it end before it starts! Read Text not only reads plain ASCII text files; it partially decodes some word processor file formats (1st Word for example), and can be used to find bits of text buried in program files. (reference section; >text decoding) In word processor mode (selected when the 'WP' button is in normal rather than grey type) Read Text removes 1st Word format lines when loading text, and saves text with soft and stretch spaces (to help reformatting), limiting the line length to 160 characters. This allows you not only to load and save 1st Word (and compatible) documents (albeit WITHOUT style and format information), but also to convert (crudely) between ASCII and 1st Word file formats. Leave 'WP' mode on, except when saving files with normal ASCII spaces, or when loading non-text files ( say .PRG, .ACC or .RSC files) to look through them for bits of text. (When you don't want large sections of the file following a format line code to be ignored.) The '>PAUSE' and '>EJECT' buttons provide different ways of leaving the Read Text utility: 'PAUSE' keeps the current file to return to later; so that the next time you click on 'Read Text' you jump straight back in where you left off. (reference section; 'PAUSE') 'EJECT' throws away the current file; so the next time you click on 'Read Text' one of the remaining documents will be displayed, or, if none remains, the file selector pops up to select a new file. The '>NEW' button throws away the current file and calls up the file selector to select your new file. If any line is too long to fit on the screen, the remainder of it is displayed on the next line down - which starts with a right pointing arrow to indicate that it is an overrun. Read Text works in all screen resolutions. In low resolution (on standard screen size) the 'mark/jump' buttons are removed in order to make room for some of the more vital buttons, and the 'Aa', 'WP' and buttons at the top of the screen will not be usable or visible. The 'find' function still works, although you will need to type blind beyond the first few characters. The scrolling speed of Read Text is considerably increased by using a 'software blitter' such as Quick ST or Turbo ST (unless you have a hardware blitter anyway). A replacement file selector will also make life easier. Martin Patzel's FSELECT and the Little Green Selector by Charles F. Johnson are good examples. The stand alone Read Text desk accessory (included when buying Mouse Tricks) gives the convenience of bypassing the Mouse tricks dialogue box at the cost of 6 Kbyte extra memory usage and a desk accessory slot (DCSTUFFER or MULTIDESK allow the use of more than 6 desk accessories). ******************** 4/ Reference section '>speed' and '>accn' On each mouse movement, the horizontal and vertical changes in mouse position are replaced with ones taken from a lookup table. The values in the lookup table are calculated according to the following formula: D = d*speed*(((accn+4)/4)exp(|d|-1)) (except when accn=4 and |d|=1 then D=speed) (D is truncated to + 127, - 128) where d is the initial horizontal or vertical change, and D is the one that replaces it. You'll notice that with the higher accelerations the direction of mouse movement becomes distorted; a circle becoming more like a square with rounded corners. '>menu style' The pulldown menu can be operated in two ways: 1) Give a brief left click (down and up) in the menu bar to pull the menu down - then click (in the same way) on the desired option (or in the space around it to cancel the menu). 2) Depress the left button in the menu bar to pull the menu down - then, keeping the button depressed, drag the mouse down and release the button on the desired option (or in the space around it to cancel the menu). This latter method requires just a single press and release of the mouse button. (see 'hyperspace' for my favorite method of menu selection) '>screen saver' After 4 minutes mouse and keyboard inactivity in monochrome mode, the display colours will be reversed for another 4 minutes, and then toggle between a 'white on black' and 'black on white' display every 2 minutes. I chose this slow switching rate to reduce the distraction it causes (for me anyway). If (when using a colour monitor) you change resolution without subsequently saving the desktop and resetting the machine, then Mouse Tricks will be loaded twice and two screen saving routines will be active. This can lead to the screen being blanked out permenantly (until a reset) as the second routine will save, and later restore, a blank palette. This can also occur if you load two versions of Mouse Tricks (say MSE_DEMO.ACC and MSE_TRIX.ACC) at the same time. Beware! '>mouse mend' With 'mouse mend' active (active means in normal rather than grey type), Mouse Tricks periodically monitors GEM's record of the button states, and attempts to correct it when it's wrong. 'mouse mend' can only work while the main program (or the bit of code in control at a particular time) allows access to desk accessories. An active 'mouse mend' can disrupt the scrolling functions of Tempus. I think the problem occurs as a result of Tempus taking over the mouse from Gem - and not letting Gem know about the button states whenever the mouse is in the scroll bars. The ÿmouse mend" function consequently keeps sending mouse and button packages in an attempt to correct GEM's false knowledge of the button states - and Tempus, recieving these packages, fails to realise that the left button has been held down for some length of time, and thus fails to scroll. '>adjust' calls up the second dialogue box which is used to adjust 'clk delete', 'hyperspace' and 'hold'. '>clk delete' On depressing the right hand button a key click sound and a brief left button click are made; the latter only if the box 'left click on press' is active. After the time given by 'wait', characters start to be poked into the keyboard buffer. This delay gives time (in wordprocessing applications for example) for the cursor to be moved to its new position before the characters start to arrive. The time interval 'separate' sets the maximum rate at which the characters from individual 'clk delete' presses, made before the 'wait' delay was complete, may be poked into the keyboard buffer. If the characters are poked in too fast then some word processors will ignore some of them. 'key 'select'' selects the keypress to be emulated. By default this is the delete key, but any key or key combination can be selected. The boxed display is the hex representation of the longword to be poked into the keyboard buffer, followed by the ASCII character (actually the system font) indicated. This ASCII character is in the L.S. byte of the longword. The keyboard scancode is in the L.S. byte of the M.S. word. Some programmers will find this display useful. '>hyperspace' On depressing the right button the mouse will jump to the active X (horizontal) and Y (vertical) coordinates displayed. If neither are active, then the mouse won't jump. 'jump 'select'' selects the position to be jumped to. The user simply moves the mouse to the desired position and presses 'RETURN'. While the right button is held down the mouse moves according to the hyperspace values of 'speed' and 'Xtra'. 'speed', as before, sets the mouse step size. 'Xtra' (adjustable from 0 (no effect) to 4) multiplies horizontal movement by 1 (no effect), 2, 4, 8 or 16. Its purpose is for use in menu selection, where the horizontal distance between headings in the menu bar is greater than the vertical distance between menu items. I find a value of 1 useful; doubling the horizontal movement. There is no 'accn' as a large step size is not undesirable in applications such as menu selection, and the elastic feel of 'accn' could well make the absolute positioning of the mouse more difficult. On releasing the right button the mouse has the option of jumping back to either or both of its previous X and Y coordinates. If neither are active, then the mouse won't jump back. There is also the option of giving a brief left hand click on the release of the right button. This permits the selection (or cancellation) of menus using the right button alone. >menu cancelling In version 1.09 (or 1.2) of the operating system menus can be cancelled simply by releasing the right hand button in the menu bar - provided that 'click on release' is active and the mouse started off beneath the currently displayed menu. (At the start of some programs, you need to first select a menu item, before this will work.) In the STE (version 1.6 of TOS), and possibly in version 1.4 also, this method of menu cancellation only works on the desktop. Whilst running a program, unwanted menus need to be cancelled with a left button click in the space around them - as per usual. It's not suprising that this should happen, as the almost simultaneous combination of 'jump back' and 'click on release' would seem likely to give an unpredictable result, which could vary with the individual situation and operating system version. It is just luck that this method of menu selection should work at all! '>hold' The time that the right button is held down for (following the discovery that GEM knows that it is down) is adjusted here. 0 ms (i.e. no time at all) will probably suffice for most programs that require 'hold', but those with particularly long program loops may require longer if right button clicks are not to be missed. The release of a 'held' right button is usually performed by the desk accessory part of Mouse Tricks. It will also be released by a left button click. This feature prevents the right button being immovably held down in situations where there is no access to desk accessories. '>mode select' Mouse Tricks keeps itself in the correct mode by monitoring the operating system calls used to execute and terminate a program. This can be confused if if a call is made to execute a program that doesn't exist at the specified pathname, since this call will fail and no subsequent terminate call will occur to match it. If, as a result of this unlikely event, Mouse Tricks ends up in the wrong mode, it can be readjusted 'manually' using the dialogue boxes. >text decoding Control characters (0-$19) are either ignored or interpreted in a particular way: 0 replaced by a space to improve legibility of null terminated strings in resource and program files. 9 tab expanded to up to eight spaces. $A LF - ignored $B conditional page break - this character and the one following it are ignored. $D CR - used as line end code $19 soft hyphen - replaced by hyphen $1B escape code - this character and the one following it are ignored. $1C replaced by space $1D replaced by space $1E replaced by space $1F replaced by space in non-WP mode. In WP mode the rest of the line is ignored. All other control codes are ignored. >memory management Sorry about the 'user unfriendly' details that follow. A possible solution for a future version would be for Read Text to grab hold of, and manage, its own chunk of memory - a bit rigid perhaps. Loading up several files - then throwing away the earlier ones (but keeping the later) will leave the computer's free memory fragmented. If you later run out of memory - then throwing away all the files (say by using the close button) and loading new files up from scratch may enable you to fit more in. Some programs take over most of the computer memory and leave little spare for Read Text to load files. You can get around this problem by loading the files from the desktop before running the program. If you later throw the files away within the program, then the memory they took up should become available for loading new files. ('>PAUSE') If you load and later pause on a file (or files) while within a program, then when you quit that program the memory that holds the text becomes unprotected and may later be written over with something else. This doesn't matter greatly - if the beginning of the text is corrupted, Read Text responds by searching for another loaded file and calling up the file selector if there is none. - if another portion of the text is corrupted, a "*** TEXT CORRUPTED ***" message is displayed. You can ensure that this doesn't happen by loading text files from the desktop. ********************* 5/ Notes on existing modes I have set up a few demonstration modes (mode 0 and mode numbers 24 downwards) to be installed automatically when the program of the same name is run. Experiment with them, write over them, delete them - whatever you want. If you want to keep them, but dont want them automatically installed, then disable the 'AUTO' option on each. mode 0; deskmode I have installed my favorite mode as mode 0 so that the computer starts off in this mode and stays in it until another is selected or auto installed. 'speed' and 'accn' are both set at 2 for high resolution. In colour I would use a 'speed' of 1 with 'med res Xtra' active to give equal vertical and horizontal movement in medium resolution. 'hyperspace' is used for menu selection, with the right hand button hidden to keep the menu behaviour completely normal. (If right button reporting is normal then leaping up to either side of the active part of the menu bar, then moving sideways into it will not select a menu.) 'speed' in hyperspace is high (6) to permit menu selection with as little hand movement as possible. 'Xtra' = 1 gives double the horizontal movement to select between menu titles. tempus (assuming the program is called 'TEMPUS.PRG') In this mode the 'mouse mend' function is disabled so as not to disrupt the scrolling functions of Tempus. (reference section; 'mouse mend') gfadraft This mode is for the latest release (version 3.13) of GFA Draft plus. It 'holds' the right hand button down so that even the briefest click is registered. draftpls This mode is for version 1.5 of GFA Draft plus. Not only does it 'hold' the right hand button down, it also uses 'clk delete' (with no 'left click on press')to delete objects. Since the delete key has no effect in those situations where the program itself uses the right button, there is never any overlap between the right button's two functions (as long as both 'wait' and 'separate' are set to zero). This doesn't work in the later version of the program as the delete always has an effect. degelite Since Degas Elite uses the right button to switch between control panel and canvas, I've set the right button handling to normal. For freehand drawing you might prefer the 'speed' = 1 and 'accn' = 0, instead of the current high resolution settings of 2,2. littleuk Similar settings to Degas Elite for the English translation of the monochrome painting package Little Painter. calamus Also no right button effects. BigScrn (This cannot be auto installed, so needs to be selected 'manually' or setup as mode 0 on your BigScrn boot disk.) If you are lucky enough to have a large screen monitor - or if you use the large screen simulator BigScrn - then you should find hyperspace, pull down menus and reasonable values of accn especially useful. The entry for o-line explains why. o-line The demonstration version I have requires a very long 'hold' time (200ms) (and the left button could do with some holding too!). I use a virtual large screen (BigScrn at 1664 * 800 pixels) with O-line and then use Alt-Help to save the whole screen as an 162.5 Kbyte .IMG file for printing out at high resolution (240 * 216 dpi on a 9 pin printer) using the demo version of Megapaint II. (There is just room for this on a 1 Mbyte machine.) 'accn' helps to sweep over to the icon block with a flick of the wrist, and a pull down menu prevents menus dropping accidentally. I have also included hyperspace menu selection - but as this interacts not entirely satisfactorally with the program's own use of the right button, you might prefer to set the special effects to normal. All other modes are set up as 'normal' (although 'screen saver', 'mouse mend' and 'med res extra' are active). They are spare slots waiting to be set up as you wish. Try 'clk delete' on your word processor or text editor. If it's fast enough, you can decrease the 'wait' and 'separate' times - which were setup for 1st Word. You may need to 'hide' right button clicks in order for the emulated left click to be noticed and the text cursor to move to its new position. 'clk delete' can be useful for correcting typing errors after you've completed a document; one hand stays on the mouse to delete unwanted characters and scroll the document while the other types in the single letter corrections. ********************* 6/ Getting out of trouble If Mouse Tricks is adjusted to an undesirable setting that you cannot undo with the dialogue boxes (because, say, 'speed' = 99, or 'hide' is selected when a right button click is required, or the program doesn't allows access to desk accessories), then the following procedure will undo all Mouse Tricks effects (other than screen save and mouse mend): Hold down together for six seconds both mouse buttons and the three keys; left shift, alternate and control. Mouse Tricks will be disabled at some time during the six seconds following their release. Mouse Tricks can subsequently be reinstalled by clicking 'OK' or 'CANCEL' in the first dialogue box. ********************* 7/ Compatability and programming information Mouse Tricks steals the following vectors (jumping back to the original vector after its own routines are completed): trap 1 for monitoring execute and teminate calls mousevec for reprocessing mouse packages curv for monitoring and modifying cursor movement ikbdsys for screen saver monitoring of keyboard and mouse activity. for monitoring and modifying keypresses while adjusting clk delete. etv_timer occasionally stolen - as a 50Hz timer for keyboard emulation while using clk delete. The address of each original vector will be inserted immediately before the routine that replaces it. Programs that themselves steal these vectors may bypass some of the functions of Mouse Tricks ('hide' and 'hold' for example). If they fail to jump on to my routines, or if they modify the data that is passed on, then Mouse Tricks may behave strangely. Mouse Tricks also installs a vertical blank routine. Because of the use of vectors, Mouse Tricks cannot be unloaded (say by DC STUFFER or MULTIDESK) as can some desk accessories. This shouldn't be a problem with the stand alone Read Text accessory. Mouse Tricks and Read Text have been developed on version 1.2 (1.09) of TOS with HiSoft's Devpac ST. It has been tesed on version 1.6 (STE) without finding any bugs (thanks to Silica Shop) - but do test the demonstration version on your system with your software before you buy. ******************** 8/ Trademark Acknowledgements ATARI, ST, and TOS are all registered trademarks of Atari Corp. Degas Elite is a registered trademark of Batteries Included. GEM is a registered trademark of Digital Research Inc. Amiga is a registered trademark of Commodore Business Machines Inc. Apple and Macintosh are registered trademarks of Apple Computer Inc. 1st Word is a registered trademark of GST Holdings Ltd. GFA Draft Plus could well be a registered trademark of GFA Systemtechnik GmbH. Turbo ST and Quick ST might also be registered trademarks. Tempus may be a trademark of Creative Computer Design. ****************** 9/ How to buy Mouse Tricks and Read Text To receive the full versions of Mouse Tricks and Read Text - without time or other limits - send a cheque or postal order for œ5.00 to me: Jonathan Lawrence 76 Sistova Road London SW12 9QS U.K. Don't forget to include your address! For overseas orders I can accept a cheque in your own currency for the following amount: Australia $ 17.00 Austria SCH 140.00 Belgium FR 410.00 Canada $ 15.00 Denmark KR 75.00 France FR 70.00 Ireland œ 7.40 Italy LIT 14500.00 Japan YEN 2000.00 Netherlands FL 22.50 New Zealand $ 22.50 Norway KR 75.00 Spain PTA 1200.00 Sweden KR 75.00 Switzerland FR 17.00 USA $ 12.50 West Germany DM 20.00 All cheques (other than Eurocheques) must be in the native currency of the bank that they are drawn against. Eurocheques (for 5.00 pounds sterling) must have your Eurocheque guarantee card number written on the back of the cheque. I can also accept your money via Girobank, Postgiro or CCD transfer (this method should cost you less than a foreign cheque if you transfer direct from your own account). State in your order that you have transfered 5.00 pounds sterling to my account, and I will send on the disk as soon as I recieve acknowledgement of the payment. (Also tell me your account number - in case its the only information that I receive in the acknowledgement.) My account number is 56 510 2613 (or in words; five six, five one zero, two six one three) For orders outside Europe that are paid in a European currency - add the equivalent of 0.50 pounds sterling to cover the extra mailing cost. On receipt of your order/payment I will send you a single sided disk containing four desk accessories (all but the first in their own folder): The full Mouse Tricks accessory: MSE_TRIX.ACC file length 17296 bytes MSE_TRIX.RSC file length 5724 bytes memory used 30 Kbyte with no text files loaded (+ MSE_TRIX.TXT) A stand alone Read Text accessory: READ_TXT.ACC file length 9198 bytes READ_TXT.RSC file length 2378 bytes memory used 18 Kbyte with no text files loaded The Mouse Tricks accessory with the read text function removed: MSE_ONLY.ACC file length 10377 bytes MSE_ONLY.RSC file length 3316 bytes memory used 18 Kbyte A demonstration version of Mouse Tricks (just in case you hadn't got one) for you to spread further(!): MSE_DEMO.ACC file length 20581 bytes MSE_DEMO.RSC file length 6212 bytes memory used 32 Kbyte with no text files loaded (+ MSE_TRIX.TXT) The material contained in the above mentioned files is protected by copyright and is subject to the following restrictions: The demonstration version of Mouse Tricks may be copied and distributed freely (please do), provided that the three files MSE_DEMO.ACC, MSE_DEMO.RSC and MSE_TRIX.TXT are supplied together unamended. All other versions of Mouse Tricks and Read Text may only be copied for personal use by the original purchaser; either as a backup, or for use on different boot disks. They may in no circumstances be distributed to anyone else. Limitations of warranty and liability. If the disk I have supplied is faulty, I will replace it if you return it to me within 90 days of the date of purchase, giving details of the problem. I make no warranty, expressed or implied, with respect to these programs, the documentation, and any other related items, their quality, performance, merchantability, or fitness for any particular use. I will in no event be held liable for direct, indirect or incidental damages resulting from any defect or omission in this documentation, the program, or other related items and processes, including but not limited to any loss of business or anticipatory profit, interruption of services or other damages resulting from the use of this product. Jonathan Lawrence, August 1990