1MAPSCRN(8) International Support MAPSCRN(8)
2
6 mapscrn - load screen output mapping table
7
9 mapscrn [-v] [-o map.orig] mapfile
10
12 The mapscrn command is obsolete - its function is now built-in into
13 setfont. However, for backwards compatibility it is still available as
14 a separate command.
15 The mapscrn command loads a user defined output character mapping table
17 into the console driver. The console driver may be later put into use
18 user-defined mapping table mode by outputting a special escape sequence
19 to the console device. This sequence is <esc>(K for the G0 character
20 set and <esc>)K for the G1 character set. When the -o option is given,
21 the old map is saved in map.orig.
22
24 There are two kinds of mapping tables: direct-to-font tables, that give
25 a font position for each user byte value, and user-to-unicode tables
26 that give a unicode value for each user byte. The corresponding glyph
27 is now found using the unicode index of the font. The command
28 mapscrn trivial
29 sets up a one-to-one direct-to-font table where user bytes directly
30 address the font. This is useful for fonts that are in the same order
31 as the character set one uses. A command like
32 mapscrn 8859-2
33 sets up a user-to-unicode table that assumes that the user uses ISO
34 8859-2.
35
37 The mapscrn command can read the map in either of two formats:
38 1. 256 or 512 bytes binary data
39 2. two-column text file
40 Format (1) is a direct image of the translation table. The 256-bytes
41 tables are direct-to-font, the 512-bytes tables are user-to-unicode
42 tables. Format (2) is used to fill the table as follows: cell with
43 offset mentioned in the first column is filled with the value mentioned
44 in the second column. When values larger than 255 occur, or values are
45 written using the U+xxxx notation, the table is assumed to be a user-
46 to-unicode table, otherwise it is a direct-to-font table.
47 Values in the file may be specified in one of several formats:
49 1. Decimal: String of decimal digits not starting with '0'
50 2. Octal: String of octal digits beginning with '0'.
51 3. Hexadecimal: String of hexadecimal digits preceded by "0x".
52 4. Unicode: String of four hexadecimal digits preceded by "U+".
53 5. Character: Single character enclosed in single quotes. (And the
54 binary value is used.) Note that blank, comma, tab character and '#'
55 cannot be specified with this format.
56 6. UTF-8 Character: Single (possibly multi-byte) UTF-8 character,
57 enclosed in single quotes.
58 Note that control characters (with codes < 32) cannot be re-mapped with
60 mapscrn because they have special meaning for the driver.
61
63 /lib/kbd/consoletrans is the default directory for screen mappings.
64
66 setfont(8)
67
69 Copyright (C) 1993 Eugene G. Crosser
70 <crosser@pccross.msk.su>
71 This software and documentation may be distributed freely.
72Local 20 March 1993 MAPSCRN(8)