MAPSCRN(8)		    International Support		   MAPSCRN(8)



NAME
       mapscrn - load screen output mapping table

SYNOPSIS
       mapscrn [-v] [-o map.orig] mapfile

DESCRIPTION
       The  mapscrn  command  is obsolete - its function is now built-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 ta-
       ble into the console driver. The console driver may be later put	 into
       use  user-defined  mapping  table  mode by outputting a special escape
       sequence to the console device.	This sequence is (K for  the  G0
       character  set  and  )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:	direct-to-font	tables,	 that
       give  a	font  position	for each user byte value, and user-to-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  one-to-one direct-to-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 8859-2
       sets  up	 a  user-to-unicode table that assumes that the user uses ISO
       8859-2.

INPUT FORMAT
       The mapscrn command can read the map in either of two formats:
       1. 256 or 512 bytes binary data
       2. two-column text file
       Format (1) is a direct image of the translation table.  The  256-bytes
       tables  are  direct-to-font,  the 512-bytes tables are user-to-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 men-
       tioned 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 user-to-unicode table, otherwise it is a direct-to-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. UTF-8 Character:  Single  (possibly  multi-byte)  UTF-8  character,
       enclosed in single quotes.

       Note  that  control  characters	(with codes < 32) cannot be re-mapped
       with mapscrn because they have special meaning for the driver.

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

SEE ALSO
       setfont(8)

AUTHOR
       Copyright (C) 1993 Eugene G. Crosser
       
       This software and documentation may be distributed freely.



Local				20 March 1993			   MAPSCRN(8)

UNIX/Linux commands referenced on this page:

1. as
2. column
3. file