Home » Archimedes archive » Acorn User » AU 1997-06 B.adf » Extras » RiscUtils/!RuInstall/Install/!Help/Help/Text/Help/Key-Num

RiscUtils/!RuInstall/Install/!Help/Help/Text/Help/Key-Num

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 » Archimedes archive » Acorn User » AU 1997-06 B.adf » Extras
Filename: RiscUtils/!RuInstall/Install/!Help/Help/Text/Help/Key-Num
Read OK:
File size: 058D bytes
Load address: 0000
Exec address: 0000
File contents
Check_KeyboardNumber : This command works along the same lines as the 'Check_KeyboardState' and 'Check_MouseState' commands (see the 'Key-Stat' and 'Mouse-Stat' Helpfiles). It enables the user to find out what (if any) key is being pressed on the keyboard at the time the command is issued.Useful for intelligent Run file's. E.g. While Booting, press 'i' to Run Impression, 'a' for Artworks etc. Or before loading Edit, hold down 'F' to load flasher as well. If no key is pressed, only Edit is loaded.

Using the command :

The command has no parameters, once issued it simply sets a variable. The command provided is : 

Check_KeyBoardNumber

When issued the variable 

KeyBoardNumber

is set to a certain number, depending on the state of the keyboard.


To get to grips with the command easliy, run the files KeyNum1, and Num-Con, in the Directory RISCutils.User_Area.Demo's.

The command can be used as so: (E.g. in boot sequences)

Run ADFS::HardDisc4.$.!Tools.FILES.!RISCutils 
Check_KeyBoardNumber
IF keyboardNumber=�-113� Then Run ADFS::HardDisc4.$.!Games.Files.!Star3000
IF keyboardNumber=�-243� Then Run ADFS::HardDisc4.$.!DTP.Packages.!Publish+

To activate the component simply run 'RISCutils', with the 'Check_KeyboardNumber' option in RISCutil's !Run file set to 'Y'. To de-activate it run the file RISCutils.User_Area.Files.Remove, and run 'RISCutils', with the 'Check_KeyboardNumber' option set to 'N.'

00000000  0a 43 68 65 63 6b 5f 4b  65 79 62 6f 61 72 64 4e  |.Check_KeyboardN|
00000010  75 6d 62 65 72 20 3a 20  54 68 69 73 20 63 6f 6d  |umber : This com|
00000020  6d 61 6e 64 20 77 6f 72  6b 73 20 61 6c 6f 6e 67  |mand works along|
00000030  20 74 68 65 20 73 61 6d  65 20 6c 69 6e 65 73 20  | the same lines |
00000040  61 73 20 74 68 65 20 27  43 68 65 63 6b 5f 4b 65  |as the 'Check_Ke|
00000050  79 62 6f 61 72 64 53 74  61 74 65 27 20 61 6e 64  |yboardState' and|
00000060  20 27 43 68 65 63 6b 5f  4d 6f 75 73 65 53 74 61  | 'Check_MouseSta|
00000070  74 65 27 20 63 6f 6d 6d  61 6e 64 73 20 28 73 65  |te' commands (se|
00000080  65 20 74 68 65 20 27 4b  65 79 2d 53 74 61 74 27  |e the 'Key-Stat'|
00000090  20 61 6e 64 20 27 4d 6f  75 73 65 2d 53 74 61 74  | and 'Mouse-Stat|
000000a0  27 20 48 65 6c 70 66 69  6c 65 73 29 2e 20 49 74  |' Helpfiles). It|
000000b0  20 65 6e 61 62 6c 65 73  20 74 68 65 20 75 73 65  | enables the use|
000000c0  72 20 74 6f 20 66 69 6e  64 20 6f 75 74 20 77 68  |r to find out wh|
000000d0  61 74 20 28 69 66 20 61  6e 79 29 20 6b 65 79 20  |at (if any) key |
000000e0  69 73 20 62 65 69 6e 67  20 70 72 65 73 73 65 64  |is being pressed|
000000f0  20 6f 6e 20 74 68 65 20  6b 65 79 62 6f 61 72 64  | on the keyboard|
00000100  20 61 74 20 74 68 65 20  74 69 6d 65 20 74 68 65  | at the time the|
00000110  20 63 6f 6d 6d 61 6e 64  20 69 73 20 69 73 73 75  | command is issu|
00000120  65 64 2e 55 73 65 66 75  6c 20 66 6f 72 20 69 6e  |ed.Useful for in|
00000130  74 65 6c 6c 69 67 65 6e  74 20 52 75 6e 20 66 69  |telligent Run fi|
00000140  6c 65 27 73 2e 20 45 2e  67 2e 20 57 68 69 6c 65  |le's. E.g. While|
00000150  20 42 6f 6f 74 69 6e 67  2c 20 70 72 65 73 73 20  | Booting, press |
00000160  27 69 27 20 74 6f 20 52  75 6e 20 49 6d 70 72 65  |'i' to Run Impre|
00000170  73 73 69 6f 6e 2c 20 27  61 27 20 66 6f 72 20 41  |ssion, 'a' for A|
00000180  72 74 77 6f 72 6b 73 20  65 74 63 2e 20 4f 72 20  |rtworks etc. Or |
00000190  62 65 66 6f 72 65 20 6c  6f 61 64 69 6e 67 20 45  |before loading E|
000001a0  64 69 74 2c 20 68 6f 6c  64 20 64 6f 77 6e 20 27  |dit, hold down '|
000001b0  46 27 20 74 6f 20 6c 6f  61 64 20 66 6c 61 73 68  |F' to load flash|
000001c0  65 72 20 61 73 20 77 65  6c 6c 2e 20 49 66 20 6e  |er as well. If n|
000001d0  6f 20 6b 65 79 20 69 73  20 70 72 65 73 73 65 64  |o key is pressed|
000001e0  2c 20 6f 6e 6c 79 20 45  64 69 74 20 69 73 20 6c  |, only Edit is l|
000001f0  6f 61 64 65 64 2e 0a 0a  55 73 69 6e 67 20 74 68  |oaded...Using th|
00000200  65 20 63 6f 6d 6d 61 6e  64 20 3a 0a 0a 54 68 65  |e command :..The|
00000210  20 63 6f 6d 6d 61 6e 64  20 68 61 73 20 6e 6f 20  | command has no |
00000220  70 61 72 61 6d 65 74 65  72 73 2c 20 6f 6e 63 65  |parameters, once|
00000230  20 69 73 73 75 65 64 20  69 74 20 73 69 6d 70 6c  | issued it simpl|
00000240  79 20 73 65 74 73 20 61  20 76 61 72 69 61 62 6c  |y sets a variabl|
00000250  65 2e 20 54 68 65 20 63  6f 6d 6d 61 6e 64 20 70  |e. The command p|
00000260  72 6f 76 69 64 65 64 20  69 73 20 3a 20 0a 0a 43  |rovided is : ..C|
00000270  68 65 63 6b 5f 4b 65 79  42 6f 61 72 64 4e 75 6d  |heck_KeyBoardNum|
00000280  62 65 72 0a 0a 57 68 65  6e 20 69 73 73 75 65 64  |ber..When issued|
00000290  20 74 68 65 20 76 61 72  69 61 62 6c 65 20 0a 0a  | the variable ..|
000002a0  4b 65 79 42 6f 61 72 64  4e 75 6d 62 65 72 0a 0a  |KeyBoardNumber..|
000002b0  69 73 20 73 65 74 20 74  6f 20 61 20 63 65 72 74  |is set to a cert|
000002c0  61 69 6e 20 6e 75 6d 62  65 72 2c 20 64 65 70 65  |ain number, depe|
000002d0  6e 64 69 6e 67 20 6f 6e  20 74 68 65 20 73 74 61  |nding on the sta|
000002e0  74 65 20 6f 66 20 74 68  65 20 6b 65 79 62 6f 61  |te of the keyboa|
000002f0  72 64 2e 0a 0a 0a 54 6f  20 67 65 74 20 74 6f 20  |rd....To get to |
00000300  67 72 69 70 73 20 77 69  74 68 20 74 68 65 20 63  |grips with the c|
00000310  6f 6d 6d 61 6e 64 20 65  61 73 6c 69 79 2c 20 72  |ommand easliy, r|
00000320  75 6e 20 74 68 65 20 66  69 6c 65 73 20 4b 65 79  |un the files Key|
00000330  4e 75 6d 31 2c 20 61 6e  64 20 4e 75 6d 2d 43 6f  |Num1, and Num-Co|
00000340  6e 2c 20 69 6e 20 74 68  65 20 44 69 72 65 63 74  |n, in the Direct|
00000350  6f 72 79 20 52 49 53 43  75 74 69 6c 73 2e 55 73  |ory RISCutils.Us|
00000360  65 72 5f 41 72 65 61 2e  44 65 6d 6f 27 73 2e 0a  |er_Area.Demo's..|
00000370  0a 54 68 65 20 63 6f 6d  6d 61 6e 64 20 63 61 6e  |.The command can|
00000380  20 62 65 20 75 73 65 64  20 61 73 20 73 6f 3a 20  | be used as so: |
00000390  28 45 2e 67 2e 20 69 6e  20 62 6f 6f 74 20 73 65  |(E.g. in boot se|
000003a0  71 75 65 6e 63 65 73 29  0a 0a 52 75 6e 20 41 44  |quences)..Run AD|
000003b0  46 53 3a 3a 48 61 72 64  44 69 73 63 34 2e 24 2e  |FS::HardDisc4.$.|
000003c0  21 54 6f 6f 6c 73 2e 46  49 4c 45 53 2e 21 52 49  |!Tools.FILES.!RI|
000003d0  53 43 75 74 69 6c 73 20  0a 43 68 65 63 6b 5f 4b  |SCutils .Check_K|
000003e0  65 79 42 6f 61 72 64 4e  75 6d 62 65 72 0a 49 46  |eyBoardNumber.IF|
000003f0  20 6b 65 79 62 6f 61 72  64 4e 75 6d 62 65 72 3d  | keyboardNumber=|
00000400  94 2d 31 31 33 95 20 54  68 65 6e 20 52 75 6e 20  |.-113. Then Run |
00000410  41 44 46 53 3a 3a 48 61  72 64 44 69 73 63 34 2e  |ADFS::HardDisc4.|
00000420  24 2e 21 47 61 6d 65 73  2e 46 69 6c 65 73 2e 21  |$.!Games.Files.!|
00000430  53 74 61 72 33 30 30 30  0a 49 46 20 6b 65 79 62  |Star3000.IF keyb|
00000440  6f 61 72 64 4e 75 6d 62  65 72 3d 94 2d 32 34 33  |oardNumber=.-243|
00000450  95 20 54 68 65 6e 20 52  75 6e 20 41 44 46 53 3a  |. Then Run ADFS:|
00000460  3a 48 61 72 64 44 69 73  63 34 2e 24 2e 21 44 54  |:HardDisc4.$.!DT|
00000470  50 2e 50 61 63 6b 61 67  65 73 2e 21 50 75 62 6c  |P.Packages.!Publ|
00000480  69 73 68 2b 0a 0a 54 6f  20 61 63 74 69 76 61 74  |ish+..To activat|
00000490  65 20 74 68 65 20 63 6f  6d 70 6f 6e 65 6e 74 20  |e the component |
000004a0  73 69 6d 70 6c 79 20 72  75 6e 20 27 52 49 53 43  |simply run 'RISC|
000004b0  75 74 69 6c 73 27 2c 20  77 69 74 68 20 74 68 65  |utils', with the|
000004c0  20 27 43 68 65 63 6b 5f  4b 65 79 62 6f 61 72 64  | 'Check_Keyboard|
000004d0  4e 75 6d 62 65 72 27 20  6f 70 74 69 6f 6e 20 69  |Number' option i|
000004e0  6e 20 52 49 53 43 75 74  69 6c 27 73 20 21 52 75  |n RISCutil's !Ru|
000004f0  6e 20 66 69 6c 65 20 73  65 74 20 74 6f 20 27 59  |n file set to 'Y|
00000500  27 2e 20 54 6f 20 64 65  2d 61 63 74 69 76 61 74  |'. To de-activat|
00000510  65 20 69 74 20 72 75 6e  20 74 68 65 20 66 69 6c  |e it run the fil|
00000520  65 20 52 49 53 43 75 74  69 6c 73 2e 55 73 65 72  |e RISCutils.User|
00000530  5f 41 72 65 61 2e 46 69  6c 65 73 2e 52 65 6d 6f  |_Area.Files.Remo|
00000540  76 65 2c 20 61 6e 64 20  72 75 6e 20 27 52 49 53  |ve, and run 'RIS|
00000550  43 75 74 69 6c 73 27 2c  20 77 69 74 68 20 74 68  |Cutils', with th|
00000560  65 20 27 43 68 65 63 6b  5f 4b 65 79 62 6f 61 72  |e 'Check_Keyboar|
00000570  64 4e 75 6d 62 65 72 27  20 6f 70 74 69 6f 6e 20  |dNumber' option |
00000580  73 65 74 20 74 6f 20 27  4e 2e 27 0a 0a           |set to 'N.'..|
0000058d