1MAPSCRN(8)                   International Support                  MAPSCRN(8)
2
3
4

NAME

6       mapscrn - load screen output mapping table
7

SYNOPSIS

9       mapscrn [-V] [-v] [-o map.orig] mapfile
10

DESCRIPTION

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
16       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

USE

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

INPUT FORMAT

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
48       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
59       Note that control characters (with codes < 32) cannot be re-mapped with
60       mapscrn because they have special meaning for the driver.
61

OTHER OPTIONS

63       -V     Prints version number and exits.
64
65       -v     Be verbose.
66

FILES

68       /lib/kbd/consoletrans is the default directory for screen mappings.
69

SEE ALSO

71       setfont(8)
72

AUTHOR

74       Copyright (C) 1993 Eugene G. Crosser
75       <crosser@pccross.msk.su>
76       This software and documentation may be distributed freely.
77
78
79
80Local                            20 March 1993                      MAPSCRN(8)
Impressum