|
Packit Service |
50ad14 |
.\" @(#)man/man8/mapscrn.8 1.0 3/19/93 17:04:00
|
|
Packit Service |
50ad14 |
.TH MAPSCRN 8 "20 March 1993" "Local" "International Support"
|
|
Packit Service |
50ad14 |
.SH NAME
|
|
Packit Service |
50ad14 |
mapscrn \- load screen output mapping table
|
|
Packit Service |
50ad14 |
.SH SYNOPSIS
|
|
Packit Service |
50ad14 |
.BR mapscrn " [" -V "] [" -v "] [" -o
|
|
Packit Service |
50ad14 |
.IR map.orig ]
|
|
Packit Service |
50ad14 |
.I mapfile
|
|
Packit Service |
50ad14 |
.SH DESCRIPTION
|
|
Packit Service |
50ad14 |
The
|
|
Packit Service |
50ad14 |
.B mapscrn
|
|
Packit Service |
50ad14 |
command is obsolete - its function is now built-in into setfont.
|
|
Packit Service |
50ad14 |
However, for backwards compatibility it is still available
|
|
Packit Service |
50ad14 |
as a separate command.
|
|
Packit Service |
50ad14 |
.LP
|
|
Packit Service |
50ad14 |
The
|
|
Packit Service |
50ad14 |
.I mapscrn
|
|
Packit Service |
50ad14 |
command loads a user defined output character mapping table into the
|
|
Packit Service |
50ad14 |
console driver. The console driver may be later put into
|
|
Packit Service |
50ad14 |
.B use user-defined mapping table
|
|
Packit Service |
50ad14 |
mode by outputting a special escape sequence to the console device.
|
|
Packit Service |
50ad14 |
This sequence is
|
|
Packit Service |
50ad14 |
.I <esc>(K
|
|
Packit Service |
50ad14 |
for the
|
|
Packit Service |
50ad14 |
.B G0
|
|
Packit Service |
50ad14 |
character set and
|
|
Packit Service |
50ad14 |
.I <esc>)K
|
|
Packit Service |
50ad14 |
for the
|
|
Packit Service |
50ad14 |
.B G1
|
|
Packit Service |
50ad14 |
character set.
|
|
Packit Service |
50ad14 |
When the
|
|
Packit Service |
50ad14 |
.I -o
|
|
Packit Service |
50ad14 |
option is given, the old map is saved in
|
|
Packit Service |
50ad14 |
.I map.orig.
|
|
Packit Service |
50ad14 |
.SH USE
|
|
Packit Service |
50ad14 |
There are two kinds of mapping tables: direct-to-font tables,
|
|
Packit Service |
50ad14 |
that give a font position for each user byte value, and user-to-unicode
|
|
Packit Service |
50ad14 |
tables that give a unicode value for each user byte. The corresponding
|
|
Packit Service |
50ad14 |
glyph is now found using the unicode index of the font.
|
|
Packit Service |
50ad14 |
The command
|
|
Packit Service |
50ad14 |
.RS
|
|
Packit Service |
50ad14 |
mapscrn trivial
|
|
Packit Service |
50ad14 |
.RE
|
|
Packit Service |
50ad14 |
sets up a one-to-one direct-to-font table where user bytes
|
|
Packit Service |
50ad14 |
directly address the font. This is useful for fonts that are
|
|
Packit Service |
50ad14 |
in the same order as the character set one uses.
|
|
Packit Service |
50ad14 |
A command like
|
|
Packit Service |
50ad14 |
.RS
|
|
Packit Service |
50ad14 |
mapscrn 8859-2
|
|
Packit Service |
50ad14 |
.RE
|
|
Packit Service |
50ad14 |
sets up a user-to-unicode table that assumes that the user
|
|
Packit Service |
50ad14 |
uses ISO 8859-2.
|
|
Packit Service |
50ad14 |
.SH "INPUT FORMAT"
|
|
Packit Service |
50ad14 |
The
|
|
Packit Service |
50ad14 |
.I mapscrn
|
|
Packit Service |
50ad14 |
command can read the map in either of two formats:
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
1. 256 or 512 bytes binary data
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
2. two-column text file
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
Format (1) is a direct image of the translation
|
|
Packit Service |
50ad14 |
.I table. The 256-bytes tables are direct-to-font,
|
|
Packit Service |
50ad14 |
the 512-bytes tables are user-to-unicode tables.
|
|
Packit Service |
50ad14 |
Format (2) is used to fill the
|
|
Packit Service |
50ad14 |
.I table
|
|
Packit Service |
50ad14 |
as follows: cell with offset mentioned in the first column is filled
|
|
Packit Service |
50ad14 |
with the value mentioned in the second column.
|
|
Packit Service |
50ad14 |
When values larger than 255 occur, or values are written using
|
|
Packit Service |
50ad14 |
the U+xxxx notation, the table is assumed to be a user-to-unicode
|
|
Packit Service |
50ad14 |
table, otherwise it is a direct-to-font table.
|
|
Packit Service |
50ad14 |
.PP
|
|
Packit Service |
50ad14 |
Values in the file may be specified in one of several
|
|
Packit Service |
50ad14 |
.B formats:
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
.B 1. Decimal:
|
|
Packit Service |
50ad14 |
String of decimal digits not starting with '0'
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
.B 2. Octal:
|
|
Packit Service |
50ad14 |
String of octal digits beginning with '0'.
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
.B 3. Hexadecimal:
|
|
Packit Service |
50ad14 |
String of hexadecimal digits preceded by "0x".
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
.B 4. Unicode:
|
|
Packit Service |
50ad14 |
String of four hexadecimal digits preceded by "U+".
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
.B 5. Character:
|
|
Packit Service |
50ad14 |
Single character enclosed in single quotes. (And the binary value is used.)
|
|
Packit Service |
50ad14 |
Note that blank, comma, tab character and '#' cannot be specified
|
|
Packit Service |
50ad14 |
with this format.
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
.B 6. UTF-8 Character:
|
|
Packit Service |
50ad14 |
Single (possibly multi-byte) UTF-8 character, enclosed in single quotes.
|
|
Packit Service |
50ad14 |
.PP
|
|
Packit Service |
50ad14 |
Note that control characters (with codes < 32) cannot be re-mapped with
|
|
Packit Service |
50ad14 |
.I mapscrn
|
|
Packit Service |
50ad14 |
because they have special meaning for the driver.
|
|
Packit Service |
50ad14 |
.SH OTHER OPTIONS
|
|
Packit Service |
50ad14 |
.TP
|
|
Packit Service |
50ad14 |
.B \-V
|
|
Packit Service |
50ad14 |
Prints version number and exits.
|
|
Packit Service |
50ad14 |
.TP
|
|
Packit Service |
50ad14 |
.B \-v
|
|
Packit Service |
50ad14 |
Be verbose.
|
|
Packit Service |
50ad14 |
.SH FILES
|
|
Packit Service |
50ad14 |
.I @DATADIR@/consoletrans
|
|
Packit Service |
50ad14 |
is the default directory for screen mappings.
|
|
Packit Service |
50ad14 |
.SH "SEE ALSO"
|
|
Packit Service |
50ad14 |
.IR setfont (8)
|
|
Packit Service |
50ad14 |
.SH AUTHOR
|
|
Packit Service |
50ad14 |
Copyright (C) 1993 Eugene G. Crosser
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
<crosser@pccross.msk.su>
|
|
Packit Service |
50ad14 |
.br
|
|
Packit Service |
50ad14 |
This software and documentation may be distributed freely.
|