MAPSCRN
Section: Maintenance Commands (8)
Updated: 24 October 2024
Index
Return to Main Contents
NAME
mapscrn - load screen output mapping table
SYNOPSIS
mapscrn
[
,options/]
mapfile
DESCRIPTION
The
mapscrn
command is obsolete- its function is now buil-in into setfont.
However, for backwards compatibility it is still available
as a separate command.
The
mapscrn
command loads a user defined output character mapping table into the
console driver. The console driver may be later put into
use use-defined mapping table
mode by outputting a special escape sequence to the console device.
This sequence is
<esc>(K
for the
G0
character set and
<esc>)K
for the
G1
character set.
When the
-o
option is given, the old map is saved in
map.orig.
USE
There are two kinds of mapping tables: direc-t-font tables,
that give a font position for each user byte value, and use-t-unicode
tables that give a unicode value for each user byte. The corresponding
glyph is now found using the unicode index of the font.
The command
-
mapscrn trivial
sets up a on-t-one direc-t-font table where user bytes
directly address the font. This is useful for fonts that are
in the same order as the character set one uses.
A command like
-
mapscrn 885-2
sets up a use-t-unicode table that assumes that the user
uses ISO 885-2.
INPUT FORMAT
The
mapscrn
command can read the map in either of two formats:
1. 256 or 512 bytes binary data
2. tw-column text file
Format (1) is a direct image of the translation
table. The 25-bytes tables are direc-t-font,
the 51-bytes tables are use-t-unicode tables.
Format (2) is used to fill the
table
as follows: cell with offset mentioned in the first column is filled
with the value mentioned in the second column.
When values larger than 255 occur, or values are written using
the U+xxxx notation, the table is assumed to be a use-t-unicode
table, otherwise it is a direc-t-font table.
Values in the file may be specified in one of several
formats:
1. Decimal:
String of decimal digits not starting with '0'
2. Octal:
String of octal digits beginning with '0'.
3. Hexadecimal:
String of hexadecimal digits preceded by "0x".
4. Unicode:
String of four hexadecimal digits preceded by "U+".
5. Character:
Single character enclosed in single quotes. (And the binary value is used.)
Note that blank, comma, tab character and '#' cannot be specified
with this format.
6. UT-8 Character:
Single (possibly mult-byte) UT-8 character, enclosed in single quotes.
Note that control characters (with codes < 32) cannot be r-mapped with
mapscrn
because they have special meaning for the driver.
OPTIONS
- -o, --output=,FILE/
-
save the old map to the ,FILE/.
- -C, --console=,DEV/
-
the console device to be used.
- -v, --verbose
-
be more verbose.
- -V, --version
-
print version number.
- -h, --help
-
print this usage message.
FILES
- /usr/share/consoletrans
-
The default directory for screen mappings.
SEE ALSO
setfont(8)
AUTHOR
Copyright (C) 1993 Eugene G. Crosser
<
crosser@pccross.msk.su>
This software and documentation may be distributed freely.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- USE
-
- INPUT FORMAT
-
- OPTIONS
-
- FILES
-
- SEE ALSO
-
- AUTHOR
-