OSBYTE &47

OSBYTE &47 (71) - Set alphabet or keyboard

On entry: X=&00+n - set or read alphabet (font)
          X=&80+n - set or read keyboard
                n=&00     : set to default
                n=&7F     : read current setting
                n=1-99    : Countries
                n=100-126 : Alphabets

On exit,  X=0   - specified alphabet/keyboard not supported
          X<&80 - previous alphabet/keyboard
          X>&7F - OSBYTE call not supported

While OSBYTE &46 sets both the keyboard and alphabet (font) in one action, this call allows each to be set individually.

Selecting an alphabet redefines the font with VDU 23 sequences. The alphabet can be specified with a country number 0-99, the appropriate alphabet for that country is then selected. Or the alphabet can be selected with the specific alphabet number 100-126. Selecting the default alphabet with X=&00 selects the appropriate alphabet for the currently selected country set with OSBYTE &46.

The keyboard can only be selected by specifying a country number, selecting a keyboard with an alphabet makes no sense. Selecting the default keyboard with X=&80 selects the appropriate keyboard for the currently selected country set with OSBYTE &46.

On 8-bit systems the keyboard number is stored in the OSBYTE &AD variable, on 32-bit systems it is stored in a non-OSBYTE variable.

• *COUNTRY parses the parameter and calls OSBYTE &46,n
• *ALPHABET parses the parameter and calls OSBYTE &47,&00+n
• *KEYBOARD parses the parameter and calls OSBYTE &47,&80+n

Country numbers

   1 UK             11 Sweden        21 Arabic        31 Belgium       48 USA
   2 Master or BBC  12 Finland       22 Ireland       32 Japan         49 Wales2
   3 Compact        13 Unused        23 HongKong      33 MiddleEast    50 China
   4 Italy          14 Denmark       24 Russia1       34 Netherlands   51 Brazil
   5 Spain          15 Norway        25 Russia2       35 Switzerland   52 SAfrica
   6 France         16 Iceland       26 Israel        36 Wales         53 Korea
   7 Germany        17 Canada1       27 Mexico        37 Maori         54 Taiwan
   8 Portugal       18 Canada2       28 LatinAm     
   9 Esperanto      19 Canada        29 Australia   
  10 Greece         20 Turkey        30 Austria     
  
  When selecting a keyboard:
 125 A4 internal or PC keyboard
 126 Archimedes keyboard

Alphabet numbers

 100 BFont      105 Cyrillic   110 Welsh      115 Latin8
 101 Latin1     106 Arabic     111 UTF8       116 Latin10
 102 Latin2     107 Greek      112 Latin9  
 103 Latin3     108 Hebrew     113 Latin6  
 104 Latin4     109 Latin5     114 Latin7  

Implementation

Implemented in the Master Internationalisation ROM, RISC OS kernel and keyboard handlers, and 8-bit keyboard extensions.

See Also

• OSBYTE &46 - Set country (both keyboard and alphabet)
• OSBYTE &AC - Read/write keyboard handler setting
• OSBYTE &AD - Read/write keyboard handler setting
• OSBYTE &F0 - Read/write country code
• http://mdfs.net/Docs/Comp/BBC/Osbyte00
• http://mdfs.net/System/ROMs/AcornMOS/Compact511

WikiSysop (talk) 13:32, 8 March 2015 (UTC) Jgharston (talk) 23:32, 18 October 2020 (CEST)