| 1 |
.\" @(#)man/man8/mapscrn.8 1.0 3/19/93 17:04:00 |
| 2 |
.TH MAPSCRN 8 "24 October 2024" "kbd" |
| 3 |
.SH NAME |
| 4 |
mapscrn \- load screen output mapping table |
| 5 |
.SH SYNOPSIS |
| 6 |
.BR mapscrn |
| 7 |
[\fI\,options\/\fR] |
| 8 |
.I mapfile |
| 9 |
.SH DESCRIPTION |
| 10 |
The |
| 11 |
.B mapscrn |
| 12 |
command is obsolete - its function is now built-in into setfont. |
| 13 |
However, for backwards compatibility it is still available |
| 14 |
as a separate command. |
| 15 |
.LP |
| 16 |
The |
| 17 |
.I mapscrn |
| 18 |
command loads a user defined output character mapping table into the |
| 19 |
console driver. The console driver may be later put into |
| 20 |
.B use user-defined mapping table |
| 21 |
mode by outputting a special escape sequence to the console device. |
| 22 |
This sequence is |
| 23 |
.I <esc>(K |
| 24 |
for the |
| 25 |
.B G0 |
| 26 |
character set and |
| 27 |
.I <esc>)K |
| 28 |
for the |
| 29 |
.B G1 |
| 30 |
character set. |
| 31 |
When the |
| 32 |
.I -o |
| 33 |
option is given, the old map is saved in |
| 34 |
.I map.orig. |
| 35 |
.SH USE |
| 36 |
There are two kinds of mapping tables: direct-to-font tables, |
| 37 |
that give a font position for each user byte value, and user-to-unicode |
| 38 |
tables that give a unicode value for each user byte. The corresponding |
| 39 |
glyph is now found using the unicode index of the font. |
| 40 |
The command |
| 41 |
.RS |
| 42 |
mapscrn trivial |
| 43 |
.RE |
| 44 |
sets up a one-to-one direct-to-font table where user bytes |
| 45 |
directly address the font. This is useful for fonts that are |
| 46 |
in the same order as the character set one uses. |
| 47 |
A command like |
| 48 |
.RS |
| 49 |
mapscrn 8859-2 |
| 50 |
.RE |
| 51 |
sets up a user-to-unicode table that assumes that the user |
| 52 |
uses ISO 8859-2. |
| 53 |
.SH "INPUT FORMAT" |
| 54 |
The |
| 55 |
.I mapscrn |
| 56 |
command can read the map in either of two formats: |
| 57 |
.br |
| 58 |
1. 256 or 512 bytes binary data |
| 59 |
.br |
| 60 |
2. two-column text file |
| 61 |
.br |
| 62 |
Format (1) is a direct image of the translation |
| 63 |
.I table. The 256-bytes tables are direct-to-font, |
| 64 |
the 512-bytes tables are user-to-unicode tables. |
| 65 |
Format (2) is used to fill the |
| 66 |
.I table |
| 67 |
as follows: cell with offset mentioned in the first column is filled |
| 68 |
with the value mentioned in the second column. |
| 69 |
When values larger than 255 occur, or values are written using |
| 70 |
the U+xxxx notation, the table is assumed to be a user-to-unicode |
| 71 |
table, otherwise it is a direct-to-font table. |
| 72 |
.PP |
| 73 |
Values in the file may be specified in one of several |
| 74 |
.B formats: |
| 75 |
.br |
| 76 |
.B 1. Decimal: |
| 77 |
String of decimal digits not starting with '0' |
| 78 |
.br |
| 79 |
.B 2. Octal: |
| 80 |
String of octal digits beginning with '0'. |
| 81 |
.br |
| 82 |
.B 3. Hexadecimal: |
| 83 |
String of hexadecimal digits preceded by "0x". |
| 84 |
.br |
| 85 |
.B 4. Unicode: |
| 86 |
String of four hexadecimal digits preceded by "U+". |
| 87 |
.br |
| 88 |
.B 5. Character: |
| 89 |
Single character enclosed in single quotes. (And the binary value is used.) |
| 90 |
Note that blank, comma, tab character and '#' cannot be specified |
| 91 |
with this format. |
| 92 |
.br |
| 93 |
.B 6. UTF-8 Character: |
| 94 |
Single (possibly multi-byte) UTF-8 character, enclosed in single quotes. |
| 95 |
.PP |
| 96 |
Note that control characters (with codes < 32) cannot be re-mapped with |
| 97 |
.I mapscrn |
| 98 |
because they have special meaning for the driver. |
| 99 |
.SH OPTIONS |
| 100 |
.TP |
| 101 |
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR |
| 102 |
save the old map to the \fI\,FILE\/\fR. |
| 103 |
.TP |
| 104 |
\fB\-C\fR, \fB\-\-console\fR=\fI\,DEV\/\fR |
| 105 |
the console device to be used. |
| 106 |
.TP |
| 107 |
\fB\-v\fR, \fB\-\-verbose\fR |
| 108 |
be more verbose. |
| 109 |
.TP |
| 110 |
\fB\-V\fR, \fB\-\-version\fR |
| 111 |
print version number. |
| 112 |
.TP |
| 113 |
\fB\-h\fR, \fB\-\-help\fR |
| 114 |
print this usage message. |
| 115 |
.SH FILES |
| 116 |
.TP |
| 117 |
.I /usr/share/consoletrans |
| 118 |
The default directory for screen mappings. |
| 119 |
.LP |
| 120 |
.SH "SEE ALSO" |
| 121 |
.IR setfont (8) |
| 122 |
.SH AUTHOR |
| 123 |
Copyright (C) 1993 Eugene G. Crosser |
| 124 |
.br |
| 125 |
<[email protected]> |
| 126 |
.br |
| 127 |
This software and documentation may be distributed freely. |