{
    "mode": "man",
    "parameter": "mapscrn",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/mapscrn/8/json",
    "generated": "2026-06-13T21:38:17Z",
    "synopsis": "mapscrn [-V] [-v] [-o map.orig] mapfile",
    "sections": {
        "NAME": {
            "content": "mapscrn - load screen output mapping table\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "mapscrn [-V] [-v] [-o map.orig] mapfile\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The  mapscrn  command  is obsolete - its function is now built-in into setfont.  However, for\nbackwards compatibility it is still available as a separate command.\n\nThe mapscrn command loads a user defined output character  mapping  table  into  the  console\ndriver.  The console driver may be later put into use user-defined mapping table mode by out‐\nputting a special escape sequence to the console device.  This sequence is <esc>(K for the G0\ncharacter set and <esc>)K for the G1 character set.  When the -o option is given, the old map\nis saved in map.orig.\n",
            "subsections": []
        },
        "USE": {
            "content": "There are two kinds of mapping tables: direct-to-font tables, that give a font  position  for\neach  user  byte  value,  and  user-to-unicode tables that give a unicode value for each user\nbyte. The corresponding glyph is now found using the unicode index of the font.  The command\nmapscrn trivial\nsets up a one-to-one direct-to-font table where user bytes directly address the font. This is\nuseful for fonts that are in the same order as the character set one uses.  A command like\nmapscrn 8859-2\nsets up a user-to-unicode table that assumes that the user uses ISO 8859-2.\n",
            "subsections": []
        },
        "INPUT FORMAT": {
            "content": "The mapscrn command can read the map in either of two formats:\n1. 256 or 512 bytes binary data\n2. two-column text file\nFormat  (1)  is  a direct image of the translation table. The 256-bytes tables are direct-to-\nfont, the 512-bytes tables are user-to-unicode tables.  Format (2) is used to fill the  table\nas follows: cell with offset mentioned in the first column is filled with the value mentioned\nin the second column.  When values larger than 255 occur, or values  are  written  using  the\nU+xxxx  notation,  the  table is assumed to be a user-to-unicode table, otherwise it is a di‐\nrect-to-font table.\n\nValues in the file may be specified in one of several formats:\n1. Decimal: String of decimal digits not starting with '0'\n2. Octal: String of octal digits beginning with '0'.\n3. Hexadecimal: String of hexadecimal digits preceded by \"0x\".\n4. Unicode: String of four hexadecimal digits preceded by \"U+\".\n5. Character: Single character enclosed in single quotes. (And the  binary  value  is  used.)\nNote that blank, comma, tab character and '#' cannot be specified with this format.\n6. UTF-8 Character: Single (possibly multi-byte) UTF-8 character, enclosed in single quotes.\n\nNote  that control characters (with codes < 32) cannot be re-mapped with mapscrn because they\nhave special meaning for the driver.\n",
            "subsections": []
        },
        "OTHER OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-V",
                    "content": "",
                    "flag": "-V"
                },
                {
                    "name": "-v",
                    "content": "",
                    "flag": "-v"
                }
            ]
        },
        "FILES": {
            "content": "/usr/share/consoletrans\nThe default directory for screen mappings.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "setfont(8)\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Copyright (C) 1993 Eugene G. Crosser\n<crosser@pccross.msk.su>\nThis software and documentation may be distributed freely.\n\n\n\nkbd                                         20 March 1993                                 MAPSCRN(8)",
            "subsections": []
        }
    },
    "summary": "mapscrn - load screen output mapping table",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "setfont",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/setfont/8/json"
        }
    ]
}