Home » Archimedes archive » Acorn Computing » 1994 02 subscription disc.adf » 9402s » PD/IClear/Help » Compare

Compare PD/IClear/Help with IClear/Help

File: Archimedes archive » Acorn Computing » 1994 02 subscription disc.adf » 9402s » PD/IClear/Help
Compared with: Archimedes archive » Acorn User » Acorn User - Updated Shareware Collection (1994).adf » Programs » IClear/Help
Similarity: 89% of bytes duplicated

89.2% of the bytes in these files are duplicated between them. Duplicated Different Padding (ignored)

Bytes are marked as duplicated if they lie within a run of at least 16 bytes which also appears somewhere in the other file, in any position. Long runs of padding bytes (zeros, spaces, &FF and &E5) are ignored.

PD/IClear/Help
00000000  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 49  |               I|
00000020  43 6c 65 61 72 20 4d 6f  64 75 6c 65 0a 20 20 20  |Clear Module.   |
00000030  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000040  20 20 20 20 20 20 20 20  20 20 20 20 3d 3d 3d 3d  |            ====|
00000050  3d 3d 20 3d 3d 3d 3d 3d  3d 0a 0a 20 20 20 20 20  |== ======..     |
00000060  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000070  20 20 20 20 20 20 20 20  20 20 62 79 20 4d 61 72  |          by Mar|
00000080  74 79 6e 20 46 6f 78 0a  0a 54 68 69 73 20 73 6f  |tyn Fox..This so|
00000090  66 74 77 61 72 65 20 69  73 20 50 75 62 6c 69 63  |ftware is Public|
000000a0  20 44 6f 6d 61 69 6e 2e  20 49 74 20 6d 61 79 20  | Domain. It may |
000000b0  62 65 20 66 72 65 65 6c  79 20 63 6f 70 69 65 64  |be freely copied|
000000c0  20 61 6e 64 20 64 69 73  74 72 69 62 75 74 65 64  | and distributed|
000000d0  2c 0a 69 6e 63 6c 75 64  69 6e 67 20 64 69 73 74  |,.including dist|
000000e0  72 69 62 75 74 69 6f 6e  20 62 79 20 6d 61 67 61  |ribution by maga|
000000f0  7a 69 6e 65 20 64 69 73  63 73 2c 20 50 44 20 6c  |zine discs, PD l|
00000100  69 62 72 61 72 69 65 73  2c 20 62 75 6c 6c 65 74  |ibraries, bullet|
00000110  69 6e 20 62 6f 61 72 64  73 0a 65 74 63 2e 2c 20  |in boards.etc., |
00000120  70 72 6f 76 69 64 65 64  20 74 68 65 20 66 6f 6c  |provided the fol|
00000130  6c 6f 77 69 6e 67 20 63  6f 6e 64 69 74 69 6f 6e  |lowing condition|
00000140  73 20 61 72 65 20 61 64  68 65 72 65 64 20 74 6f  |s are adhered to|
00000150  3a 0a 0a 31 2e 20 4e 6f  20 63 68 61 72 67 65 20  |:..1. No charge |
00000160  69 73 20 6d 61 64 65 20  6f 74 68 65 72 20 74 68  |is made other th|
00000170  61 6e 20 74 6f 20 63 6f  76 65 72 20 74 68 65 20  |an to cover the |
00000180  72 65 61 73 6f 6e 61 62  6c 65 20 63 6f 73 74 20  |reasonable cost |
00000190  6f 66 20 64 75 70 6c 69  63 61 74 69 6f 6e 0a 61  |of duplication.a|
000001a0  6e 64 20 64 69 73 74 72  69 62 75 74 69 6f 6e 2e  |nd distribution.|
000001b0  0a 0a 32 2e 20 4e 6f 20  61 6c 74 65 72 61 74 69  |..2. No alterati|
000001c0  6f 6e 20 69 73 20 6d 61  64 65 20 74 6f 20 65 69  |on is made to ei|
000001d0  74 68 65 72 20 74 68 65  20 73 6f 66 74 77 61 72  |ther the softwar|
000001e0  65 20 6f 72 20 74 68 69  73 20 74 65 78 74 20 66  |e or this text f|
000001f0  69 6c 65 2e 0a 0a 33 2e  20 54 68 69 73 20 74 65  |ile...3. This te|
00000200  78 74 20 66 69 6c 65 20  61 63 63 6f 6d 70 61 6e  |xt file accompan|
00000210  69 65 73 20 61 6c 6c 20  63 6f 70 69 65 73 20 6f  |ies all copies o|
00000220  66 20 74 68 65 20 73 6f  66 74 77 61 72 65 2e 0a  |f the software..|
00000230  0a 50 6c 65 61 73 65 20  6e 6f 74 65 20 74 68 61  |.Please note tha|
00000240  74 20 74 68 69 73 20 6d  6f 64 75 6c 65 20 77 69  |t this module wi|
00000250  6c 6c 20 6f 6e 6c 79 20  77 6f 72 6b 20 77 69 74  |ll only work wit|
00000260  68 20 52 49 53 43 20 4f  53 20 33 20 6f 72 20 6c  |h RISC OS 3 or l|
00000270  61 74 65 72 2e 0a 0a 49  43 6c 65 61 72 20 69 73  |ater...IClear is|
00000280  20 61 20 6d 6f 64 75 6c  65 20 77 68 69 63 68 20  | a module which |
00000290  6d 61 6b 65 73 20 69 74  20 65 61 73 69 65 72 20  |makes it easier |
000002a0  74 6f 20 64 65 6c 65 74  65 20 74 65 78 74 20 66  |to delete text f|
000002b0  72 6f 6d 20 61 20 77 72  69 74 61 62 6c 65 0a 69  |rom a writable.i|
000002c0  63 6f 6e 2e 20 55 6e 64  65 72 20 52 49 53 43 20  |con. Under RISC |
000002d0  4f 53 2c 20 74 6f 20 72  65 70 6c 61 63 65 20 74  |OS, to replace t|
000002e0  68 65 20 74 65 78 74 20  69 6e 20 73 75 63 68 20  |he text in such |
000002f0  61 6e 20 69 63 6f 6e 20  77 69 74 68 20 6e 65 77  |an icon with new|
00000300  20 74 65 78 74 2c 20 79  6f 75 0a 66 69 72 73 74  | text, you.first|
00000310  20 68 61 76 65 20 74 6f  20 65 69 74 68 65 72 20  | have to either |
00000320  64 65 6c 65 74 65 20 61  6c 6c 20 74 68 65 20 63  |delete all the c|
00000330  68 61 72 61 63 74 65 72  73 20 6f 66 20 74 68 65  |haracters of the|
00000340  20 6f 6c 64 20 74 65 78  74 20 6f 72 20 70 72 65  | old text or pre|
00000350  73 73 0a 43 74 72 6c 2d  55 20 74 6f 20 63 6c 65  |ss.Ctrl-U to cle|
00000360  61 72 20 69 74 2e 20 54  68 69 73 20 63 61 6e 20  |ar it. This can |
00000370  62 65 20 61 20 6e 75 69  73 61 6e 63 65 2c 20 65  |be a nuisance, e|
00000380  73 70 65 63 69 61 6c 6c  79 20 69 66 20 79 6f 75  |specially if you|
00000390  20 68 61 76 65 20 6a 75  73 74 0a 73 65 6c 65 63  | have just.selec|
000003a0  74 65 64 20 74 68 65 20  69 63 6f 6e 20 77 69 74  |ted the icon wit|
000003b0  68 20 74 68 65 20 6d 6f  75 73 65 2c 20 61 73 20  |h the mouse, as |
000003c0  79 6f 75 20 66 69 72 73  74 20 68 61 76 65 20 74  |you first have t|
000003d0  6f 20 74 72 61 6e 73 66  65 72 20 74 6f 20 74 68  |o transfer to th|
000003e0  65 0a 6b 65 79 62 6f 61  72 64 2c 20 74 68 65 6e  |e.keyboard, then|
000003f0  20 70 72 65 73 73 20 43  74 72 6c 2d 55 20 62 65  | press Ctrl-U be|
00000400  66 6f 72 65 20 79 6f 75  20 63 61 6e 20 74 79 70  |fore you can typ|
00000410  65 20 69 6e 20 79 6f 75  72 20 6e 65 77 20 74 65  |e in your new te|
00000420  78 74 2e 0a 0a 57 69 74  68 20 49 43 6c 65 61 72  |xt...With IClear|
00000430  20 72 75 6e 6e 69 6e 67  2c 20 73 69 6d 70 6c 79  | running, simply|
00000440  20 64 6f 75 62 6c 65 2d  63 6c 69 63 6b 20 6f 6e  | double-click on|
00000450  20 74 68 65 20 77 72 69  74 61 62 6c 65 20 69 63  | the writable ic|
00000460  6f 6e 2c 20 75 73 69 6e  67 20 65 69 74 68 65 72  |on, using either|
00000470  0a 53 65 6c 65 63 74 20  6f 72 20 41 64 6a 75 73  |.Select or Adjus|
00000480  74 2e 20 54 68 65 20 69  63 6f 6e 20 77 69 6c 6c  |t. The icon will|
00000490  20 62 65 20 69 6e 76 65  72 74 65 64 2c 20 77 68  | be inverted, wh|
000004a0  69 63 68 20 75 73 75 61  6c 6c 79 20 6d 65 61 6e  |ich usually mean|
000004b0  73 20 74 68 61 74 20 69  74 0a 77 69 6c 6c 20 74  |s that it.will t|
000004c0  75 72 6e 20 62 6c 61 63  6b 20 77 69 74 68 20 77  |urn black with w|
000004d0  68 69 74 65 20 74 65 78  74 2e 20 41 73 20 73 6f  |hite text. As so|
000004e0  6f 6e 20 61 73 20 79 6f  75 20 70 72 65 73 73 20  |on as you press |
000004f0  61 20 6b 65 79 2c 20 74  68 65 20 74 65 78 74 20  |a key, the text |
00000500  69 6e 20 74 68 65 0a 69  63 6f 6e 20 77 69 6c 6c  |in the.icon will|
00000510  20 76 61 6e 69 73 68 2c  20 74 6f 20 62 65 20 72  | vanish, to be r|
00000520  65 70 6c 61 63 65 64 20  77 69 74 68 20 74 68 65  |eplaced with the|
00000530  20 63 68 61 72 61 63 74  65 72 20 74 68 61 74 20  | character that |
00000540  79 6f 75 20 74 79 70 65  64 2e 20 49 66 20 79 6f  |you typed. If yo|
00000550  75 0a 63 68 61 6e 67 65  20 79 6f 75 72 20 6d 69  |u.change your mi|
00000560  6e 64 20 61 66 74 65 72  20 69 6e 76 65 72 74 69  |nd after inverti|
00000570  6e 67 20 74 68 65 20 69  63 6f 6e 20 61 6e 64 20  |ng the icon and |
00000580  64 65 63 69 64 65 20 79  6f 75 20 77 61 6e 74 20  |decide you want |
00000590  74 6f 20 6b 65 65 70 20  79 6f 75 72 0a 65 78 69  |to keep your.exi|
000005a0  73 74 69 6e 67 20 74 65  78 74 2c 20 61 20 66 75  |sting text, a fu|
000005b0  72 74 68 65 72 20 63 6c  69 63 6b 20 77 69 74 68  |rther click with|
000005c0  20 61 6e 79 20 6d 6f 75  73 65 20 62 75 74 74 6f  | any mouse butto|
000005d0  6e 20 61 6e 79 77 68 65  72 65 20 6f 6e 20 74 68  |n anywhere on th|
000005e0  65 20 73 63 72 65 65 6e  0a 77 69 6c 6c 20 64 65  |e screen.will de|
000005f0  2d 69 6e 76 65 72 74 20  74 68 65 20 69 63 6f 6e  |-invert the icon|
00000600  20 61 6e 64 20 70 75 74  20 74 68 69 6e 67 73 20  | and put things |
00000610  62 61 63 6b 20 74 6f 20  6e 6f 72 6d 61 6c 2e 0a  |back to normal..|
00000620  0a 54 68 69 73 20 73 6f  66 74 77 61 72 65 20 77  |.This software w|
00000630  69 6c 6c 20 77 6f 72 6b  20 77 69 74 68 20 77 72  |ill work with wr|
00000640  69 74 61 62 6c 65 20 69  63 6f 6e 73 20 28 62 75  |itable icons (bu|
00000650  74 74 6f 6e 20 74 79 70  65 20 31 35 29 20 61 6e  |tton type 15) an|
00000660  64 20 61 6c 73 6f 0a 64  72 61 67 67 61 62 6c 65  |d also.draggable|
00000670  20 77 72 69 74 61 62 6c  65 20 69 63 6f 6e 73 20  | writable icons |
00000680  28 62 75 74 74 6f 6e 20  74 79 70 65 20 31 34 29  |(button type 14)|
00000690  20 62 75 74 20 6e 6f 74  20 77 69 74 68 20 77 72  | but not with wr|
000006a0  69 74 61 62 6c 65 20 6d  65 6e 75 20 69 74 65 6d  |itable menu item|
000006b0  73 2e 0a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |s...            |
000006c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000006d0  20 50 72 6f 67 72 61 6d  6d 69 6e 67 20 4e 6f 74  | Programming Not|
000006e0  65 73 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |es.             |
000006f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000700  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 20 3d 3d 3d 3d  |=========== ====|
00000710  3d 0a 0a 54 68 65 20 6d  6f 64 75 6c 65 20 69 6e  |=..The module in|
00000720  74 65 72 63 65 70 74 73  20 74 68 65 20 4d 6f 75  |tercepts the Mou|
00000730  73 65 56 20 61 6e 64 20  49 6e 73 56 20 76 65 63  |seV and InsV vec|
00000740  74 6f 72 73 20 74 6f 20  64 65 74 65 63 74 20 63  |tors to detect c|
00000750  61 6c 6c 73 20 74 6f 0a  4f 53 5f 4d 6f 75 73 65  |alls to.OS_Mouse|
00000760  20 61 6e 64 20 6b 65 79  70 72 65 73 73 65 73 2e  | and keypresses.|
00000770  20 4f 53 5f 4d 6f 75 73  65 20 63 61 6c 6c 73 20  | OS_Mouse calls |
00000780  61 72 65 20 66 69 72 73  74 20 70 61 73 73 65 64  |are first passed|
00000790  20 6f 6e 74 6f 20 74 68  65 20 53 57 49 0a 72 6f  | onto the SWI.ro|
000007a0  75 74 69 6e 65 20 61 6e  64 20 70 72 6f 63 65 73  |utine and proces|
000007b0  73 65 64 20 6f 6e 20 65  78 69 74 2e 0a 0a 42 65  |sed on exit...Be|
000007c0  63 61 75 73 65 20 52 49  53 43 20 4f 53 20 77 69  |cause RISC OS wi|
000007d0  6c 6c 20 6e 6f 74 20 61  75 74 6f 6d 61 74 69 63  |ll not automatic|
000007e0  61 6c 6c 79 20 64 65 74  65 63 74 20 61 20 64 6f  |ally detect a do|
000007f0  75 62 6c 65 2d 63 6c 69  63 6b 20 6f 76 65 72 20  |uble-click over |
00000800  61 20 77 72 69 74 61 62  6c 65 0a 69 63 6f 6e 2c  |a writable.icon,|
00000810  20 74 68 65 20 6d 6f 64  75 6c 65 20 68 61 73 20  | the module has |
00000820  74 6f 20 64 6f 20 74 68  65 20 6a 6f 62 20 69 74  |to do the job it|
00000830  73 65 6c 66 2e 20 54 68  69 73 20 69 6e 76 6f 6c  |self. This invol|
00000840  76 65 73 20 63 68 65 63  6b 69 6e 67 20 74 68 65  |ves checking the|
00000850  20 74 69 6d 65 0a 69 6e  74 65 72 76 61 6c 20 73  | time.interval s|
00000860  69 6e 63 65 20 74 68 65  20 70 72 65 76 69 6f 75  |ince the previou|
00000870  73 20 63 6c 69 63 6b 2c  20 73 65 6c 65 63 74 69  |s click, selecti|
00000880  6e 67 20 74 68 65 20 27  64 6f 75 62 6c 65 2d 61  |ng the 'double-a|
00000890  72 72 6f 77 27 20 70 6f  69 6e 74 65 72 0a 73 70  |rrow' pointer.sp|
000008a0  72 69 74 65 2c 20 63 68  65 63 6b 69 6e 67 20 77  |rite, checking w|
000008b0  68 69 63 68 20 62 75 74  74 6f 6e 20 77 61 73 20  |hich button was |
000008c0  70 72 65 73 73 65 64 20  61 6e 64 20 6d 6f 6e 69  |pressed and moni|
000008d0  74 6f 72 69 6e 67 20 74  68 65 20 6d 6f 75 73 65  |toring the mouse|
000008e0  20 70 6f 73 69 74 69 6f  6e 2e 0a 0a 52 61 74 68  | position...Rath|
000008f0  65 72 20 74 68 61 6e 20  70 75 74 20 74 6f 6f 20  |er than put too |
00000900  6d 75 63 68 20 63 6f 64  65 20 69 6e 74 6f 20 61  |much code into a|
00000910  20 76 65 63 74 6f 72 20  69 6e 74 65 72 63 65 70  | vector intercep|
00000920  74 20 72 6f 75 74 69 6e  65 2c 20 74 68 65 20 73  |t routine, the s|
00000930  6f 66 74 77 61 72 65 0a  6a 75 73 74 20 73 65 74  |oftware.just set|
00000940  73 20 6f 6e 65 20 6f 66  20 74 77 6f 20 63 61 6c  |s one of two cal|
00000950  6c 62 61 63 6b 73 2c 20  64 65 70 65 6e 64 69 6e  |lbacks, dependin|
00000960  67 20 6f 6e 20 74 68 65  20 74 69 6d 65 20 69 6e  |g on the time in|
00000970  74 65 72 76 61 6c 20 73  69 6e 63 65 20 74 68 65  |terval since the|
00000980  0a 70 72 65 76 69 6f 75  73 20 63 6c 69 63 6b 2e  |.previous click.|
00000990  20 54 68 65 20 63 61 6c  6c 62 61 63 6b 20 72 6f  | The callback ro|
000009a0  75 74 69 6e 65 20 69 73  20 63 61 6c 6c 65 64 20  |utine is called |
000009b0  62 79 20 52 49 53 43 20  4f 53 20 61 73 20 73 6f  |by RISC OS as so|
000009c0  6f 6e 20 61 73 20 69 74  20 69 73 0a 6e 6f 74 20  |on as it is.not |
000009d0  62 75 73 79 2e 20 54 68  65 20 66 69 72 73 74 20  |busy. The first |
000009e0  6f 66 20 74 68 65 73 65  20 63 61 6c 6c 62 61 63  |of these callbac|
000009f0  6b 73 20 68 61 6e 64 6c  65 73 20 61 20 73 69 6e  |ks handles a sin|
00000a00  67 6c 65 20 63 6c 69 63  6b 2e 20 49 74 20 66 69  |gle click. It fi|
00000a10  72 73 74 0a 63 68 65 63  6b 73 20 74 6f 20 73 65  |rst.checks to se|
00000a20  65 20 69 66 20 74 68 65  20 6d 6f 64 75 6c 65 20  |e if the module |
00000a30  68 61 73 20 61 20 72 65  63 6f 72 64 20 6f 66 20  |has a record of |
00000a40  61 6e 20 69 6e 76 65 72  74 65 64 20 69 63 6f 6e  |an inverted icon|
00000a50  20 61 6e 64 2c 20 69 66  20 73 6f 2c 0a 74 61 6b  | and, if so,.tak|
00000a60  65 73 20 73 74 65 70 73  20 74 6f 20 63 6c 65 61  |es steps to clea|
00000a70  72 20 69 74 2e 20 49 74  20 74 68 65 6e 20 73 74  |r it. It then st|
00000a80  6f 72 65 73 20 61 20 72  65 63 6f 72 64 20 6f 66  |ores a record of|
00000a90  20 77 68 69 63 68 20 62  75 74 74 6f 6e 20 77 61  | which button wa|
00000aa0  73 20 70 72 65 73 73 65  64 0a 61 6e 64 20 63 68  |s pressed.and ch|
00000ab0  65 63 6b 73 20 74 68 65  20 69 63 6f 6e 20 74 79  |ecks the icon ty|
00000ac0  70 65 2e 20 49 66 20 74  68 65 20 63 6c 69 63 6b  |pe. If the click|
00000ad0  20 77 61 73 20 6f 76 65  72 20 61 20 77 72 69 74  | was over a writ|
00000ae0  61 62 6c 65 20 69 63 6f  6e 2c 20 69 74 20 73 74  |able icon, it st|
00000af0  6f 72 65 73 0a 74 68 65  20 6d 6f 75 73 65 20 70  |ores.the mouse p|
00000b00  6f 73 69 74 69 6f 6e 20  61 6e 64 20 72 65 64 65  |osition and rede|
00000b10  66 69 6e 65 73 20 6d 6f  75 73 65 20 70 6f 69 6e  |fines mouse poin|
00000b20  74 65 72 20 31 20 73 70  72 69 74 65 20 61 73 20  |ter 1 sprite as |
00000b30  70 74 72 5f 64 6f 75 62  6c 65 2e 0a 0a 4e 2e 42  |ptr_double...N.B|
00000b40  2e 20 54 68 65 72 65 20  61 70 70 65 61 72 73 20  |. There appears |
00000b50  74 6f 20 62 65 20 6e 6f  20 77 61 79 20 6f 66 20  |to be no way of |
00000b60  72 65 61 64 69 6e 67 20  77 68 69 63 68 20 73 70  |reading which sp|
00000b70  72 69 74 65 20 69 73 20  75 73 65 64 20 62 79 20  |rite is used by |
00000b80  61 0a 70 61 72 74 69 63  75 6c 61 72 20 70 6f 69  |a.particular poi|
00000b90  6e 74 65 72 20 6e 75 6d  62 65 72 2e 20 54 68 65  |nter number. The|
00000ba0  20 50 52 4d 20 74 68 6f  75 67 68 20 73 61 79 73  | PRM though says|
00000bb0  20 74 68 61 74 20 6f 6e  6c 79 20 52 49 53 43 20  | that only RISC |
00000bc0  4f 53 20 73 68 6f 75 6c  64 20 75 73 65 0a 70 6f  |OS should use.po|
00000bd0  69 6e 74 65 72 20 31 2c  20 73 6f 20 74 68 69 73  |inter 1, so this|
00000be0  20 70 6f 69 6e 74 65 72  20 73 68 6f 75 6c 64 20  | pointer should |
00000bf0  70 72 65 73 75 6d 61 62  6c 79 20 61 6c 77 61 79  |presumably alway|
00000c00  73 20 75 73 65 20 74 68  65 20 70 74 72 5f 64 65  |s use the ptr_de|
00000c10  66 61 75 6c 74 0a 61 72  72 6f 77 20 73 70 72 69  |fault.arrow spri|
00000c20  74 65 2e 20 54 68 65 20  6d 6f 64 75 6c 65 20 61  |te. The module a|
00000c30  73 73 75 6d 65 73 20 74  68 69 73 20 61 6e 64 20  |ssumes this and |
00000c40  61 6c 77 61 79 73 20 72  65 70 6c 61 63 65 73 20  |always replaces |
00000c50  70 74 72 5f 64 6f 75 62  6c 65 20 77 69 74 68 0a  |ptr_double with.|
00000c60  70 74 72 5f 64 65 66 61  75 6c 74 20 61 74 20 74  |ptr_default at t|
00000c70  68 65 20 65 6e 64 20 6f  66 20 74 68 65 20 70 65  |he end of the pe|
00000c80  72 69 6f 64 20 64 75 72  69 6e 67 20 77 68 69 63  |riod during whic|
00000c90  68 20 69 74 20 63 68 65  63 6b 73 20 66 6f 72 20  |h it checks for |
00000ca0  61 20 73 65 63 6f 6e 64  0a 63 6c 69 63 6b 2e 0a  |a second.click..|
00000cb0  0a 54 68 65 20 6d 6f 64  75 6c 65 20 74 68 65 6e  |.The module then|
00000cc0  20 73 65 74 73 20 61 20  63 61 6c 6c 2d 61 66 74  | sets a call-aft|
00000cd0  65 72 2c 20 77 68 69 63  68 20 69 73 20 61 6e 20  |er, which is an |
00000ce0  69 6e 73 74 72 75 63 74  69 6f 6e 20 74 6f 20 52  |instruction to R|
00000cf0  49 53 43 20 4f 53 20 74  6f 0a 63 61 6c 6c 20 61  |ISC OS to.call a|
00000d00  20 72 6f 75 74 69 6e 65  20 61 66 74 65 72 20 61  | routine after a|
00000d10  20 63 65 72 74 61 69 6e  20 6c 65 6e 67 74 68 20  | certain length |
00000d20  6f 66 20 74 69 6d 65 2e  20 49 74 20 61 6c 73 6f  |of time. It also|
00000d30  20 63 61 6c 6c 73 20 4f  53 5f 43 61 6c 6c 45 76  | calls OS_CallEv|
00000d40  65 72 79 20 74 6f 0a 61  72 72 61 6e 67 65 20 66  |ery to.arrange f|
00000d50  6f 72 20 61 20 63 61 6c  6c 20 65 76 65 72 79 20  |or a call every |
00000d60  31 30 20 63 65 6e 74 69  73 65 63 6f 6e 64 73 20  |10 centiseconds |
00000d70  74 6f 20 61 20 72 6f 75  74 69 6e 65 20 77 68 69  |to a routine whi|
00000d80  63 68 20 63 68 65 63 6b  73 20 74 68 65 20 6d 6f  |ch checks the mo|
00000d90  75 73 65 0a 70 6f 73 69  74 69 6f 6e 20 61 6e 64  |use.position and|
00000da0  20 63 61 6e 63 65 6c 73  20 74 68 65 20 64 6f 75  | cancels the dou|
00000db0  62 6c 65 2d 63 6c 69 63  6b 20 6d 6f 6e 69 74 6f  |ble-click monito|
00000dc0  72 69 6e 67 20 69 66 20  74 68 65 20 6d 6f 75 73  |ring if the mous|
00000dd0  65 20 69 73 20 6d 6f 76  65 64 20 6d 6f 72 65 0a  |e is moved more.|
00000de0  74 68 61 6e 20 61 20 63  65 72 74 61 69 6e 20 61  |than a certain a|
00000df0  6d 6f 75 6e 74 2e 0a 0a  4e 2e 42 2e 20 41 6c 74  |mount...N.B. Alt|
00000e00  68 6f 75 67 68 20 74 68  65 20 6e 6f 72 6d 61 6c  |hough the normal|
00000e10  20 64 6f 75 62 6c 65 2d  63 6c 69 63 6b 20 74 69  | double-click ti|
00000e20  6d 65 20 6c 69 6d 69 74  20 61 6e 64 20 70 65 72  |me limit and per|
00000e30  6d 69 74 74 65 64 20 6d  6f 75 73 65 0a 6d 6f 76  |mitted mouse.mov|
00000e40  65 6d 65 6e 74 20 63 61  6e 20 62 65 20 63 6f 6e  |ement can be con|
00000e50  66 69 67 75 72 65 64 2c  20 74 68 65 72 65 20 61  |figured, there a|
00000e60  70 70 65 61 72 73 20 74  6f 20 62 65 20 6e 6f 20  |ppears to be no |
00000e70  77 61 79 20 6f 66 20 72  65 61 64 69 6e 67 20 74  |way of reading t|
00000e80  68 65 69 72 0a 76 61 6c  75 65 73 2c 20 6f 74 68  |heir.values, oth|
00000e90  65 72 20 74 68 61 6e 20  74 68 65 20 75 6e 72 65  |er than the unre|
00000ea0  6c 69 61 62 6c 65 20 6d  65 74 68 6f 64 20 6f 66  |liable method of|
00000eb0  20 63 68 65 63 6b 69 6e  67 20 43 4d 4f 53 20 52  | checking CMOS R|
00000ec0  41 4d 20 6c 6f 63 61 74  69 6f 6e 73 2c 0a 77 68  |AM locations,.wh|
00000ed0  69 63 68 20 63 6f 75 6c  64 20 63 68 61 6e 67 65  |ich could change|
00000ee0  20 62 65 74 77 65 65 6e  20 64 69 66 66 65 72 65  | between differe|
00000ef0  6e 74 20 76 65 72 73 69  6f 6e 73 20 6f 66 20 52  |nt versions of R|
00000f00  49 53 43 20 4f 53 2e 20  54 68 69 73 20 6d 6f 64  |ISC OS. This mod|
00000f10  75 6c 65 20 75 73 65 73  0a 74 68 65 20 64 65 66  |ule uses.the def|
00000f20  61 75 6c 74 20 63 6f 6e  66 69 67 75 72 61 74 69  |ault configurati|
00000f30  6f 6e 20 76 61 6c 75 65  73 20 6f 66 20 31 20 73  |on values of 1 s|
00000f40  65 63 6f 6e 64 20 6d 61  78 69 6d 75 6d 20 62 65  |econd maximum be|
00000f50  74 77 65 65 6e 20 63 6c  69 63 6b 73 20 61 6e 64  |tween clicks and|
00000f60  20 61 0a 6d 61 78 69 6d  75 6d 20 6d 6f 75 73 65  | a.maximum mouse|
00000f70  20 6d 6f 76 65 6d 65 6e  74 20 6f 66 20 31 30 20  | movement of 10 |
00000f80  4f 53 20 75 6e 69 74 73  20 28 69 74 20 63 68 65  |OS units (it che|
00000f90  63 6b 73 20 66 6f 72 20  65 69 74 68 65 72 20 31  |cks for either 1|
00000fa0  30 20 68 6f 72 69 7a 6f  6e 74 61 6c 20 6f 72 0a  |0 horizontal or.|
00000fb0  31 30 20 76 65 72 74 69  63 61 6c 20 75 6e 69 74  |10 vertical unit|
00000fc0  73 20 6f 66 20 6d 6f 76  65 6d 65 6e 74 29 2e 20  |s of movement). |
00000fd0  54 68 65 73 65 20 76 61  6c 75 65 73 20 61 72 65  |These values are|
00000fe0  20 66 69 78 65 64 20 69  6e 20 74 68 69 73 20 76  | fixed in this v|
00000ff0  65 72 73 69 6f 6e 20 6f  66 0a 74 68 65 20 6d 6f  |ersion of.the mo|
00001000  64 75 6c 65 2e 20 49 66  20 74 68 65 72 65 20 69  |dule. If there i|
00001010  73 20 61 20 64 65 6d 61  6e 64 20 66 6f 72 20 74  |s a demand for t|
00001020  68 65 20 61 62 69 6c 69  74 79 20 74 6f 20 61 6c  |he ability to al|
00001030  74 65 72 20 74 68 65 73  65 20 76 61 6c 75 65 73  |ter these values|
00001040  2c 20 49 0a 77 69 6c 6c  20 65 6e 64 65 61 76 6f  |, I.will endeavo|
00001050  75 72 20 74 6f 20 69 6e  63 6c 75 64 65 20 61 20  |ur to include a |
00001060  63 6f 75 70 6c 65 20 6f  66 20 53 57 49 73 20 61  |couple of SWIs a|
00001070  6e 64 2f 6f 72 20 73 74  61 72 20 63 6f 6d 6d 61  |nd/or star comma|
00001080  6e 64 73 20 69 6e 20 61  20 6c 61 74 65 72 0a 76  |nds in a later.v|
00001090  65 72 73 69 6f 6e 2e 0a  0a 49 66 20 65 69 74 68  |ersion...If eith|
000010a0  65 72 20 61 20 73 65 63  6f 6e 64 20 6b 65 79 20  |er a second key |
000010b0  69 73 20 70 72 65 73 73  65 64 20 6f 72 20 74 68  |is pressed or th|
000010c0  65 20 6d 6f 75 73 65 20  69 73 20 6d 6f 76 65 64  |e mouse is moved|
000010d0  20 62 65 66 6f 72 65 20  74 68 65 0a 63 61 6c 6c  | before the.call|
000010e0  2d 61 66 74 65 72 20 68  61 73 20 74 69 6d 65 64  |-after has timed|
000010f0  20 6f 75 74 2c 20 74 68  65 20 63 61 6c 6c 2d 61  | out, the call-a|
00001100  66 74 65 72 20 61 6e 64  20 63 61 6c 6c 2d 65 76  |fter and call-ev|
00001110  65 72 79 20 61 72 65 20  63 61 6e 63 65 6c 6c 65  |ery are cancelle|
00001120  64 20 61 6e 64 20 61 0a  73 65 63 6f 6e 64 20 63  |d and a.second c|
00001130  61 6c 6c 62 61 63 6b 20  69 73 20 75 73 65 64 2e  |allback is used.|
00001140  20 54 68 69 73 20 72 6f  75 74 69 6e 65 20 63 68  | This routine ch|
00001150  65 63 6b 73 20 74 68 61  74 20 74 68 65 20 73 61  |ecks that the sa|
00001160  6d 65 20 6b 65 79 20 68  61 73 20 62 65 65 6e 0a  |me key has been.|
00001170  70 72 65 73 73 65 64 20  61 73 20 70 72 65 76 69  |pressed as previ|
00001180  6f 75 73 6c 79 2c 20 73  65 74 73 20 61 20 66 6c  |ously, sets a fl|
00001190  61 67 20 61 6e 64 20 74  61 6b 65 73 20 73 74 65  |ag and takes ste|
000011a0  70 73 20 74 6f 20 69 6e  76 65 72 74 20 74 68 65  |ps to invert the|
000011b0  20 69 63 6f 6e 2e 0a 0a  41 6c 74 68 6f 75 67 68  | icon...Although|
000011c0  20 61 6e 79 20 69 63 6f  6e 20 63 61 6e 20 62 65  | any icon can be|
000011d0  20 69 6e 76 65 72 74 65  64 20 6f 72 20 64 65 2d  | inverted or de-|
000011e0  69 6e 76 65 72 74 65 64  20 62 79 20 6d 65 61 6e  |inverted by mean|
000011f0  73 20 6f 66 20 61 20 63  61 6c 6c 20 74 6f 0a 57  |s of a call to.W|
00001200  69 6d 70 5f 53 65 74 49  63 6f 6e 53 74 61 74 65  |imp_SetIconState|
00001210  2c 20 74 68 65 20 70 72  6f 63 65 64 75 72 65 20  |, the procedure |
00001220  69 73 20 6e 6f 74 20 74  68 61 74 20 73 69 6d 70  |is not that simp|
00001230  6c 65 2e 20 54 68 69 73  20 53 57 49 20 6d 61 79  |le. This SWI may|
00001240  20 6f 6e 6c 79 20 62 65  0a 63 61 6c 6c 65 64 20  | only be.called |
00001250  77 68 69 6c 65 20 74 68  65 20 61 70 70 6c 69 63  |while the applic|
00001260  61 74 69 6f 6e 20 77 68  69 63 68 20 6f 77 6e 73  |ation which owns|
00001270  20 74 68 65 20 69 63 6f  6e 20 69 73 20 74 68 65  | the icon is the|
00001280  20 63 75 72 72 65 6e 74  6c 79 20 61 63 74 69 76  | currently activ|
00001290  65 0a 74 61 73 6b 2e 20  49 66 20 77 65 20 73 69  |e.task. If we si|
000012a0  6d 70 6c 79 20 63 61 6c  6c 20 69 74 20 77 68 65  |mply call it whe|
000012b0  6e 20 74 68 65 20 6d 6f  75 73 65 20 69 73 20 63  |n the mouse is c|
000012c0  6c 69 63 6b 65 64 2c 20  74 68 69 73 20 6d 61 79  |licked, this may|
000012d0  20 6e 6f 74 20 62 65 20  74 68 65 0a 63 61 73 65  | not be the.case|
000012e0  2c 20 65 73 70 65 63 69  61 6c 6c 79 20 69 66 20  |, especially if |
000012f0  73 65 76 65 72 61 6c 20  6d 75 6c 74 69 2d 74 61  |several multi-ta|
00001300  73 6b 69 6e 67 20 61 70  70 6c 69 63 61 74 69 6f  |sking applicatio|
00001310  6e 73 20 61 72 65 20 72  75 6e 6e 69 6e 67 20 61  |ns are running a|
00001320  74 20 74 68 65 0a 73 61  6d 65 20 74 69 6d 65 2e  |t the.same time.|
00001330  20 57 65 20 68 61 76 65  20 74 6f 20 73 65 6e 64  | We have to send|
00001340  20 61 20 6d 65 73 73 61  67 65 20 74 6f 20 74 68  | a message to th|
00001350  65 20 74 61 73 6b 20 62  75 74 20 77 65 20 63 61  |e task but we ca|
00001360  6e 6e 6f 74 2c 20 6f 66  20 63 6f 75 72 73 65 2c  |nnot, of course,|
00001370  0a 72 65 77 72 69 74 65  20 69 74 73 20 73 6f 66  |.rewrite its sof|
00001380  74 77 61 72 65 2e 0a 0a  54 68 65 20 73 6f 6c 75  |tware...The solu|
00001390  74 69 6f 6e 20 69 73 20  74 6f 20 75 73 65 20 61  |tion is to use a|
000013a0  20 66 69 6c 74 65 72 2e  20 57 65 20 63 6f 75 6c  | filter. We coul|
000013b0  64 20 75 73 65 20 61 20  70 72 65 2d 66 69 6c 74  |d use a pre-filt|
000013c0  65 72 2c 20 77 68 69 63  68 20 69 73 20 63 61 6c  |er, which is cal|
000013d0  6c 65 64 0a 6a 75 73 74  20 62 65 66 6f 72 65 20  |led.just before |
000013e0  57 69 6d 70 5f 50 6f 6c  6c 20 69 73 20 65 78 65  |Wimp_Poll is exe|
000013f0  63 75 74 65 64 2c 20 6f  72 20 61 20 70 6f 73 74  |cuted, or a post|
00001400  2d 66 69 6c 74 65 72 20  77 68 69 63 68 20 69 73  |-filter which is|
00001410  20 63 61 6c 6c 65 64 20  6f 6e 0a 72 65 74 75 72  | called on.retur|
00001420  6e 20 66 72 6f 6d 20 57  69 6d 70 5f 50 6f 6c 6c  |n from Wimp_Poll|
00001430  2e 20 49 6e 20 74 68 69  73 20 63 61 73 65 2c 20  |. In this case, |
00001440  77 65 20 75 73 65 20 74  68 65 20 6c 61 74 74 65  |we use the latte|
00001450  72 2e 20 54 68 65 20 74  65 63 68 6e 69 71 75 65  |r. The technique|
00001460  20 69 73 20 74 6f 0a 73  65 6e 64 20 61 20 75 6e  | is to.send a un|
00001470  69 71 75 65 20 6d 65 73  73 61 67 65 20 74 6f 20  |ique message to |
00001480  74 68 65 20 74 61 73 6b  20 77 68 69 63 68 20 6f  |the task which o|
00001490  75 72 20 66 69 6c 74 65  72 20 77 69 6c 6c 20 69  |ur filter will i|
000014a0  6e 74 65 72 63 65 70 74  20 61 6e 64 0a 72 65 63  |ntercept and.rec|
000014b0  6f 67 6e 69 73 65 2c 20  74 65 6c 6c 69 6e 67 20  |ognise, telling |
000014c0  69 74 20 74 6f 20 69 6e  76 65 72 74 20 6f 72 20  |it to invert or |
000014d0  64 65 2d 69 6e 76 65 72  74 20 74 68 65 20 72 65  |de-invert the re|
000014e0  71 75 69 72 65 64 20 69  63 6f 6e 2e 0a 0a 57 65  |quired icon...We|
000014f0  20 63 6f 75 6c 64 20 73  65 6e 64 20 61 20 6d 65  | could send a me|
00001500  73 73 61 67 65 2c 20 75  73 69 6e 67 20 72 65 61  |ssage, using rea|
00001510  73 6f 6e 20 63 6f 64 65  20 31 37 20 6f 72 20 31  |son code 17 or 1|
00001520  38 2c 20 62 75 74 20 77  65 20 77 6f 75 6c 64 20  |8, but we would |
00001530  68 61 76 65 20 74 6f 0a  66 69 6e 64 20 61 20 6d  |have to.find a m|
00001540  65 73 73 61 67 65 20 61  63 74 69 6f 6e 20 63 6f  |essage action co|
00001550  64 65 20 74 68 61 74 20  69 73 20 6e 6f 74 20 75  |de that is not u|
00001560  73 65 64 20 66 6f 72 20  61 6e 79 74 68 69 6e 67  |sed for anything|
00001570  20 65 6c 73 65 2c 20 77  68 69 63 68 20 77 6f 75  | else, which wou|
00001580  6c 64 0a 70 72 65 73 65  6e 74 20 70 72 6f 62 6c  |ld.present probl|
00001590  65 6d 73 2e 20 49 74 20  69 73 20 61 6c 73 6f 20  |ems. It is also |
000015a0  70 65 72 6d 69 73 73 69  62 6c 65 20 66 6f 72 20  |permissible for |
000015b0  61 20 74 61 73 6b 20 74  6f 20 6d 61 73 6b 20 6f  |a task to mask o|
000015c0  75 74 20 74 68 65 73 65  20 72 65 61 73 6f 6e 0a  |ut these reason.|
000015d0  63 6f 64 65 73 2c 20 77  68 69 63 68 20 77 6f 75  |codes, which wou|
000015e0  6c 64 20 70 72 65 76 65  6e 74 20 6f 75 72 20 6d  |ld prevent our m|
000015f0  65 73 73 61 67 65 20 67  65 74 74 69 6e 67 20 74  |essage getting t|
00001600  68 72 6f 75 67 68 2e 20  53 6f 20 74 68 61 74 20  |hrough. So that |
00001610  74 68 69 73 20 63 61 6e  6e 6f 74 0a 68 61 70 70  |this cannot.happ|
00001620  65 6e 2c 20 74 68 65 20  6d 6f 64 75 6c 65 20 73  |en, the module s|
00001630  65 6e 64 73 20 61 20 6d  65 73 73 61 67 65 20 77  |ends a message w|
00001640  69 74 68 20 72 65 61 73  6f 6e 20 63 6f 64 65 20  |ith reason code |
00001650  32 2c 20 77 68 69 63 68  20 75 73 75 61 6c 6c 79  |2, which usually|
00001660  20 6d 65 61 6e 73 0a 27  6f 70 65 6e 20 77 69 6e  | means.'open win|
00001670  64 6f 77 20 72 65 71 75  65 73 74 27 2e 20 54 68  |dow request'. Th|
00001680  69 73 20 72 65 61 73 6f  6e 20 63 6f 64 65 20 69  |is reason code i|
00001690  73 20 6e 6f 74 20 73 75  70 70 6f 73 65 64 20 74  |s not supposed t|
000016a0  6f 20 62 65 20 6d 61 73  6b 65 64 20 6f 75 74 0a  |o be masked out.|
000016b0  77 68 65 6e 20 63 61 6c  6c 69 6e 67 20 57 69 6d  |when calling Wim|
000016c0  70 5f 50 6f 6c 6c 2e 20  4f 75 72 20 6d 65 73 73  |p_Poll. Our mess|
000016d0  61 67 65 20 73 65 6e 64  73 20 52 31 2b 30 20 61  |age sends R1+0 a|
000016e0  73 20 7a 65 72 6f 20 61  6e 64 20 52 31 2b 34 20  |s zero and R1+4 |
000016f0  61 73 0a 26 37 32 36 43  34 33 34 39 2c 20 77 68  |as.&726C4349, wh|
00001700  69 63 68 20 69 73 20 74  68 65 20 41 53 43 49 49  |ich is the ASCII|
00001710  20 63 6f 64 65 20 66 6f  72 20 27 49 43 6c 72 27  | code for 'IClr'|
00001720  2e 20 54 68 69 73 20 63  6f 72 72 65 73 70 6f 6e  |. This correspon|
00001730  64 73 20 74 6f 20 61 20  72 65 71 75 65 73 74 0a  |ds to a request.|
00001740  74 6f 20 6f 70 65 6e 20  74 68 65 20 77 69 6e 64  |to open the wind|
00001750  6f 77 20 77 68 6f 73 65  20 68 61 6e 64 6c 65 20  |ow whose handle |
00001760  69 73 20 7a 65 72 6f 2c  20 77 69 74 68 20 61 20  |is zero, with a |
00001770  6d 69 6e 69 6d 75 6d 20  78 20 63 6f 6f 72 64 69  |minimum x coordi|
00001780  6e 61 74 65 20 6f 66 0a  26 37 32 36 43 34 33 34  |nate of.&726C434|
00001790  39 20 2d 20 61 20 6d 6f  73 74 20 75 6e 6c 69 6b  |9 - a most unlik|
000017a0  65 6c 79 20 73 74 61 74  65 20 6f 66 20 61 66 66  |ely state of aff|
000017b0  61 69 72 73 20 69 6e 20  61 6e 79 20 6f 74 68 65  |airs in any othe|
000017c0  72 20 73 69 74 75 61 74  69 6f 6e 21 20 54 68 65  |r situation! The|
000017d0  0a 74 68 69 72 64 20 77  6f 72 64 20 69 6e 20 74  |.third word in t|
000017e0  68 65 20 62 6c 6f 63 6b  20 69 73 20 7a 65 72 6f  |he block is zero|
000017f0  20 74 6f 20 63 6c 65 61  72 20 74 68 65 20 69 63  | to clear the ic|
00001800  6f 6e 20 6f 72 20 31 20  74 6f 20 69 6e 76 65 72  |on or 1 to inver|
00001810  74 20 69 74 2e 20 54 68  65 0a 66 69 6c 74 65 72  |t it. The.filter|
00001820  20 69 73 20 73 65 74 20  74 6f 20 68 61 6e 64 6c  | is set to handl|
00001830  65 20 6f 6e 6c 79 20 72  65 61 73 6f 6e 20 63 6f  |e only reason co|
00001840  64 65 20 32 2e 20 49 66  20 69 74 20 72 65 63 65  |de 2. If it rece|
00001850  69 76 65 73 20 74 68 65  20 65 78 61 63 74 20 73  |ives the exact s|
00001860  74 61 74 65 0a 6f 66 20  61 66 66 61 69 72 73 20  |tate.of affairs |
00001870  61 73 20 64 65 73 63 72  69 62 65 64 2c 20 69 74  |as described, it|
00001880  20 65 69 74 68 65 72 20  69 6e 76 65 72 74 73 20  | either inverts |
00001890  6f 72 20 63 6c 65 61 72  73 20 74 68 65 20 69 63  |or clears the ic|
000018a0  6f 6e 20 61 6e 64 20 65  78 69 74 73 0a 77 69 74  |on and exits.wit|
000018b0  68 6f 75 74 20 70 61 73  73 69 6e 67 20 74 68 65  |hout passing the|
000018c0  20 63 61 6c 6c 20 6f 6e  74 6f 20 74 68 65 20 61  | call onto the a|
000018d0  70 70 6c 69 63 61 74 69  6f 6e 2e 0a 0a 49 66 20  |pplication...If |
000018e0  61 20 6b 65 79 20 69 73  20 70 72 65 73 73 65 64  |a key is pressed|
000018f0  20 77 68 69 6c 65 20 74  68 65 20 69 6e 76 65 72  | while the inver|
00001900  74 65 64 20 69 63 6f 6e  20 66 6c 61 67 20 69 73  |ted icon flag is|
00001910  20 73 65 74 2c 20 74 68  65 20 72 6f 75 74 69 6e  | set, the routin|
00001920  65 20 28 61 67 61 69 6e  0a 62 79 20 6d 65 61 6e  |e (again.by mean|
00001930  73 20 6f 66 20 61 20 63  61 6c 6c 62 61 63 6b 29  |s of a callback)|
00001940  20 73 65 6e 64 73 20 61  20 6d 65 73 73 61 67 65  | sends a message|
00001950  20 74 6f 20 63 6c 65 61  72 20 74 68 65 20 69 63  | to clear the ic|
00001960  6f 6e 2c 20 74 68 65 6e  20 73 65 6e 64 73 20 74  |on, then sends t|
00001970  68 65 0a 6b 65 79 70 72  65 73 73 20 63 68 61 72  |he.keypress char|
00001980  61 63 74 65 72 2c 20 70  72 65 63 65 64 65 64 20  |acter, preceded |
00001990  62 79 20 61 20 43 74 72  6c 2d 55 20 74 6f 20 64  |by a Ctrl-U to d|
000019a0  65 6c 65 74 65 20 74 68  65 20 74 65 78 74 2e 0a  |elete the text..|
000019b0  0a 54 68 65 20 6d 6f 64  75 6c 65 20 69 6e 63 6f  |.The module inco|
000019c0  72 70 6f 72 61 74 65 73  20 61 20 73 65 6c 66 2d  |rporates a self-|
000019d0  63 68 65 63 6b 69 6e 67  20 72 6f 75 74 69 6e 65  |checking routine|
000019e0  20 74 6f 20 64 65 74 65  63 74 20 63 6f 72 72 75  | to detect corru|
000019f0  70 74 69 6f 6e 20 62 79  0a 76 69 72 75 73 65 73  |ption by.viruses|
00001a00  2e 0a 0a 50 6c 65 61 73  65 20 73 65 6e 64 20 61  |...Please send a|
00001a10  6c 6c 20 63 6f 6d 6d 65  6e 74 73 20 61 6e 64 20  |ll comments and |
00001a20  73 75 67 67 65 73 74 69  6f 6e 73 20 74 6f 3a 0a  |suggestions to:.|
00001a30  0a 4d 2e 50 2e 20 46 6f  78 2c 0a 33 31 20 50 69  |.M.P. Fox,.31 Pi|
00001a40  65 72 73 6f 6e 20 52 6f  61 64 2c 0a 57 69 6e 64  |erson Road,.Wind|
00001a50  73 6f 72 2c 0a 42 65 72  6b 73 2e 20 53 4c 34 20  |sor,.Berks. SL4 |
00001a60  35 52 45                                          |5RE|
00001a63
IClear/Help
00000000  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 49  |               I|
00000020  43 6c 65 61 72 20 4d 6f  64 75 6c 65 0a 20 20 20  |Clear Module.   |
00000030  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000040  20 20 20 20 20 20 20 20  20 20 20 20 3d 3d 3d 3d  |            ====|
00000050  3d 3d 20 3d 3d 3d 3d 3d  3d 0a 0a 20 20 20 20 20  |== ======..     |
00000060  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000070  20 20 20 20 20 20 20 20  20 20 62 79 20 4d 61 72  |          by Mar|
00000080  74 79 6e 20 46 6f 78 0a  0a 54 68 69 73 20 73 6f  |tyn Fox..This so|
00000090  66 74 77 61 72 65 20 69  73 20 50 75 62 6c 69 63  |ftware is Public|
000000a0  20 44 6f 6d 61 69 6e 2e  20 49 74 20 6d 61 79 20  | Domain. It may |
000000b0  62 65 20 66 72 65 65 6c  79 20 63 6f 70 69 65 64  |be freely copied|
000000c0  20 61 6e 64 20 64 69 73  74 72 69 62 75 74 65 64  | and distributed|
000000d0  2c 0a 69 6e 63 6c 75 64  69 6e 67 20 64 69 73 74  |,.including dist|
000000e0  72 69 62 75 74 69 6f 6e  20 62 79 20 6d 61 67 61  |ribution by maga|
000000f0  7a 69 6e 65 20 64 69 73  63 73 2c 20 50 44 20 6c  |zine discs, PD l|
00000100  69 62 72 61 72 69 65 73  2c 20 62 75 6c 6c 65 74  |ibraries, bullet|
00000110  69 6e 20 62 6f 61 72 64  73 0a 65 74 63 2e 2c 20  |in boards.etc., |
00000120  70 72 6f 76 69 64 65 64  20 74 68 65 20 66 6f 6c  |provided the fol|
00000130  6c 6f 77 69 6e 67 20 63  6f 6e 64 69 74 69 6f 6e  |lowing condition|
00000140  73 20 61 72 65 20 61 64  68 65 72 65 64 20 74 6f  |s are adhered to|
00000150  3a 0a 0a 31 2e 20 4e 6f  20 63 68 61 72 67 65 20  |:..1. No charge |
00000160  69 73 20 6d 61 64 65 20  6f 74 68 65 72 20 74 68  |is made other th|
00000170  61 6e 20 74 6f 20 63 6f  76 65 72 20 74 68 65 20  |an to cover the |
00000180  72 65 61 73 6f 6e 61 62  6c 65 20 63 6f 73 74 20  |reasonable cost |
00000190  6f 66 20 64 75 70 6c 69  63 61 74 69 6f 6e 0a 61  |of duplication.a|
000001a0  6e 64 20 64 69 73 74 72  69 62 75 74 69 6f 6e 2e  |nd distribution.|
000001b0  0a 0a 32 2e 20 4e 6f 20  61 6c 74 65 72 61 74 69  |..2. No alterati|
000001c0  6f 6e 20 69 73 20 6d 61  64 65 20 74 6f 20 65 69  |on is made to ei|
000001d0  74 68 65 72 20 74 68 65  20 73 6f 66 74 77 61 72  |ther the softwar|
000001e0  65 20 6f 72 20 74 68 69  73 20 74 65 78 74 20 66  |e or this text f|
000001f0  69 6c 65 2e 0a 0a 33 2e  20 54 68 69 73 20 74 65  |ile...3. This te|
00000200  78 74 20 66 69 6c 65 20  61 63 63 6f 6d 70 61 6e  |xt file accompan|
00000210  69 65 73 20 61 6c 6c 20  63 6f 70 69 65 73 20 6f  |ies all copies o|
00000220  66 20 74 68 65 20 73 6f  66 74 77 61 72 65 2e 0a  |f the software..|
00000230  0a 50 6c 65 61 73 65 20  6e 6f 74 65 20 74 68 61  |.Please note tha|
00000240  74 20 74 68 69 73 20 6d  6f 64 75 6c 65 20 77 69  |t this module wi|
00000250  6c 6c 20 6f 6e 6c 79 20  77 6f 72 6b 20 77 69 74  |ll only work wit|
00000260  68 20 52 49 53 43 20 4f  53 20 33 20 6f 72 20 6c  |h RISC OS 3 or l|
00000270  61 74 65 72 2e 0a 0a 49  43 6c 65 61 72 20 69 73  |ater...IClear is|
00000280  20 61 20 6d 6f 64 75 6c  65 20 77 68 69 63 68 20  | a module which |
00000290  6d 61 6b 65 73 20 69 74  20 65 61 73 69 65 72 20  |makes it easier |
000002a0  74 6f 20 64 65 6c 65 74  65 20 74 65 78 74 20 66  |to delete text f|
000002b0  72 6f 6d 20 61 20 77 72  69 74 61 62 6c 65 0a 69  |rom a writable.i|
000002c0  63 6f 6e 2e 20 55 6e 64  65 72 20 52 49 53 43 20  |con. Under RISC |
000002d0  4f 53 2c 20 74 6f 20 72  65 70 6c 61 63 65 20 74  |OS, to replace t|
000002e0  68 65 20 74 65 78 74 20  69 6e 20 73 75 63 68 20  |he text in such |
000002f0  61 6e 20 69 63 6f 6e 20  77 69 74 68 20 6e 65 77  |an icon with new|
00000300  20 74 65 78 74 2c 20 79  6f 75 0a 66 69 72 73 74  | text, you.first|
00000310  20 68 61 76 65 20 74 6f  20 65 69 74 68 65 72 20  | have to either |
00000320  64 65 6c 65 74 65 20 61  6c 6c 20 74 68 65 20 63  |delete all the c|
00000330  68 61 72 61 63 74 65 72  73 20 6f 66 20 74 68 65  |haracters of the|
00000340  20 6f 6c 64 20 74 65 78  74 20 6f 72 20 70 72 65  | old text or pre|
00000350  73 73 0a 43 74 72 6c 2d  55 20 74 6f 20 63 6c 65  |ss.Ctrl-U to cle|
00000360  61 72 20 69 74 2e 20 54  68 69 73 20 63 61 6e 20  |ar it. This can |
00000370  62 65 20 61 20 6e 75 69  73 61 6e 63 65 2c 20 65  |be a nuisance, e|
00000380  73 70 65 63 69 61 6c 6c  79 20 69 66 20 79 6f 75  |specially if you|
00000390  20 68 61 76 65 20 6a 75  73 74 0a 73 65 6c 65 63  | have just.selec|
000003a0  74 65 64 20 74 68 65 20  69 63 6f 6e 20 77 69 74  |ted the icon wit|
000003b0  68 20 74 68 65 20 6d 6f  75 73 65 2c 20 61 73 20  |h the mouse, as |
000003c0  79 6f 75 20 66 69 72 73  74 20 68 61 76 65 20 74  |you first have t|
000003d0  6f 20 74 72 61 6e 73 66  65 72 20 74 6f 20 74 68  |o transfer to th|
000003e0  65 0a 6b 65 79 62 6f 61  72 64 2c 20 74 68 65 6e  |e.keyboard, then|
000003f0  20 70 72 65 73 73 20 43  74 72 6c 2d 55 20 62 65  | press Ctrl-U be|
00000400  66 6f 72 65 20 79 6f 75  20 63 61 6e 20 74 79 70  |fore you can typ|
00000410  65 20 69 6e 20 79 6f 75  72 20 6e 65 77 20 74 65  |e in your new te|
00000420  78 74 2e 0a 0a 57 69 74  68 20 49 43 6c 65 61 72  |xt...With IClear|
00000430  20 72 75 6e 6e 69 6e 67  2c 20 73 69 6d 70 6c 79  | running, simply|
00000440  20 64 6f 75 62 6c 65 2d  63 6c 69 63 6b 20 6f 6e  | double-click on|
00000450  20 74 68 65 20 77 72 69  74 61 62 6c 65 20 69 63  | the writable ic|
00000460  6f 6e 2c 20 75 73 69 6e  67 20 65 69 74 68 65 72  |on, using either|
00000470  0a 53 65 6c 65 63 74 20  6f 72 20 41 64 6a 75 73  |.Select or Adjus|
00000480  74 2e 20 54 68 65 20 69  63 6f 6e 20 77 69 6c 6c  |t. The icon will|
00000490  20 62 65 20 69 6e 76 65  72 74 65 64 2c 20 77 68  | be inverted, wh|
000004a0  69 63 68 20 75 73 75 61  6c 6c 79 20 6d 65 61 6e  |ich usually mean|
000004b0  73 20 74 68 61 74 20 69  74 0a 77 69 6c 6c 20 74  |s that it.will t|
000004c0  75 72 6e 20 62 6c 61 63  6b 20 77 69 74 68 20 77  |urn black with w|
000004d0  68 69 74 65 20 74 65 78  74 2e 20 41 73 20 73 6f  |hite text. As so|
000004e0  6f 6e 20 61 73 20 79 6f  75 20 70 72 65 73 73 20  |on as you press |
000004f0  61 20 6b 65 79 2c 20 74  68 65 20 74 65 78 74 20  |a key, the text |
00000500  69 6e 20 74 68 65 0a 69  63 6f 6e 20 77 69 6c 6c  |in the.icon will|
00000510  20 76 61 6e 69 73 68 2c  20 74 6f 20 62 65 20 72  | vanish, to be r|
00000520  65 70 6c 61 63 65 64 20  77 69 74 68 20 74 68 65  |eplaced with the|
00000530  20 63 68 61 72 61 63 74  65 72 20 74 68 61 74 20  | character that |
00000540  79 6f 75 20 74 79 70 65  64 2e 20 49 66 20 79 6f  |you typed. If yo|
00000550  75 0a 63 68 61 6e 67 65  20 79 6f 75 72 20 6d 69  |u.change your mi|
00000560  6e 64 20 61 66 74 65 72  20 69 6e 76 65 72 74 69  |nd after inverti|
00000570  6e 67 20 74 68 65 20 69  63 6f 6e 20 61 6e 64 20  |ng the icon and |
00000580  64 65 63 69 64 65 20 79  6f 75 20 77 61 6e 74 20  |decide you want |
00000590  74 6f 20 6b 65 65 70 20  79 6f 75 72 0a 65 78 69  |to keep your.exi|
000005a0  73 74 69 6e 67 20 74 65  78 74 2c 20 61 20 66 75  |sting text, a fu|
000005b0  72 74 68 65 72 20 63 6c  69 63 6b 20 77 69 74 68  |rther click with|
000005c0  20 61 6e 79 20 6d 6f 75  73 65 20 62 75 74 74 6f  | any mouse butto|
000005d0  6e 20 61 6e 79 77 68 65  72 65 20 6f 6e 20 74 68  |n anywhere on th|
000005e0  65 20 73 63 72 65 65 6e  0a 77 69 6c 6c 20 64 65  |e screen.will de|
000005f0  2d 69 6e 76 65 72 74 20  74 68 65 20 69 63 6f 6e  |-invert the icon|
00000600  20 61 6e 64 20 70 75 74  20 74 68 69 6e 67 73 20  | and put things |
00000610  62 61 63 6b 20 74 6f 20  6e 6f 72 6d 61 6c 2e 0a  |back to normal..|
00000620  0a 54 68 69 73 20 73 6f  66 74 77 61 72 65 20 77  |.This software w|
00000630  69 6c 6c 20 77 6f 72 6b  20 77 69 74 68 20 77 72  |ill work with wr|
00000640  69 74 61 62 6c 65 20 69  63 6f 6e 73 20 28 62 75  |itable icons (bu|
00000650  74 74 6f 6e 20 74 79 70  65 20 31 35 29 20 61 6e  |tton type 15) an|
00000660  64 20 61 6c 73 6f 0a 64  72 61 67 67 61 62 6c 65  |d also.draggable|
00000670  20 77 72 69 74 61 62 6c  65 20 69 63 6f 6e 73 20  | writable icons |
00000680  28 62 75 74 74 6f 6e 20  74 79 70 65 20 31 34 29  |(button type 14)|
00000690  20 62 75 74 20 6e 6f 74  20 77 69 74 68 20 77 72  | but not with wr|
000006a0  69 74 61 62 6c 65 20 6d  65 6e 75 20 69 74 65 6d  |itable menu item|
000006b0  73 2e 0a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |s...            |
000006c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000006d0  20 50 72 6f 67 72 61 6d  6d 69 6e 67 20 4e 6f 74  | Programming Not|
000006e0  65 73 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |es.             |
000006f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000700  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 20 3d 3d 3d 3d  |=========== ====|
00000710  3d 0a 0a 54 68 65 20 6d  6f 64 75 6c 65 20 69 6e  |=..The module in|
00000720  74 65 72 63 65 70 74 73  20 74 68 65 20 4d 6f 75  |tercepts the Mou|
00000730  73 65 56 20 61 6e 64 20  49 6e 73 56 20 76 65 63  |seV and InsV vec|
00000740  74 6f 72 73 20 74 6f 20  64 65 74 65 63 74 20 63  |tors to detect c|
00000750  61 6c 6c 73 20 74 6f 0a  4f 53 5f 4d 6f 75 73 65  |alls to.OS_Mouse|
00000760  20 61 6e 64 20 6b 65 79  70 72 65 73 73 65 73 2e  | and keypresses.|
00000770  20 4f 53 5f 4d 6f 75 73  65 20 63 61 6c 6c 73 20  | OS_Mouse calls |
00000780  61 72 65 20 66 69 72 73  74 20 70 61 73 73 65 64  |are first passed|
00000790  20 6f 6e 74 6f 20 74 68  65 20 53 57 49 0a 72 6f  | onto the SWI.ro|
000007a0  75 74 69 6e 65 20 61 6e  64 20 70 72 6f 63 65 73  |utine and proces|
000007b0  73 65 64 20 6f 6e 20 65  78 69 74 2e 0a 0a 42 65  |sed on exit...Be|
000007c0  63 61 75 73 65 20 52 49  53 43 20 4f 53 20 77 69  |cause RISC OS wi|
000007d0  6c 6c 20 6e 6f 74 20 61  75 74 6f 6d 61 74 69 63  |ll not automatic|
000007e0  61 6c 6c 79 20 64 65 74  65 63 74 20 61 20 64 6f  |ally detect a do|
000007f0  75 62 6c 65 2d 63 6c 69  63 6b 20 6f 76 65 72 20  |uble-click over |
00000800  61 20 77 72 69 74 61 62  6c 65 0a 69 63 6f 6e 2c  |a writable.icon,|
00000810  20 74 68 65 20 6d 6f 64  75 6c 65 20 68 61 73 20  | the module has |
00000820  74 6f 20 64 6f 20 74 68  65 20 6a 6f 62 20 69 74  |to do the job it|
00000830  73 65 6c 66 2e 20 54 68  69 73 20 69 6e 76 6f 6c  |self. This invol|
00000840  76 65 73 20 63 68 65 63  6b 69 6e 67 20 74 68 65  |ves checking the|
00000850  20 74 69 6d 65 0a 69 6e  74 65 72 76 61 6c 20 73  | time.interval s|
00000860  69 6e 63 65 20 74 68 65  20 70 72 65 76 69 6f 75  |ince the previou|
00000870  73 20 63 6c 69 63 6b 2c  20 73 65 6c 65 63 74 69  |s click, selecti|
00000880  6e 67 20 74 68 65 20 27  64 6f 75 62 6c 65 2d 61  |ng the 'double-a|
00000890  72 72 6f 77 27 20 70 6f  69 6e 74 65 72 0a 73 70  |rrow' pointer.sp|
000008a0  72 69 74 65 2c 20 63 68  65 63 6b 69 6e 67 20 77  |rite, checking w|
000008b0  68 69 63 68 20 62 75 74  74 6f 6e 20 77 61 73 20  |hich button was |
000008c0  70 72 65 73 73 65 64 20  61 6e 64 20 6d 6f 6e 69  |pressed and moni|
000008d0  74 6f 72 69 6e 67 20 74  68 65 20 6d 6f 75 73 65  |toring the mouse|
000008e0  20 70 6f 73 69 74 69 6f  6e 2e 0a 0a 52 61 74 68  | position...Rath|
000008f0  65 72 20 74 68 61 6e 20  70 75 74 20 74 6f 6f 20  |er than put too |
00000900  6d 75 63 68 20 63 6f 64  65 20 69 6e 74 6f 20 61  |much code into a|
00000910  20 76 65 63 74 6f 72 20  69 6e 74 65 72 63 65 70  | vector intercep|
00000920  74 20 72 6f 75 74 69 6e  65 2c 20 74 68 65 20 73  |t routine, the s|
00000930  6f 66 74 77 61 72 65 0a  6a 75 73 74 20 73 65 74  |oftware.just set|
00000940  73 20 6f 6e 65 20 6f 66  20 74 77 6f 20 63 61 6c  |s one of two cal|
00000950  6c 62 61 63 6b 73 2c 20  64 65 70 65 6e 64 69 6e  |lbacks, dependin|
00000960  67 20 6f 6e 20 74 68 65  20 74 69 6d 65 20 69 6e  |g on the time in|
00000970  74 65 72 76 61 6c 20 73  69 6e 63 65 20 74 68 65  |terval since the|
00000980  0a 70 72 65 76 69 6f 75  73 20 63 6c 69 63 6b 2e  |.previous click.|
00000990  20 54 68 65 20 63 61 6c  6c 62 61 63 6b 20 72 6f  | The callback ro|
000009a0  75 74 69 6e 65 20 69 73  20 63 61 6c 6c 65 64 20  |utine is called |
000009b0  62 79 20 52 49 53 43 20  4f 53 20 61 73 20 73 6f  |by RISC OS as so|
000009c0  6f 6e 20 61 73 20 69 74  20 69 73 0a 6e 6f 74 20  |on as it is.not |
000009d0  62 75 73 79 2e 20 54 68  65 20 66 69 72 73 74 20  |busy. The first |
000009e0  6f 66 20 74 68 65 73 65  20 63 61 6c 6c 62 61 63  |of these callbac|
000009f0  6b 73 20 68 61 6e 64 6c  65 73 20 61 20 73 69 6e  |ks handles a sin|
00000a00  67 6c 65 20 63 6c 69 63  6b 2e 20 49 74 20 66 69  |gle click. It fi|
00000a10  72 73 74 0a 63 68 65 63  6b 73 20 74 6f 20 73 65  |rst.checks to se|
00000a20  65 20 69 66 20 74 68 65  20 6d 6f 64 75 6c 65 20  |e if the module |
00000a30  68 61 73 20 61 20 72 65  63 6f 72 64 20 6f 66 20  |has a record of |
00000a40  61 6e 20 69 6e 76 65 72  74 65 64 20 69 63 6f 6e  |an inverted icon|
00000a50  20 61 6e 64 2c 20 69 66  20 73 6f 2c 0a 74 61 6b  | and, if so,.tak|
00000a60  65 73 20 73 74 65 70 73  20 74 6f 20 63 6c 65 61  |es steps to clea|
00000a70  72 20 69 74 2e 20 49 74  20 74 68 65 6e 20 73 74  |r it. It then st|
00000a80  6f 72 65 73 20 61 20 72  65 63 6f 72 64 20 6f 66  |ores a record of|
00000a90  20 77 68 69 63 68 20 62  75 74 74 6f 6e 20 77 61  | which button wa|
00000aa0  73 20 70 72 65 73 73 65  64 0a 61 6e 64 20 63 68  |s pressed.and ch|
00000ab0  65 63 6b 73 20 74 68 65  20 69 63 6f 6e 20 74 79  |ecks the icon ty|
00000ac0  70 65 2e 20 49 66 20 74  68 65 20 63 6c 69 63 6b  |pe. If the click|
00000ad0  20 77 61 73 20 6f 76 65  72 20 61 20 77 72 69 74  | was over a writ|
00000ae0  61 62 6c 65 20 69 63 6f  6e 2c 20 69 74 20 73 74  |able icon, it st|
00000af0  6f 72 65 73 0a 74 68 65  20 6d 6f 75 73 65 20 70  |ores.the mouse p|
00000b00  6f 73 69 74 69 6f 6e 20  61 6e 64 20 72 65 64 65  |osition and rede|
00000b10  66 69 6e 65 73 20 6d 6f  75 73 65 20 70 6f 69 6e  |fines mouse poin|
00000b20  74 65 72 20 31 20 73 70  72 69 74 65 20 61 73 20  |ter 1 sprite as |
00000b30  70 74 72 5f 64 6f 75 62  6c 65 2e 0a 0a 4e 2e 42  |ptr_double...N.B|
00000b40  2e 20 54 68 65 72 65 20  61 70 70 65 61 72 73 20  |. There appears |
00000b50  74 6f 20 62 65 20 6e 6f  20 77 61 79 20 6f 66 20  |to be no way of |
00000b60  72 65 61 64 69 6e 67 20  77 68 69 63 68 20 73 70  |reading which sp|
00000b70  72 69 74 65 20 69 73 20  75 73 65 64 20 62 79 20  |rite is used by |
00000b80  61 0a 70 61 72 74 69 63  75 6c 61 72 20 70 6f 69  |a.particular poi|
00000b90  6e 74 65 72 20 6e 75 6d  62 65 72 2e 20 56 65 72  |nter number. Ver|
00000ba0  73 69 6f 6e 73 20 6f 66  20 74 68 69 73 20 6d 6f  |sions of this mo|
00000bb0  64 75 6c 65 20 75 70 20  74 6f 20 76 31 2e 30 31  |dule up to v1.01|
00000bc0  20 61 6c 77 61 79 73 0a  72 65 70 6c 61 63 65 64  | always.replaced|
00000bd0  20 74 68 65 20 64 6f 75  62 6c 65 20 70 6f 69 6e  | the double poin|
00000be0  74 65 72 20 77 69 74 68  20 74 68 65 20 70 74 72  |ter with the ptr|
00000bf0  5f 64 65 66 61 75 6c 74  20 73 70 72 69 74 65 20  |_default sprite |
00000c00  61 66 74 65 72 20 74 68  65 0a 64 6f 75 62 6c 65  |after the.double|
00000c10  2d 63 6c 69 63 6b 20 74  69 6d 65 2d 6f 75 74 2e  |-click time-out.|
00000c20  20 56 65 72 73 69 6f 6e  20 76 31 2e 31 30 20 63  | Version v1.10 c|
00000c30  68 65 63 6b 73 20 74 68  65 20 69 63 6f 6e 91 73  |hecks the icon.s|
00000c40  20 76 61 6c 69 64 61 74  69 6f 6e 20 73 74 72 69  | validation stri|
00000c50  6e 67 2c 20 69 66 0a 61  6e 79 2c 20 6c 6f 6f 6b  |ng, if.any, look|
00000c60  69 6e 67 20 66 6f 72 20  74 68 65 20 90 50 91 20  |ing for the .P. |
00000c70  69 6e 73 74 72 75 63 74  69 6f 6e 2c 20 77 68 69  |instruction, whi|
00000c80  63 68 20 73 65 74 73 20  61 6e 20 61 6c 74 65 72  |ch sets an alter|
00000c90  6e 61 74 69 76 65 20 70  6f 69 6e 74 65 72 0a 73  |native pointer.s|
00000ca0  70 72 69 74 65 20 77 68  65 6e 20 6f 76 65 72 20  |prite when over |
00000cb0  74 68 65 20 69 63 6f 6e  2c 20 61 6e 64 20 72 65  |the icon, and re|
00000cc0  73 74 6f 72 65 73 20 74  68 65 20 70 6f 69 6e 74  |stores the point|
00000cd0  65 72 20 74 6f 20 74 68  69 73 20 73 70 72 69 74  |er to this sprit|
00000ce0  65 20 61 66 74 65 72 0a  66 69 72 73 74 20 63 68  |e after.first ch|
00000cf0  65 63 6b 69 6e 67 20 69  74 73 20 70 72 65 73 65  |ecking its prese|
00000d00  6e 63 65 20 69 6e 20 74  68 65 20 57 69 6d 70 20  |nce in the Wimp |
00000d10  73 70 72 69 74 65 20 70  6f 6f 6c 2e 0a 0a 54 68  |sprite pool...Th|
00000d20  65 20 6d 6f 64 75 6c 65  20 74 68 65 6e 20 73 65  |e module then se|
00000d30  74 73 20 61 20 63 61 6c  6c 2d 61 66 74 65 72 2c  |ts a call-after,|
00000d40  20 77 68 69 63 68 20 69  73 20 61 6e 20 69 6e 73  | which is an ins|
00000d50  74 72 75 63 74 69 6f 6e  20 74 6f 20 52 49 53 43  |truction to RISC|
00000d60  20 4f 53 20 74 6f 0a 63  61 6c 6c 20 61 20 72 6f  | OS to.call a ro|
00000d70  75 74 69 6e 65 20 61 66  74 65 72 20 61 20 63 65  |utine after a ce|
00000d80  72 74 61 69 6e 20 6c 65  6e 67 74 68 20 6f 66 20  |rtain length of |
00000d90  74 69 6d 65 2e 20 49 74  20 61 6c 73 6f 20 63 61  |time. It also ca|
00000da0  6c 6c 73 20 4f 53 5f 43  61 6c 6c 45 76 65 72 79  |lls OS_CallEvery|
00000db0  20 74 6f 0a 61 72 72 61  6e 67 65 20 66 6f 72 20  | to.arrange for |
00000dc0  61 20 63 61 6c 6c 20 65  76 65 72 79 20 31 30 20  |a call every 10 |
00000dd0  63 65 6e 74 69 73 65 63  6f 6e 64 73 20 74 6f 20  |centiseconds to |
00000de0  61 20 72 6f 75 74 69 6e  65 20 77 68 69 63 68 20  |a routine which |
00000df0  63 68 65 63 6b 73 20 74  68 65 20 6d 6f 75 73 65  |checks the mouse|
00000e00  0a 70 6f 73 69 74 69 6f  6e 20 61 6e 64 20 63 61  |.position and ca|
00000e10  6e 63 65 6c 73 20 74 68  65 20 64 6f 75 62 6c 65  |ncels the double|
00000e20  2d 63 6c 69 63 6b 20 6d  6f 6e 69 74 6f 72 69 6e  |-click monitorin|
00000e30  67 20 69 66 20 74 68 65  20 6d 6f 75 73 65 20 69  |g if the mouse i|
00000e40  73 20 6d 6f 76 65 64 20  6d 6f 72 65 0a 74 68 61  |s moved more.tha|
00000e50  6e 20 61 20 63 65 72 74  61 69 6e 20 61 6d 6f 75  |n a certain amou|
00000e60  6e 74 2e 0a 0a 4e 2e 42  2e 20 41 6c 74 68 6f 75  |nt...N.B. Althou|
00000e70  67 68 20 74 68 65 20 6e  6f 72 6d 61 6c 20 64 6f  |gh the normal do|
00000e80  75 62 6c 65 2d 63 6c 69  63 6b 20 74 69 6d 65 20  |uble-click time |
00000e90  6c 69 6d 69 74 20 61 6e  64 20 70 65 72 6d 69 74  |limit and permit|
00000ea0  74 65 64 20 6d 6f 75 73  65 0a 6d 6f 76 65 6d 65  |ted mouse.moveme|
00000eb0  6e 74 20 63 61 6e 20 62  65 20 63 6f 6e 66 69 67  |nt can be config|
00000ec0  75 72 65 64 2c 20 74 68  65 72 65 20 61 70 70 65  |ured, there appe|
00000ed0  61 72 73 20 74 6f 20 62  65 20 6e 6f 20 77 61 79  |ars to be no way|
00000ee0  20 6f 66 20 72 65 61 64  69 6e 67 20 74 68 65 69  | of reading thei|
00000ef0  72 0a 76 61 6c 75 65 73  2c 20 6f 74 68 65 72 20  |r.values, other |
00000f00  74 68 61 6e 20 74 68 65  20 75 6e 72 65 6c 69 61  |than the unrelia|
00000f10  62 6c 65 20 6d 65 74 68  6f 64 20 6f 66 20 63 68  |ble method of ch|
00000f20  65 63 6b 69 6e 67 20 43  4d 4f 53 20 52 41 4d 20  |ecking CMOS RAM |
00000f30  6c 6f 63 61 74 69 6f 6e  73 2c 0a 77 68 69 63 68  |locations,.which|
00000f40  20 63 6f 75 6c 64 20 63  68 61 6e 67 65 20 62 65  | could change be|
00000f50  74 77 65 65 6e 20 64 69  66 66 65 72 65 6e 74 20  |tween different |
00000f60  76 65 72 73 69 6f 6e 73  20 6f 66 20 52 49 53 43  |versions of RISC|
00000f70  20 4f 53 2e 20 54 68 69  73 20 6d 6f 64 75 6c 65  | OS. This module|
00000f80  20 75 73 65 73 0a 74 68  65 20 64 65 66 61 75 6c  | uses.the defaul|
00000f90  74 20 63 6f 6e 66 69 67  75 72 61 74 69 6f 6e 20  |t configuration |
00000fa0  76 61 6c 75 65 73 20 6f  66 20 31 20 73 65 63 6f  |values of 1 seco|
00000fb0  6e 64 20 6d 61 78 69 6d  75 6d 20 62 65 74 77 65  |nd maximum betwe|
00000fc0  65 6e 20 63 6c 69 63 6b  73 20 61 6e 64 20 61 0a  |en clicks and a.|
00000fd0  6d 61 78 69 6d 75 6d 20  6d 6f 75 73 65 20 6d 6f  |maximum mouse mo|
00000fe0  76 65 6d 65 6e 74 20 6f  66 20 31 30 20 4f 53 20  |vement of 10 OS |
00000ff0  75 6e 69 74 73 20 28 69  74 20 63 68 65 63 6b 73  |units (it checks|
00001000  20 66 6f 72 20 65 69 74  68 65 72 20 31 30 20 68  | for either 10 h|
00001010  6f 72 69 7a 6f 6e 74 61  6c 20 6f 72 0a 31 30 20  |orizontal or.10 |
00001020  76 65 72 74 69 63 61 6c  20 75 6e 69 74 73 20 6f  |vertical units o|
00001030  66 20 6d 6f 76 65 6d 65  6e 74 29 2e 20 54 68 65  |f movement). The|
00001040  73 65 20 76 61 6c 75 65  73 20 61 72 65 20 66 69  |se values are fi|
00001050  78 65 64 20 69 6e 20 74  68 69 73 20 76 65 72 73  |xed in this vers|
00001060  69 6f 6e 20 6f 66 0a 74  68 65 20 6d 6f 64 75 6c  |ion of.the modul|
00001070  65 2e 20 49 66 20 74 68  65 72 65 20 69 73 20 61  |e. If there is a|
00001080  20 64 65 6d 61 6e 64 20  66 6f 72 20 74 68 65 20  | demand for the |
00001090  61 62 69 6c 69 74 79 20  74 6f 20 61 6c 74 65 72  |ability to alter|
000010a0  20 74 68 65 73 65 20 76  61 6c 75 65 73 2c 20 49  | these values, I|
000010b0  0a 77 69 6c 6c 20 65 6e  64 65 61 76 6f 75 72 20  |.will endeavour |
000010c0  74 6f 20 69 6e 63 6c 75  64 65 20 61 20 63 6f 75  |to include a cou|
000010d0  70 6c 65 20 6f 66 20 53  57 49 73 20 61 6e 64 2f  |ple of SWIs and/|
000010e0  6f 72 20 73 74 61 72 20  63 6f 6d 6d 61 6e 64 73  |or star commands|
000010f0  20 69 6e 20 61 20 6c 61  74 65 72 0a 76 65 72 73  | in a later.vers|
00001100  69 6f 6e 2e 0a 0a 49 66  20 65 69 74 68 65 72 20  |ion...If either |
00001110  61 20 73 65 63 6f 6e 64  20 62 75 74 74 6f 6e 20  |a second button |
00001120  69 73 20 70 72 65 73 73  65 64 20 6f 72 20 74 68  |is pressed or th|
00001130  65 20 6d 6f 75 73 65 20  69 73 20 6d 6f 76 65 64  |e mouse is moved|
00001140  20 62 65 66 6f 72 65 20  74 68 65 0a 63 61 6c 6c  | before the.call|
00001150  2d 61 66 74 65 72 20 68  61 73 20 74 69 6d 65 64  |-after has timed|
00001160  20 6f 75 74 2c 20 74 68  65 20 63 61 6c 6c 2d 61  | out, the call-a|
00001170  66 74 65 72 20 61 6e 64  20 63 61 6c 6c 2d 65 76  |fter and call-ev|
00001180  65 72 79 20 61 72 65 20  63 61 6e 63 65 6c 6c 65  |ery are cancelle|
00001190  64 20 61 6e 64 20 61 0a  73 65 63 6f 6e 64 20 63  |d and a.second c|
000011a0  61 6c 6c 62 61 63 6b 20  69 73 20 75 73 65 64 2e  |allback is used.|
000011b0  20 54 68 69 73 20 72 6f  75 74 69 6e 65 20 63 68  | This routine ch|
000011c0  65 63 6b 73 20 74 68 61  74 20 74 68 65 20 73 61  |ecks that the sa|
000011d0  6d 65 20 62 75 74 74 6f  6e 20 68 61 73 20 62 65  |me button has be|
000011e0  65 6e 0a 70 72 65 73 73  65 64 20 61 73 20 70 72  |en.pressed as pr|
000011f0  65 76 69 6f 75 73 6c 79  2c 20 73 65 74 73 20 61  |eviously, sets a|
00001200  20 66 6c 61 67 20 61 6e  64 20 74 61 6b 65 73 20  | flag and takes |
00001210  73 74 65 70 73 20 74 6f  20 69 6e 76 65 72 74 20  |steps to invert |
00001220  74 68 65 20 69 63 6f 6e  2e 0a 0a 41 6c 74 68 6f  |the icon...Altho|
00001230  75 67 68 20 61 6e 79 20  69 63 6f 6e 20 63 61 6e  |ugh any icon can|
00001240  20 62 65 20 69 6e 76 65  72 74 65 64 20 6f 72 20  | be inverted or |
00001250  64 65 2d 69 6e 76 65 72  74 65 64 20 62 79 20 6d  |de-inverted by m|
00001260  65 61 6e 73 20 6f 66 20  61 20 63 61 6c 6c 20 74  |eans of a call t|
00001270  6f 0a 57 69 6d 70 5f 53  65 74 49 63 6f 6e 53 74  |o.Wimp_SetIconSt|
00001280  61 74 65 2c 20 74 68 65  20 70 72 6f 63 65 64 75  |ate, the procedu|
00001290  72 65 20 69 73 20 6e 6f  74 20 74 68 61 74 20 73  |re is not that s|
000012a0  69 6d 70 6c 65 2e 20 54  68 69 73 20 53 57 49 20  |imple. This SWI |
000012b0  6d 61 79 20 6f 6e 6c 79  20 62 65 0a 63 61 6c 6c  |may only be.call|
000012c0  65 64 20 77 68 69 6c 65  20 74 68 65 20 61 70 70  |ed while the app|
000012d0  6c 69 63 61 74 69 6f 6e  20 77 68 69 63 68 20 6f  |lication which o|
000012e0  77 6e 73 20 74 68 65 20  69 63 6f 6e 20 69 73 20  |wns the icon is |
000012f0  74 68 65 20 63 75 72 72  65 6e 74 6c 79 20 61 63  |the currently ac|
00001300  74 69 76 65 0a 74 61 73  6b 2e 20 49 66 20 77 65  |tive.task. If we|
00001310  20 73 69 6d 70 6c 79 20  63 61 6c 6c 20 69 74 20  | simply call it |
00001320  77 68 65 6e 20 74 68 65  20 6d 6f 75 73 65 20 69  |when the mouse i|
00001330  73 20 63 6c 69 63 6b 65  64 2c 20 74 68 69 73 20  |s clicked, this |
00001340  6d 61 79 20 6e 6f 74 20  62 65 20 74 68 65 0a 63  |may not be the.c|
00001350  61 73 65 2c 20 65 73 70  65 63 69 61 6c 6c 79 20  |ase, especially |
00001360  69 66 20 73 65 76 65 72  61 6c 20 6d 75 6c 74 69  |if several multi|
00001370  2d 74 61 73 6b 69 6e 67  20 61 70 70 6c 69 63 61  |-tasking applica|
00001380  74 69 6f 6e 73 20 61 72  65 20 72 75 6e 6e 69 6e  |tions are runnin|
00001390  67 20 61 74 20 74 68 65  0a 73 61 6d 65 20 74 69  |g at the.same ti|
000013a0  6d 65 2e 20 57 65 20 68  61 76 65 20 74 6f 20 73  |me. We have to s|
000013b0  65 6e 64 20 61 20 6d 65  73 73 61 67 65 20 74 6f  |end a message to|
000013c0  20 74 68 65 20 74 61 73  6b 20 62 75 74 20 77 65  | the task but we|
000013d0  20 63 61 6e 6e 6f 74 2c  20 6f 66 20 63 6f 75 72  | cannot, of cour|
000013e0  73 65 2c 0a 72 65 77 72  69 74 65 20 69 74 73 20  |se,.rewrite its |
000013f0  73 6f 66 74 77 61 72 65  2e 0a 0a 54 68 65 20 73  |software...The s|
00001400  6f 6c 75 74 69 6f 6e 20  69 73 20 74 6f 20 75 73  |olution is to us|
00001410  65 20 61 20 66 69 6c 74  65 72 2e 20 57 65 20 63  |e a filter. We c|
00001420  6f 75 6c 64 20 75 73 65  20 61 20 70 72 65 2d 66  |ould use a pre-f|
00001430  69 6c 74 65 72 2c 20 77  68 69 63 68 20 69 73 20  |ilter, which is |
00001440  63 61 6c 6c 65 64 0a 6a  75 73 74 20 62 65 66 6f  |called.just befo|
00001450  72 65 20 57 69 6d 70 5f  50 6f 6c 6c 20 69 73 20  |re Wimp_Poll is |
00001460  65 78 65 63 75 74 65 64  2c 20 6f 72 20 61 20 70  |executed, or a p|
00001470  6f 73 74 2d 66 69 6c 74  65 72 20 77 68 69 63 68  |ost-filter which|
00001480  20 69 73 20 63 61 6c 6c  65 64 20 6f 6e 0a 72 65  | is called on.re|
00001490  74 75 72 6e 20 66 72 6f  6d 20 57 69 6d 70 5f 50  |turn from Wimp_P|
000014a0  6f 6c 6c 2e 20 49 6e 20  74 68 69 73 20 63 61 73  |oll. In this cas|
000014b0  65 2c 20 77 65 20 75 73  65 20 74 68 65 20 6c 61  |e, we use the la|
000014c0  74 74 65 72 2e 20 54 68  65 20 74 65 63 68 6e 69  |tter. The techni|
000014d0  71 75 65 20 69 73 20 74  6f 0a 73 65 6e 64 20 61  |que is to.send a|
000014e0  20 75 6e 69 71 75 65 20  6d 65 73 73 61 67 65 20  | unique message |
000014f0  74 6f 20 74 68 65 20 74  61 73 6b 20 77 68 69 63  |to the task whic|
00001500  68 20 6f 75 72 20 66 69  6c 74 65 72 20 77 69 6c  |h our filter wil|
00001510  6c 20 69 6e 74 65 72 63  65 70 74 20 61 6e 64 0a  |l intercept and.|
00001520  72 65 63 6f 67 6e 69 73  65 2c 20 74 65 6c 6c 69  |recognise, telli|
00001530  6e 67 20 69 74 20 74 6f  20 69 6e 76 65 72 74 20  |ng it to invert |
00001540  6f 72 20 64 65 2d 69 6e  76 65 72 74 20 74 68 65  |or de-invert the|
00001550  20 72 65 71 75 69 72 65  64 20 69 63 6f 6e 2e 20  | required icon. |
00001560  56 65 72 73 69 6f 6e 0a  76 31 2e 31 30 20 61 6c  |Version.v1.10 al|
00001570  73 6f 20 75 73 65 73 20  74 68 65 20 66 69 6c 74  |so uses the filt|
00001580  65 72 20 74 6f 20 63 68  65 63 6b 20 74 68 65 20  |er to check the |
00001590  69 63 6f 6e 91 73 20 76  61 6c 69 64 61 74 69 6f  |icon.s validatio|
000015a0  6e 20 73 74 72 69 6e 67  20 74 6f 20 67 65 74 20  |n string to get |
000015b0  74 68 65 0a 70 6f 69 6e  74 65 72 20 73 70 72 69  |the.pointer spri|
000015c0  74 65 20 6e 61 6d 65 2e  0a 0a 57 65 20 63 6f 75  |te name...We cou|
000015d0  6c 64 20 73 65 6e 64 20  61 20 6d 65 73 73 61 67  |ld send a messag|
000015e0  65 2c 20 75 73 69 6e 67  20 72 65 61 73 6f 6e 20  |e, using reason |
000015f0  63 6f 64 65 20 31 37 20  6f 72 20 31 38 2c 20 62  |code 17 or 18, b|
00001600  75 74 20 77 65 20 77 6f  75 6c 64 20 68 61 76 65  |ut we would have|
00001610  20 74 6f 0a 66 69 6e 64  20 61 20 6d 65 73 73 61  | to.find a messa|
00001620  67 65 20 61 63 74 69 6f  6e 20 63 6f 64 65 20 74  |ge action code t|
00001630  68 61 74 20 69 73 20 6e  6f 74 20 75 73 65 64 20  |hat is not used |
00001640  66 6f 72 20 61 6e 79 74  68 69 6e 67 20 65 6c 73  |for anything els|
00001650  65 2c 20 77 68 69 63 68  20 77 6f 75 6c 64 0a 70  |e, which would.p|
00001660  72 65 73 65 6e 74 20 70  72 6f 62 6c 65 6d 73 2e  |resent problems.|
00001670  20 49 74 20 69 73 20 61  6c 73 6f 20 70 65 72 6d  | It is also perm|
00001680  69 73 73 69 62 6c 65 20  66 6f 72 20 61 20 74 61  |issible for a ta|
00001690  73 6b 20 74 6f 20 6d 61  73 6b 20 6f 75 74 20 74  |sk to mask out t|
000016a0  68 65 73 65 20 72 65 61  73 6f 6e 0a 63 6f 64 65  |hese reason.code|
000016b0  73 2c 20 77 68 69 63 68  20 77 6f 75 6c 64 20 70  |s, which would p|
000016c0  72 65 76 65 6e 74 20 6f  75 72 20 6d 65 73 73 61  |revent our messa|
000016d0  67 65 20 67 65 74 74 69  6e 67 20 74 68 72 6f 75  |ge getting throu|
000016e0  67 68 2e 20 53 6f 20 74  68 61 74 20 74 68 69 73  |gh. So that this|
000016f0  20 63 61 6e 6e 6f 74 0a  68 61 70 70 65 6e 2c 20  | cannot.happen, |
00001700  74 68 65 20 6d 6f 64 75  6c 65 20 73 65 6e 64 73  |the module sends|
00001710  20 61 20 6d 65 73 73 61  67 65 20 77 69 74 68 20  | a message with |
00001720  72 65 61 73 6f 6e 20 63  6f 64 65 20 32 2c 20 77  |reason code 2, w|
00001730  68 69 63 68 20 75 73 75  61 6c 6c 79 20 6d 65 61  |hich usually mea|
00001740  6e 73 0a 27 6f 70 65 6e  20 77 69 6e 64 6f 77 20  |ns.'open window |
00001750  72 65 71 75 65 73 74 27  2e 20 54 68 69 73 20 72  |request'. This r|
00001760  65 61 73 6f 6e 20 63 6f  64 65 20 69 73 20 6e 6f  |eason code is no|
00001770  74 20 73 75 70 70 6f 73  65 64 20 74 6f 20 62 65  |t supposed to be|
00001780  20 6d 61 73 6b 65 64 20  6f 75 74 0a 77 68 65 6e  | masked out.when|
00001790  20 63 61 6c 6c 69 6e 67  20 57 69 6d 70 5f 50 6f  | calling Wimp_Po|
000017a0  6c 6c 2e 20 4f 75 72 20  6d 65 73 73 61 67 65 20  |ll. Our message |
000017b0  73 65 6e 64 73 20 52 31  2b 30 20 61 73 20 7a 65  |sends R1+0 as ze|
000017c0  72 6f 20 61 6e 64 20 52  31 2b 34 20 61 73 0a 26  |ro and R1+4 as.&|
000017d0  37 32 36 43 34 33 34 39  2c 20 77 68 69 63 68 20  |726C4349, which |
000017e0  69 73 20 74 68 65 20 41  53 43 49 49 20 63 6f 64  |is the ASCII cod|
000017f0  65 20 66 6f 72 20 27 49  43 6c 72 27 2e 20 54 68  |e for 'IClr'. Th|
00001800  69 73 20 63 6f 72 72 65  73 70 6f 6e 64 73 20 74  |is corresponds t|
00001810  6f 20 61 20 72 65 71 75  65 73 74 0a 74 6f 20 6f  |o a request.to o|
00001820  70 65 6e 20 74 68 65 20  77 69 6e 64 6f 77 20 77  |pen the window w|
00001830  68 6f 73 65 20 68 61 6e  64 6c 65 20 69 73 20 7a  |hose handle is z|
00001840  65 72 6f 2c 20 77 69 74  68 20 61 20 6d 69 6e 69  |ero, with a mini|
00001850  6d 75 6d 20 78 20 63 6f  6f 72 64 69 6e 61 74 65  |mum x coordinate|
00001860  20 6f 66 0a 26 37 32 36  43 34 33 34 39 20 2d 20  | of.&726C4349 - |
00001870  61 20 6d 6f 73 74 20 75  6e 6c 69 6b 65 6c 79 20  |a most unlikely |
00001880  73 74 61 74 65 20 6f 66  20 61 66 66 61 69 72 73  |state of affairs|
00001890  20 69 6e 20 61 6e 79 20  6f 74 68 65 72 20 73 69  | in any other si|
000018a0  74 75 61 74 69 6f 6e 21  20 54 68 65 0a 74 68 69  |tuation! The.thi|
000018b0  72 64 20 77 6f 72 64 20  69 6e 20 74 68 65 20 62  |rd word in the b|
000018c0  6c 6f 63 6b 20 63 6f 6e  74 61 69 6e 73 20 74 68  |lock contains th|
000018d0  65 20 61 63 74 69 6f 6e  20 63 6f 64 65 20 66 6f  |e action code fo|
000018e0  72 20 74 68 65 20 63 61  6c 6c 2e 20 42 69 74 20  |r the call. Bit |
000018f0  31 20 73 65 74 0a 64 65  6e 6f 74 65 73 20 74 68  |1 set.denotes th|
00001900  61 74 20 74 68 65 20 63  61 6c 6c 20 69 73 20 74  |at the call is t|
00001910  6f 20 69 6e 76 65 72 74  20 6f 72 20 63 6c 65 61  |o invert or clea|
00001920  72 20 74 68 65 20 69 63  6f 6e 20 2d 20 62 69 74  |r the icon - bit|
00001930  20 30 20 69 73 20 63 6c  65 61 72 65 64 20 74 6f  | 0 is cleared to|
00001940  0a 63 6c 65 61 72 2c 20  73 65 74 20 74 6f 20 69  |.clear, set to i|
00001950  6e 76 65 72 74 2e 20 42  69 74 20 32 20 69 73 20  |nvert. Bit 2 is |
00001960  73 65 74 20 74 6f 20 63  61 6c 6c 20 74 68 65 20  |set to call the |
00001970  72 6f 75 74 69 6e 65 20  74 6f 20 72 65 61 64 20  |routine to read |
00001980  74 68 65 0a 76 61 6c 69  64 61 74 69 6f 6e 20 73  |the.validation s|
00001990  74 72 69 6e 67 2e 0a 0a  49 66 20 61 20 6b 65 79  |tring...If a key|
000019a0  20 69 73 20 70 72 65 73  73 65 64 20 77 68 69 6c  | is pressed whil|
000019b0  65 20 74 68 65 20 69 6e  76 65 72 74 65 64 20 69  |e the inverted i|
000019c0  63 6f 6e 20 66 6c 61 67  20 69 73 20 73 65 74 2c  |con flag is set,|
000019d0  20 74 68 65 20 72 6f 75  74 69 6e 65 20 28 61 67  | the routine (ag|
000019e0  61 69 6e 0a 62 79 20 6d  65 61 6e 73 20 6f 66 20  |ain.by means of |
000019f0  61 20 63 61 6c 6c 62 61  63 6b 29 20 73 65 6e 64  |a callback) send|
00001a00  73 20 61 20 6d 65 73 73  61 67 65 20 74 6f 20 63  |s a message to c|
00001a10  6c 65 61 72 20 74 68 65  20 69 63 6f 6e 2c 20 74  |lear the icon, t|
00001a20  68 65 6e 20 73 65 6e 64  73 20 74 68 65 0a 6b 65  |hen sends the.ke|
00001a30  79 70 72 65 73 73 20 63  68 61 72 61 63 74 65 72  |ypress character|
00001a40  2c 20 70 72 65 63 65 64  65 64 20 62 79 20 61 20  |, preceded by a |
00001a50  43 74 72 6c 2d 55 20 74  6f 20 64 65 6c 65 74 65  |Ctrl-U to delete|
00001a60  20 74 68 65 20 74 65 78  74 2e 0a 0a 54 68 65 20  | the text...The |
00001a70  6d 6f 64 75 6c 65 20 69  6e 63 6f 72 70 6f 72 61  |module incorpora|
00001a80  74 65 73 20 61 20 73 65  6c 66 2d 63 68 65 63 6b  |tes a self-check|
00001a90  69 6e 67 20 72 6f 75 74  69 6e 65 20 74 6f 20 64  |ing routine to d|
00001aa0  65 74 65 63 74 20 63 6f  72 72 75 70 74 69 6f 6e  |etect corruption|
00001ab0  20 62 79 0a 76 69 72 75  73 65 73 2e 0a 0a 49 6e  | by.viruses...In|
00001ac0  63 69 64 65 6e 74 61 6c  6c 79 2c 20 75 73 65 20  |cidentally, use |
00001ad0  6f 66 20 74 68 69 73 20  6d 6f 64 75 6c 65 20 68  |of this module h|
00001ae0  61 73 20 72 65 76 65 61  6c 65 64 20 74 68 61 74  |as revealed that|
00001af0  20 74 68 65 20 63 6f 6e  66 69 67 75 72 61 74 69  | the configurati|
00001b00  6f 6e 0a 64 69 61 6c 6f  67 75 65 20 62 6f 78 20  |on.dialogue box |
00001b10  6f 66 20 50 43 20 45 6d  75 6c 61 74 6f 72 20 76  |of PC Emulator v|
00001b20  31 2e 37 30 20 63 6f 6e  74 61 69 6e 73 20 61 20  |1.70 contains a |
00001b30  77 72 69 74 61 62 6c 65  20 69 63 6f 6e 20 77 68  |writable icon wh|
00001b40  69 63 68 20 77 61 73 20  63 72 65 61 74 65 64 0a  |ich was created.|
00001b50  69 6e 20 69 74 73 20 69  6e 76 65 72 74 65 64 20  |in its inverted |
00001b60  73 74 61 74 65 2e 20 49  74 73 20 72 65 73 70 6f  |state. Its respo|
00001b70  6e 73 65 20 74 6f 20 61  20 64 6f 75 62 6c 65 2d  |nse to a double-|
00001b80  63 6c 69 63 6b 20 69 73  20 74 6f 20 72 65 6d 61  |click is to rema|
00001b90  69 6e 0a 62 6c 61 63 6b  2d 6f 6e 2d 77 68 69 74  |in.black-on-whit|
00001ba0  65 2e 20 41 20 73 75 62  73 65 71 75 65 6e 74 20  |e. A subsequent |
00001bb0  73 69 6e 67 6c 65 20 63  6c 69 63 6b 20 63 6c 65  |single click cle|
00001bc0  61 72 73 20 69 74 20 74  6f 20 77 68 69 74 65 2d  |ars it to white-|
00001bd0  6f 6e 2d 62 6c 61 63 6b  21 0a 0a 50 6c 65 61 73  |on-black!..Pleas|
00001be0  65 20 73 65 6e 64 20 61  6c 6c 20 63 6f 6d 6d 65  |e send all comme|
00001bf0  6e 74 73 20 61 6e 64 20  73 75 67 67 65 73 74 69  |nts and suggesti|
00001c00  6f 6e 73 20 74 6f 3a 0a  0a 4d 2e 50 2e 20 46 6f  |ons to:..M.P. Fo|
00001c10  78 2c 0a 33 31 20 50 69  65 72 73 6f 6e 20 52 6f  |x,.31 Pierson Ro|
00001c20  61 64 2c 0a 57 69 6e 64  73 6f 72 2c 0a 42 65 72  |ad,.Windsor,.Ber|
00001c30  6b 73 2e 20 53 4c 34 20  35 52 45                 |ks. SL4 5RE|
00001c3b