Home » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199610.adf » Regulars » StarInfo/Lurcock/!KeyFilter/!Help
StarInfo/Lurcock/!KeyFilter/!Help
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
| Tape/disk: | Home » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199610.adf » Regulars |
| Filename: | StarInfo/Lurcock/!KeyFilter/!Help |
| Read OK: | ✔ |
| File size: | 14BA bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
============================================================================
KeyFilter v1.00 � 1996 Pontus Lurcock 05.02.1996
============================================================================
Introduction
------------
KeyFilter creates modules which filter keypresses to tasks. A KeyFilter
module is tied to one specific application (identified by name); it will
detect certain incoming keypresses and pass them on to the 'host' task as a
different keypress or a menu selection - it can also mask out keypresses so
that the task does not receive them.
The writing of this program was prompted by the 1st Word Plus word processor
which is, as far as I know, still the best thing to use if you have a 9-pin
dot matrix printer... however it predates the style guide so some of its
hotkeys are a little unusual (e.g. F3 for Italic). Many other uses for
KeyFilter exist... any PC-lovers who don't like the Acorn policy of delete
for delete left and Copy/End for delete right can now remap Delete to Copy
and Copy to Ctrl-Down - hey presto, instant PC-ification (though Colin
McEwan's PCKeys might be a simpler method). Also, don't forget the practical
joke potential of, for example, illicitly remapping your friend's 'o' key to
'�'.
How to use it
-------------
It should be pretty obvious... there's one big window with a subwindow
showing all the currently defined key remappings.
The 'Module name' icon at the top should be filled in with the name you want
to give your filter module - this can be anything as long as it doesn't clash
with any other modules. In 'For application' give the task name of the
application you want it to work with (i.e. the name appearing in the Task
Manager window - and it's case sensitive).
The stuff beneath this allows you to alter the currently selected remapping.
For the key codes, you can either type them into the writable icon
(interpreted as hexadecimal if prefixed with &), or, more simply, click on
the display field to the right of the writable icon - it will go white and
the window will gain the input focus. Your next keypress will be detected and
inserted into the icon (this may seem oddly familiar to users of !ResEd :-).
Selecting 'Null event' obviously masks the keypress out.
If 'Menu selection' is selected you can type a sequence of menu selections
into the 'Items' icon, comma separated and counting downwards with the top
menu item as 0. To clarify this: 0,3,2,1 would select this item in a menu
tree:
____________ ____________
|__Menu 1__| |__Menu 2__|
| Item 0 �|=>| Item 0 |
| Item 1 | | Item 1 | ____________
| Etc... | | Item 2 | |__Menu 3__|
| | | Item 3 � |=>| Item 0 | ____________
| Etc... | | Item 1 | |__Menu 3__|
| Item 2 � |=>| Item 0 |
| Etc... | | Item 1 | <= This is the one!
| Etc... |
The 'Add' and 'Remove' icons, and the 'Clear data' menu item should be pretty
self-explanatory. When you add a new remapping it defaults to changing
keycode &000 into itself.
Once you've defined all your key remappings and menu shortcuts, KeyFilter
will create a module which you can save out in normal Wimp fashion. Note that
KeyFilter won't reload modules, only data files, so if you want to change
your definition without starting again it's a good idea to save a datafile. A
few example data files can be found in the Examples directory inside the
application directory.
About the modules
-----------------
The modules created by KeyFilter have the name you gave them in the 'Module
Name' icon. They can be loaded before or after the application they are to be
used with, and will automatically detect this application loading and
quitting. It won't kill itself when the application quits, it'll just hang
around and re-activate if the application is loaded again.
All the hard work is done by the Filter Manager - the module registers a
post-filter and checks all incoming keypresses. It needs to be a task in
order to keep tabs on TaskInitialise and TaskCloseDown messages. Presumably
the Filter Manager de-registers filters anyway when a task closes down, but
better safe than sorry...
Limitations
-----------
* Modules can't be loaded back in for editing.
* Keypresses can't be mapped to submenu/dialogue box openings (because I
couldn't think of a way of doing it)
* Only one task can be filtered at a time by the filter modules
* Shift-Ctrl keypresses with 'normal' keys can't be differentiated from
simple Ctrl-keypresses, due to the way the Wimp handles keycodes
* KeyFilter will not, of course, change the key short-cuts displayed on an
application's menus. This would take a lot of programming effort, or
alternatively a little judicious hacking on the part of the user...
Acknowledgements
----------------
Thanks to... Dominic Symes for the excellent Zap, Dick Alstein for the superb
TemplEd, Acorn for including an assembler in BASIC, my brother Casper for a
bit of beta-testing... and everyone on Arcade of course.
Finally...
----------
I can be contacted for bug reports, suggestions etc. at
pontus@arcade.demon.co.uk
or snail mail: 9 Monmouth Road, Oxford OX1 4TD, England
Happy filtration :-)
Pont
00000000 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |================| * 00000040 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 4b 65 79 |============.Key| 00000050 46 69 6c 74 65 72 20 76 31 2e 30 30 09 09 a9 20 |Filter v1.00... | 00000060 31 39 39 36 20 50 6f 6e 74 75 73 20 4c 75 72 63 |1996 Pontus Lurc| 00000070 6f 63 6b 09 09 09 20 20 30 35 2e 30 32 2e 31 39 |ock... 05.02.19| 00000080 39 36 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |96.=============| 00000090 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |================| * 000000c0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a |===============.| 000000d0 0a 0a 49 6e 74 72 6f 64 75 63 74 69 6f 6e 0a 2d |..Introduction.-| 000000e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4b 65 79 |-----------..Key| 000000f0 46 69 6c 74 65 72 20 63 72 65 61 74 65 73 20 6d |Filter creates m| 00000100 6f 64 75 6c 65 73 20 77 68 69 63 68 20 66 69 6c |odules which fil| 00000110 74 65 72 20 6b 65 79 70 72 65 73 73 65 73 20 74 |ter keypresses t| 00000120 6f 20 74 61 73 6b 73 2e 20 41 20 4b 65 79 46 69 |o tasks. A KeyFi| 00000130 6c 74 65 72 0a 6d 6f 64 75 6c 65 20 69 73 20 74 |lter.module is t| 00000140 69 65 64 20 74 6f 20 6f 6e 65 20 73 70 65 63 69 |ied to one speci| 00000150 66 69 63 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 |fic application | 00000160 28 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 6e |(identified by n| 00000170 61 6d 65 29 3b 20 69 74 20 77 69 6c 6c 0a 64 65 |ame); it will.de| 00000180 74 65 63 74 20 63 65 72 74 61 69 6e 20 69 6e 63 |tect certain inc| 00000190 6f 6d 69 6e 67 20 6b 65 79 70 72 65 73 73 65 73 |oming keypresses| 000001a0 20 61 6e 64 20 70 61 73 73 20 74 68 65 6d 20 6f | and pass them o| 000001b0 6e 20 74 6f 20 74 68 65 20 27 68 6f 73 74 27 20 |n to the 'host' | 000001c0 74 61 73 6b 20 61 73 20 61 0a 64 69 66 66 65 72 |task as a.differ| 000001d0 65 6e 74 20 6b 65 79 70 72 65 73 73 20 6f 72 20 |ent keypress or | 000001e0 61 20 6d 65 6e 75 20 73 65 6c 65 63 74 69 6f 6e |a menu selection| 000001f0 20 2d 20 69 74 20 63 61 6e 20 61 6c 73 6f 20 6d | - it can also m| 00000200 61 73 6b 20 6f 75 74 20 6b 65 79 70 72 65 73 73 |ask out keypress| 00000210 65 73 20 73 6f 0a 74 68 61 74 20 74 68 65 20 74 |es so.that the t| 00000220 61 73 6b 20 64 6f 65 73 20 6e 6f 74 20 72 65 63 |ask does not rec| 00000230 65 69 76 65 20 74 68 65 6d 2e 0a 0a 54 68 65 20 |eive them...The | 00000240 77 72 69 74 69 6e 67 20 6f 66 20 74 68 69 73 20 |writing of this | 00000250 70 72 6f 67 72 61 6d 20 77 61 73 20 70 72 6f 6d |program was prom| 00000260 70 74 65 64 20 62 79 20 74 68 65 20 31 73 74 20 |pted by the 1st | 00000270 57 6f 72 64 20 50 6c 75 73 20 77 6f 72 64 20 70 |Word Plus word p| 00000280 72 6f 63 65 73 73 6f 72 0a 77 68 69 63 68 20 69 |rocessor.which i| 00000290 73 2c 20 61 73 20 66 61 72 20 61 73 20 49 20 6b |s, as far as I k| 000002a0 6e 6f 77 2c 20 73 74 69 6c 6c 20 74 68 65 20 62 |now, still the b| 000002b0 65 73 74 20 74 68 69 6e 67 20 74 6f 20 75 73 65 |est thing to use| 000002c0 20 69 66 20 79 6f 75 20 68 61 76 65 20 61 20 39 | if you have a 9| 000002d0 2d 70 69 6e 0a 64 6f 74 20 6d 61 74 72 69 78 20 |-pin.dot matrix | 000002e0 70 72 69 6e 74 65 72 2e 2e 2e 20 68 6f 77 65 76 |printer... howev| 000002f0 65 72 20 69 74 20 70 72 65 64 61 74 65 73 20 74 |er it predates t| 00000300 68 65 20 73 74 79 6c 65 20 67 75 69 64 65 20 73 |he style guide s| 00000310 6f 20 73 6f 6d 65 20 6f 66 20 69 74 73 0a 68 6f |o some of its.ho| 00000320 74 6b 65 79 73 20 61 72 65 20 61 20 6c 69 74 74 |tkeys are a litt| 00000330 6c 65 20 75 6e 75 73 75 61 6c 20 28 65 2e 67 2e |le unusual (e.g.| 00000340 20 46 33 20 66 6f 72 20 49 74 61 6c 69 63 29 2e | F3 for Italic).| 00000350 20 4d 61 6e 79 20 6f 74 68 65 72 20 75 73 65 73 | Many other uses| 00000360 20 66 6f 72 0a 4b 65 79 46 69 6c 74 65 72 20 65 | for.KeyFilter e| 00000370 78 69 73 74 2e 2e 2e 20 61 6e 79 20 50 43 2d 6c |xist... any PC-l| 00000380 6f 76 65 72 73 20 77 68 6f 20 64 6f 6e 27 74 20 |overs who don't | 00000390 6c 69 6b 65 20 74 68 65 20 41 63 6f 72 6e 20 70 |like the Acorn p| 000003a0 6f 6c 69 63 79 20 6f 66 20 64 65 6c 65 74 65 0a |olicy of delete.| 000003b0 66 6f 72 20 64 65 6c 65 74 65 20 6c 65 66 74 20 |for delete left | 000003c0 61 6e 64 20 43 6f 70 79 2f 45 6e 64 20 66 6f 72 |and Copy/End for| 000003d0 20 64 65 6c 65 74 65 20 72 69 67 68 74 20 63 61 | delete right ca| 000003e0 6e 20 6e 6f 77 20 72 65 6d 61 70 20 44 65 6c 65 |n now remap Dele| 000003f0 74 65 20 74 6f 20 43 6f 70 79 0a 61 6e 64 20 43 |te to Copy.and C| 00000400 6f 70 79 20 74 6f 20 43 74 72 6c 2d 44 6f 77 6e |opy to Ctrl-Down| 00000410 20 2d 20 68 65 79 20 70 72 65 73 74 6f 2c 20 69 | - hey presto, i| 00000420 6e 73 74 61 6e 74 20 50 43 2d 69 66 69 63 61 74 |nstant PC-ificat| 00000430 69 6f 6e 20 28 74 68 6f 75 67 68 20 43 6f 6c 69 |ion (though Coli| 00000440 6e 0a 4d 63 45 77 61 6e 27 73 20 50 43 4b 65 79 |n.McEwan's PCKey| 00000450 73 20 6d 69 67 68 74 20 62 65 20 61 20 73 69 6d |s might be a sim| 00000460 70 6c 65 72 20 6d 65 74 68 6f 64 29 2e 20 41 6c |pler method). Al| 00000470 73 6f 2c 20 64 6f 6e 27 74 20 66 6f 72 67 65 74 |so, don't forget| 00000480 20 74 68 65 20 70 72 61 63 74 69 63 61 6c 0a 6a | the practical.j| 00000490 6f 6b 65 20 70 6f 74 65 6e 74 69 61 6c 20 6f 66 |oke potential of| 000004a0 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 |, for example, i| 000004b0 6c 6c 69 63 69 74 6c 79 20 72 65 6d 61 70 70 69 |llicitly remappi| 000004c0 6e 67 20 79 6f 75 72 20 66 72 69 65 6e 64 27 73 |ng your friend's| 000004d0 20 27 6f 27 20 6b 65 79 20 74 6f 0a 27 f8 27 2e | 'o' key to.'.'.| 000004e0 0a 0a 0a 48 6f 77 20 74 6f 20 75 73 65 20 69 74 |...How to use it| 000004f0 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |.-------------..| 00000500 49 74 20 73 68 6f 75 6c 64 20 62 65 20 70 72 65 |It should be pre| 00000510 74 74 79 20 6f 62 76 69 6f 75 73 2e 2e 2e 20 74 |tty obvious... t| 00000520 68 65 72 65 27 73 20 6f 6e 65 20 62 69 67 20 77 |here's one big w| 00000530 69 6e 64 6f 77 20 77 69 74 68 20 61 20 73 75 62 |indow with a sub| 00000540 77 69 6e 64 6f 77 0a 73 68 6f 77 69 6e 67 20 61 |window.showing a| 00000550 6c 6c 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 |ll the currently| 00000560 20 64 65 66 69 6e 65 64 20 6b 65 79 20 72 65 6d | defined key rem| 00000570 61 70 70 69 6e 67 73 2e 20 0a 0a 54 68 65 20 27 |appings. ..The '| 00000580 4d 6f 64 75 6c 65 20 6e 61 6d 65 27 20 69 63 6f |Module name' ico| 00000590 6e 20 61 74 20 74 68 65 20 74 6f 70 20 73 68 6f |n at the top sho| 000005a0 75 6c 64 20 62 65 20 66 69 6c 6c 65 64 20 69 6e |uld be filled in| 000005b0 20 77 69 74 68 20 74 68 65 20 6e 61 6d 65 20 79 | with the name y| 000005c0 6f 75 20 77 61 6e 74 0a 74 6f 20 67 69 76 65 20 |ou want.to give | 000005d0 79 6f 75 72 20 66 69 6c 74 65 72 20 6d 6f 64 75 |your filter modu| 000005e0 6c 65 20 2d 20 74 68 69 73 20 63 61 6e 20 62 65 |le - this can be| 000005f0 20 61 6e 79 74 68 69 6e 67 20 61 73 20 6c 6f 6e | anything as lon| 00000600 67 20 61 73 20 69 74 20 64 6f 65 73 6e 27 74 20 |g as it doesn't | 00000610 63 6c 61 73 68 0a 77 69 74 68 20 61 6e 79 20 6f |clash.with any o| 00000620 74 68 65 72 20 6d 6f 64 75 6c 65 73 2e 20 49 6e |ther modules. In| 00000630 20 27 46 6f 72 20 61 70 70 6c 69 63 61 74 69 6f | 'For applicatio| 00000640 6e 27 20 67 69 76 65 20 74 68 65 20 74 61 73 6b |n' give the task| 00000650 20 6e 61 6d 65 20 6f 66 20 74 68 65 0a 61 70 70 | name of the.app| 00000660 6c 69 63 61 74 69 6f 6e 20 79 6f 75 20 77 61 6e |lication you wan| 00000670 74 20 69 74 20 74 6f 20 77 6f 72 6b 20 77 69 74 |t it to work wit| 00000680 68 20 28 69 2e 65 2e 20 74 68 65 20 6e 61 6d 65 |h (i.e. the name| 00000690 20 61 70 70 65 61 72 69 6e 67 20 69 6e 20 74 68 | appearing in th| 000006a0 65 20 54 61 73 6b 0a 4d 61 6e 61 67 65 72 20 77 |e Task.Manager w| 000006b0 69 6e 64 6f 77 20 2d 20 61 6e 64 20 69 74 27 73 |indow - and it's| 000006c0 20 63 61 73 65 20 73 65 6e 73 69 74 69 76 65 29 | case sensitive)| 000006d0 2e 0a 0a 54 68 65 20 73 74 75 66 66 20 62 65 6e |...The stuff ben| 000006e0 65 61 74 68 20 74 68 69 73 20 61 6c 6c 6f 77 73 |eath this allows| 000006f0 20 79 6f 75 20 74 6f 20 61 6c 74 65 72 20 74 68 | you to alter th| 00000700 65 20 63 75 72 72 65 6e 74 6c 79 20 73 65 6c 65 |e currently sele| 00000710 63 74 65 64 20 72 65 6d 61 70 70 69 6e 67 2e 0a |cted remapping..| 00000720 46 6f 72 20 74 68 65 20 6b 65 79 20 63 6f 64 65 |For the key code| 00000730 73 2c 20 79 6f 75 20 63 61 6e 20 65 69 74 68 65 |s, you can eithe| 00000740 72 20 74 79 70 65 20 74 68 65 6d 20 69 6e 74 6f |r type them into| 00000750 20 74 68 65 20 77 72 69 74 61 62 6c 65 20 69 63 | the writable ic| 00000760 6f 6e 0a 28 69 6e 74 65 72 70 72 65 74 65 64 20 |on.(interpreted | 00000770 61 73 20 68 65 78 61 64 65 63 69 6d 61 6c 20 69 |as hexadecimal i| 00000780 66 20 70 72 65 66 69 78 65 64 20 77 69 74 68 20 |f prefixed with | 00000790 26 29 2c 20 6f 72 2c 20 6d 6f 72 65 20 73 69 6d |&), or, more sim| 000007a0 70 6c 79 2c 20 63 6c 69 63 6b 20 6f 6e 0a 74 68 |ply, click on.th| 000007b0 65 20 64 69 73 70 6c 61 79 20 66 69 65 6c 64 20 |e display field | 000007c0 74 6f 20 74 68 65 20 72 69 67 68 74 20 6f 66 20 |to the right of | 000007d0 74 68 65 20 77 72 69 74 61 62 6c 65 20 69 63 6f |the writable ico| 000007e0 6e 20 2d 20 69 74 20 77 69 6c 6c 20 67 6f 20 77 |n - it will go w| 000007f0 68 69 74 65 20 61 6e 64 0a 74 68 65 20 77 69 6e |hite and.the win| 00000800 64 6f 77 20 77 69 6c 6c 20 67 61 69 6e 20 74 68 |dow will gain th| 00000810 65 20 69 6e 70 75 74 20 66 6f 63 75 73 2e 20 59 |e input focus. Y| 00000820 6f 75 72 20 6e 65 78 74 20 6b 65 79 70 72 65 73 |our next keypres| 00000830 73 20 77 69 6c 6c 20 62 65 20 64 65 74 65 63 74 |s will be detect| 00000840 65 64 20 61 6e 64 0a 69 6e 73 65 72 74 65 64 20 |ed and.inserted | 00000850 69 6e 74 6f 20 74 68 65 20 69 63 6f 6e 20 28 74 |into the icon (t| 00000860 68 69 73 20 6d 61 79 20 73 65 65 6d 20 6f 64 64 |his may seem odd| 00000870 6c 79 20 66 61 6d 69 6c 69 61 72 20 74 6f 20 75 |ly familiar to u| 00000880 73 65 72 73 20 6f 66 20 21 52 65 73 45 64 20 3a |sers of !ResEd :| 00000890 2d 29 2e 0a 0a 53 65 6c 65 63 74 69 6e 67 20 27 |-)...Selecting '| 000008a0 4e 75 6c 6c 20 65 76 65 6e 74 27 20 6f 62 76 69 |Null event' obvi| 000008b0 6f 75 73 6c 79 20 6d 61 73 6b 73 20 74 68 65 20 |ously masks the | 000008c0 6b 65 79 70 72 65 73 73 20 6f 75 74 2e 0a 0a 49 |keypress out...I| 000008d0 66 20 27 4d 65 6e 75 20 73 65 6c 65 63 74 69 6f |f 'Menu selectio| 000008e0 6e 27 20 69 73 20 73 65 6c 65 63 74 65 64 20 79 |n' is selected y| 000008f0 6f 75 20 63 61 6e 20 74 79 70 65 20 61 20 73 65 |ou can type a se| 00000900 71 75 65 6e 63 65 20 6f 66 20 6d 65 6e 75 20 73 |quence of menu s| 00000910 65 6c 65 63 74 69 6f 6e 73 0a 69 6e 74 6f 20 74 |elections.into t| 00000920 68 65 20 27 49 74 65 6d 73 27 20 69 63 6f 6e 2c |he 'Items' icon,| 00000930 20 63 6f 6d 6d 61 20 73 65 70 61 72 61 74 65 64 | comma separated| 00000940 20 61 6e 64 20 63 6f 75 6e 74 69 6e 67 20 64 6f | and counting do| 00000950 77 6e 77 61 72 64 73 20 77 69 74 68 20 74 68 65 |wnwards with the| 00000960 20 74 6f 70 0a 6d 65 6e 75 20 69 74 65 6d 20 61 | top.menu item a| 00000970 73 20 30 2e 20 54 6f 20 63 6c 61 72 69 66 79 20 |s 0. To clarify | 00000980 74 68 69 73 3a 20 30 2c 33 2c 32 2c 31 20 77 6f |this: 0,3,2,1 wo| 00000990 75 6c 64 20 73 65 6c 65 63 74 20 74 68 69 73 20 |uld select this | 000009a0 69 74 65 6d 20 69 6e 20 61 20 6d 65 6e 75 0a 74 |item in a menu.t| 000009b0 72 65 65 3a 0a 20 20 5f 5f 5f 5f 5f 5f 5f 5f 5f |ree:. _________| 000009c0 5f 5f 5f 20 20 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f |___ ___________| 000009d0 5f 0a 20 20 7c 5f 5f 4d 65 6e 75 20 31 5f 5f 7c |_. |__Menu 1__|| 000009e0 20 20 7c 5f 5f 4d 65 6e 75 20 32 5f 5f 7c 0a 20 | |__Menu 2__|. | 000009f0 20 7c 20 49 74 65 6d 20 30 20 20 89 7c 3d 3e 7c | | Item 0 .|=>|| 00000a00 20 49 74 65 6d 20 30 20 20 20 7c 0a 20 20 7c 20 | Item 0 |. | | 00000a10 49 74 65 6d 20 31 20 20 20 7c 20 20 7c 20 49 74 |Item 1 | | It| 00000a20 65 6d 20 31 20 20 20 7c 20 20 5f 5f 5f 5f 5f 5f |em 1 | ______| 00000a30 5f 5f 5f 5f 5f 5f 0a 20 20 7c 20 45 74 63 2e 2e |______. | Etc..| 00000a40 2e 20 20 20 7c 20 20 7c 20 49 74 65 6d 20 32 20 |. | | Item 2 | 00000a50 20 20 7c 20 20 7c 5f 5f 4d 65 6e 75 20 33 5f 5f | | |__Menu 3__| 00000a60 7c 0a 20 20 7c 20 20 20 20 20 20 20 20 20 20 7c ||. | || 00000a70 20 20 7c 20 49 74 65 6d 20 33 20 89 20 7c 3d 3e | | Item 3 . |=>| 00000a80 7c 20 49 74 65 6d 20 30 20 20 20 7c 20 20 5f 5f || Item 0 | __| 00000a90 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f 0a 20 20 20 20 20 |__________. | 00000aa0 20 20 20 20 20 20 20 20 20 20 20 7c 20 45 74 63 | | Etc| 00000ab0 2e 2e 2e 20 20 20 7c 20 20 7c 20 49 74 65 6d 20 |... | | Item | 00000ac0 31 20 20 20 7c 20 20 7c 5f 5f 4d 65 6e 75 20 33 |1 | |__Menu 3| 00000ad0 5f 5f 7c 0a 20 20 20 20 20 20 20 20 20 20 20 20 |__|. | 00000ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000af0 20 20 7c 20 49 74 65 6d 20 32 20 89 20 7c 3d 3e | | Item 2 . |=>| 00000b00 7c 20 49 74 65 6d 20 30 20 20 20 7c 0a 20 20 20 || Item 0 |. | 00000b10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000b20 20 20 20 20 20 20 20 20 20 20 20 7c 20 45 74 63 | | Etc| 00000b30 2e 2e 2e 20 20 20 7c 20 20 7c 20 49 74 65 6d 20 |... | | Item | 00000b40 31 20 20 20 7c 20 3c 3d 20 54 68 69 73 20 69 73 |1 | <= This is| 00000b50 20 74 68 65 20 6f 6e 65 21 0a 20 20 20 20 20 20 | the one!. | 00000b60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000b70 20 20 20 20 20 20 20 20 09 09 20 20 20 20 7c 20 | .. | | 00000b80 45 74 63 2e 2e 2e 20 20 20 7c 0a 0a 54 68 65 20 |Etc... |..The | 00000b90 27 41 64 64 27 20 61 6e 64 20 27 52 65 6d 6f 76 |'Add' and 'Remov| 00000ba0 65 27 20 69 63 6f 6e 73 2c 20 61 6e 64 20 74 68 |e' icons, and th| 00000bb0 65 20 27 43 6c 65 61 72 20 64 61 74 61 27 20 6d |e 'Clear data' m| 00000bc0 65 6e 75 20 69 74 65 6d 20 73 68 6f 75 6c 64 20 |enu item should | 00000bd0 62 65 20 70 72 65 74 74 79 0a 73 65 6c 66 2d 65 |be pretty.self-e| 00000be0 78 70 6c 61 6e 61 74 6f 72 79 2e 20 57 68 65 6e |xplanatory. When| 00000bf0 20 79 6f 75 20 61 64 64 20 61 20 6e 65 77 20 72 | you add a new r| 00000c00 65 6d 61 70 70 69 6e 67 20 69 74 20 64 65 66 61 |emapping it defa| 00000c10 75 6c 74 73 20 74 6f 20 63 68 61 6e 67 69 6e 67 |ults to changing| 00000c20 0a 6b 65 79 63 6f 64 65 20 26 30 30 30 20 69 6e |.keycode &000 in| 00000c30 74 6f 20 69 74 73 65 6c 66 2e 0a 0a 4f 6e 63 65 |to itself...Once| 00000c40 20 79 6f 75 27 76 65 20 64 65 66 69 6e 65 64 20 | you've defined | 00000c50 61 6c 6c 20 79 6f 75 72 20 6b 65 79 20 72 65 6d |all your key rem| 00000c60 61 70 70 69 6e 67 73 20 61 6e 64 20 6d 65 6e 75 |appings and menu| 00000c70 20 73 68 6f 72 74 63 75 74 73 2c 20 4b 65 79 46 | shortcuts, KeyF| 00000c80 69 6c 74 65 72 0a 77 69 6c 6c 20 63 72 65 61 74 |ilter.will creat| 00000c90 65 20 61 20 6d 6f 64 75 6c 65 20 77 68 69 63 68 |e a module which| 00000ca0 20 79 6f 75 20 63 61 6e 20 73 61 76 65 20 6f 75 | you can save ou| 00000cb0 74 20 69 6e 20 6e 6f 72 6d 61 6c 20 57 69 6d 70 |t in normal Wimp| 00000cc0 20 66 61 73 68 69 6f 6e 2e 20 4e 6f 74 65 20 74 | fashion. Note t| 00000cd0 68 61 74 0a 4b 65 79 46 69 6c 74 65 72 20 77 6f |hat.KeyFilter wo| 00000ce0 6e 27 74 20 72 65 6c 6f 61 64 20 6d 6f 64 75 6c |n't reload modul| 00000cf0 65 73 2c 20 6f 6e 6c 79 20 64 61 74 61 20 66 69 |es, only data fi| 00000d00 6c 65 73 2c 20 73 6f 20 69 66 20 79 6f 75 20 77 |les, so if you w| 00000d10 61 6e 74 20 74 6f 20 63 68 61 6e 67 65 0a 79 6f |ant to change.yo| 00000d20 75 72 20 64 65 66 69 6e 69 74 69 6f 6e 20 77 69 |ur definition wi| 00000d30 74 68 6f 75 74 20 73 74 61 72 74 69 6e 67 20 61 |thout starting a| 00000d40 67 61 69 6e 20 69 74 27 73 20 61 20 67 6f 6f 64 |gain it's a good| 00000d50 20 69 64 65 61 20 74 6f 20 73 61 76 65 20 61 20 | idea to save a | 00000d60 64 61 74 61 66 69 6c 65 2e 20 41 0a 66 65 77 20 |datafile. A.few | 00000d70 65 78 61 6d 70 6c 65 20 64 61 74 61 20 66 69 6c |example data fil| 00000d80 65 73 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 |es can be found | 00000d90 69 6e 20 74 68 65 20 45 78 61 6d 70 6c 65 73 20 |in the Examples | 00000da0 64 69 72 65 63 74 6f 72 79 20 69 6e 73 69 64 65 |directory inside| 00000db0 20 74 68 65 0a 61 70 70 6c 69 63 61 74 69 6f 6e | the.application| 00000dc0 20 64 69 72 65 63 74 6f 72 79 2e 0a 0a 41 62 6f | directory...Abo| 00000dd0 75 74 20 74 68 65 20 6d 6f 64 75 6c 65 73 0a 2d |ut the modules.-| 00000de0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| 00000df0 0a 0a 54 68 65 20 6d 6f 64 75 6c 65 73 20 63 72 |..The modules cr| 00000e00 65 61 74 65 64 20 62 79 20 4b 65 79 46 69 6c 74 |eated by KeyFilt| 00000e10 65 72 20 68 61 76 65 20 74 68 65 20 6e 61 6d 65 |er have the name| 00000e20 20 79 6f 75 20 67 61 76 65 20 74 68 65 6d 20 69 | you gave them i| 00000e30 6e 20 74 68 65 20 27 4d 6f 64 75 6c 65 0a 4e 61 |n the 'Module.Na| 00000e40 6d 65 27 20 69 63 6f 6e 2e 20 54 68 65 79 20 63 |me' icon. They c| 00000e50 61 6e 20 62 65 20 6c 6f 61 64 65 64 20 62 65 66 |an be loaded bef| 00000e60 6f 72 65 20 6f 72 20 61 66 74 65 72 20 74 68 65 |ore or after the| 00000e70 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 68 65 | application the| 00000e80 79 20 61 72 65 20 74 6f 20 62 65 0a 75 73 65 64 |y are to be.used| 00000e90 20 77 69 74 68 2c 20 61 6e 64 20 77 69 6c 6c 20 | with, and will | 00000ea0 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 |automatically de| 00000eb0 74 65 63 74 20 74 68 69 73 20 61 70 70 6c 69 63 |tect this applic| 00000ec0 61 74 69 6f 6e 20 6c 6f 61 64 69 6e 67 20 61 6e |ation loading an| 00000ed0 64 0a 71 75 69 74 74 69 6e 67 2e 20 49 74 20 77 |d.quitting. It w| 00000ee0 6f 6e 27 74 20 6b 69 6c 6c 20 69 74 73 65 6c 66 |on't kill itself| 00000ef0 20 77 68 65 6e 20 74 68 65 20 61 70 70 6c 69 63 | when the applic| 00000f00 61 74 69 6f 6e 20 71 75 69 74 73 2c 20 69 74 27 |ation quits, it'| 00000f10 6c 6c 20 6a 75 73 74 20 68 61 6e 67 0a 61 72 6f |ll just hang.aro| 00000f20 75 6e 64 20 61 6e 64 20 72 65 2d 61 63 74 69 76 |und and re-activ| 00000f30 61 74 65 20 69 66 20 74 68 65 20 61 70 70 6c 69 |ate if the appli| 00000f40 63 61 74 69 6f 6e 20 69 73 20 6c 6f 61 64 65 64 |cation is loaded| 00000f50 20 61 67 61 69 6e 2e 0a 0a 41 6c 6c 20 74 68 65 | again...All the| 00000f60 20 68 61 72 64 20 77 6f 72 6b 20 69 73 20 64 6f | hard work is do| 00000f70 6e 65 20 62 79 20 74 68 65 20 46 69 6c 74 65 72 |ne by the Filter| 00000f80 20 4d 61 6e 61 67 65 72 20 2d 20 74 68 65 20 6d | Manager - the m| 00000f90 6f 64 75 6c 65 20 72 65 67 69 73 74 65 72 73 20 |odule registers | 00000fa0 61 0a 70 6f 73 74 2d 66 69 6c 74 65 72 20 61 6e |a.post-filter an| 00000fb0 64 20 63 68 65 63 6b 73 20 61 6c 6c 20 69 6e 63 |d checks all inc| 00000fc0 6f 6d 69 6e 67 20 6b 65 79 70 72 65 73 73 65 73 |oming keypresses| 00000fd0 2e 20 49 74 20 6e 65 65 64 73 20 74 6f 20 62 65 |. It needs to be| 00000fe0 20 61 20 74 61 73 6b 20 69 6e 0a 6f 72 64 65 72 | a task in.order| 00000ff0 20 74 6f 20 6b 65 65 70 20 74 61 62 73 20 6f 6e | to keep tabs on| 00001000 20 54 61 73 6b 49 6e 69 74 69 61 6c 69 73 65 20 | TaskInitialise | 00001010 61 6e 64 20 54 61 73 6b 43 6c 6f 73 65 44 6f 77 |and TaskCloseDow| 00001020 6e 20 6d 65 73 73 61 67 65 73 2e 20 50 72 65 73 |n messages. Pres| 00001030 75 6d 61 62 6c 79 0a 74 68 65 20 46 69 6c 74 65 |umably.the Filte| 00001040 72 20 4d 61 6e 61 67 65 72 20 64 65 2d 72 65 67 |r Manager de-reg| 00001050 69 73 74 65 72 73 20 66 69 6c 74 65 72 73 20 61 |isters filters a| 00001060 6e 79 77 61 79 20 77 68 65 6e 20 61 20 74 61 73 |nyway when a tas| 00001070 6b 20 63 6c 6f 73 65 73 20 64 6f 77 6e 2c 20 62 |k closes down, b| 00001080 75 74 0a 62 65 74 74 65 72 20 73 61 66 65 20 74 |ut.better safe t| 00001090 68 61 6e 20 73 6f 72 72 79 2e 2e 2e 0a 0a 0a 4c |han sorry......L| 000010a0 69 6d 69 74 61 74 69 6f 6e 73 0a 2d 2d 2d 2d 2d |imitations.-----| 000010b0 2d 2d 2d 2d 2d 2d 0a 0a 2a 20 4d 6f 64 75 6c 65 |------..* Module| 000010c0 73 20 63 61 6e 27 74 20 62 65 20 6c 6f 61 64 65 |s can't be loade| 000010d0 64 20 62 61 63 6b 20 69 6e 20 66 6f 72 20 65 64 |d back in for ed| 000010e0 69 74 69 6e 67 2e 0a 2a 20 4b 65 79 70 72 65 73 |iting..* Keypres| 000010f0 73 65 73 20 63 61 6e 27 74 20 62 65 20 6d 61 70 |ses can't be map| 00001100 70 65 64 20 74 6f 20 73 75 62 6d 65 6e 75 2f 64 |ped to submenu/d| 00001110 69 61 6c 6f 67 75 65 20 62 6f 78 20 6f 70 65 6e |ialogue box open| 00001120 69 6e 67 73 20 28 62 65 63 61 75 73 65 20 49 0a |ings (because I.| 00001130 20 20 20 20 63 6f 75 6c 64 6e 27 74 20 74 68 69 | couldn't thi| 00001140 6e 6b 20 6f 66 20 61 20 77 61 79 20 6f 66 20 64 |nk of a way of d| 00001150 6f 69 6e 67 20 69 74 29 0a 2a 20 4f 6e 6c 79 20 |oing it).* Only | 00001160 6f 6e 65 20 74 61 73 6b 20 63 61 6e 20 62 65 20 |one task can be | 00001170 66 69 6c 74 65 72 65 64 20 61 74 20 61 20 74 69 |filtered at a ti| 00001180 6d 65 20 62 79 20 74 68 65 20 66 69 6c 74 65 72 |me by the filter| 00001190 20 6d 6f 64 75 6c 65 73 0a 2a 20 53 68 69 66 74 | modules.* Shift| 000011a0 2d 43 74 72 6c 20 6b 65 79 70 72 65 73 73 65 73 |-Ctrl keypresses| 000011b0 20 77 69 74 68 20 27 6e 6f 72 6d 61 6c 27 20 6b | with 'normal' k| 000011c0 65 79 73 20 63 61 6e 27 74 20 62 65 20 64 69 66 |eys can't be dif| 000011d0 66 65 72 65 6e 74 69 61 74 65 64 20 66 72 6f 6d |ferentiated from| 000011e0 20 0a 20 20 20 20 73 69 6d 70 6c 65 20 43 74 72 | . simple Ctr| 000011f0 6c 2d 6b 65 79 70 72 65 73 73 65 73 2c 20 64 75 |l-keypresses, du| 00001200 65 20 74 6f 20 74 68 65 20 77 61 79 20 74 68 65 |e to the way the| 00001210 20 57 69 6d 70 20 68 61 6e 64 6c 65 73 20 6b 65 | Wimp handles ke| 00001220 79 63 6f 64 65 73 0a 2a 20 4b 65 79 46 69 6c 74 |ycodes.* KeyFilt| 00001230 65 72 20 77 69 6c 6c 20 6e 6f 74 2c 20 6f 66 20 |er will not, of | 00001240 63 6f 75 72 73 65 2c 20 63 68 61 6e 67 65 20 74 |course, change t| 00001250 68 65 20 6b 65 79 20 73 68 6f 72 74 2d 63 75 74 |he key short-cut| 00001260 73 20 64 69 73 70 6c 61 79 65 64 20 6f 6e 20 61 |s displayed on a| 00001270 6e 0a 20 20 20 20 61 70 70 6c 69 63 61 74 69 6f |n. applicatio| 00001280 6e 27 73 20 6d 65 6e 75 73 2e 20 54 68 69 73 20 |n's menus. This | 00001290 77 6f 75 6c 64 20 74 61 6b 65 20 61 20 6c 6f 74 |would take a lot| 000012a0 20 6f 66 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 | of programming | 000012b0 65 66 66 6f 72 74 2c 20 6f 72 0a 20 20 20 20 61 |effort, or. a| 000012c0 6c 74 65 72 6e 61 74 69 76 65 6c 79 20 61 20 6c |lternatively a l| 000012d0 69 74 74 6c 65 20 6a 75 64 69 63 69 6f 75 73 20 |ittle judicious | 000012e0 68 61 63 6b 69 6e 67 20 6f 6e 20 74 68 65 20 70 |hacking on the p| 000012f0 61 72 74 20 6f 66 20 74 68 65 20 75 73 65 72 2e |art of the user.| 00001300 2e 2e 0a 0a 0a 41 63 6b 6e 6f 77 6c 65 64 67 65 |.....Acknowledge| 00001310 6d 65 6e 74 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ments.----------| 00001320 2d 2d 2d 2d 2d 2d 0a 0a 54 68 61 6e 6b 73 20 74 |------..Thanks t| 00001330 6f 2e 2e 2e 20 44 6f 6d 69 6e 69 63 20 53 79 6d |o... Dominic Sym| 00001340 65 73 20 66 6f 72 20 74 68 65 20 65 78 63 65 6c |es for the excel| 00001350 6c 65 6e 74 20 5a 61 70 2c 20 44 69 63 6b 20 41 |lent Zap, Dick A| 00001360 6c 73 74 65 69 6e 20 66 6f 72 20 74 68 65 20 73 |lstein for the s| 00001370 75 70 65 72 62 0a 54 65 6d 70 6c 45 64 2c 20 41 |uperb.TemplEd, A| 00001380 63 6f 72 6e 20 66 6f 72 20 69 6e 63 6c 75 64 69 |corn for includi| 00001390 6e 67 20 61 6e 20 61 73 73 65 6d 62 6c 65 72 20 |ng an assembler | 000013a0 69 6e 20 42 41 53 49 43 2c 20 6d 79 20 62 72 6f |in BASIC, my bro| 000013b0 74 68 65 72 20 43 61 73 70 65 72 20 66 6f 72 20 |ther Casper for | 000013c0 61 0a 62 69 74 20 6f 66 20 62 65 74 61 2d 74 65 |a.bit of beta-te| 000013d0 73 74 69 6e 67 2e 2e 2e 20 61 6e 64 20 65 76 65 |sting... and eve| 000013e0 72 79 6f 6e 65 20 6f 6e 20 41 72 63 61 64 65 20 |ryone on Arcade | 000013f0 6f 66 20 63 6f 75 72 73 65 2e 0a 0a 0a 46 69 6e |of course....Fin| 00001400 61 6c 6c 79 2e 2e 2e 0a 2d 2d 2d 2d 2d 2d 2d 2d |ally....--------| 00001410 2d 2d 0a 0a 49 20 63 61 6e 20 62 65 20 63 6f 6e |--..I can be con| 00001420 74 61 63 74 65 64 20 66 6f 72 20 62 75 67 20 72 |tacted for bug r| 00001430 65 70 6f 72 74 73 2c 20 73 75 67 67 65 73 74 69 |eports, suggesti| 00001440 6f 6e 73 20 65 74 63 2e 20 61 74 0a 70 6f 6e 74 |ons etc. at.pont| 00001450 75 73 40 61 72 63 61 64 65 2e 64 65 6d 6f 6e 2e |us@arcade.demon.| 00001460 63 6f 2e 75 6b 0a 6f 72 20 73 6e 61 69 6c 20 6d |co.uk.or snail m| 00001470 61 69 6c 3a 20 39 20 4d 6f 6e 6d 6f 75 74 68 20 |ail: 9 Monmouth | 00001480 52 6f 61 64 2c 20 4f 78 66 6f 72 64 20 4f 58 31 |Road, Oxford OX1| 00001490 20 34 54 44 2c 20 45 6e 67 6c 61 6e 64 0a 0a 48 | 4TD, England..H| 000014a0 61 70 70 79 20 66 69 6c 74 72 61 74 69 6f 6e 20 |appy filtration | 000014b0 3a 2d 29 0a 0a 50 6f 6e 74 0a |:-)..Pont.| 000014ba
.