VGAFONT(1)                   BSD Reference Manual                   VGAFONT(1)

NAME
     vgafont - load EGA/VGA fonts

SYNOPSIS
     vgafont [fontname]

DESCRIPTION
     Vgafont is used to load and restore text-mode fonts on EGA/VGA display
     adapters.  By default vgafont loads a VGA font named default; this may be
     overridden with the environment variable VGAFONT.

     If fontname does not contain a ``/'' character, vgafont will look for the
     font file relative to the directory /usr/share/vgafont; otherwise it will
     treat fontname as a pathname.

     The font file should contain character bitmap lines of the form:

           <char-code>: <line1> <line2> ... <lineN>

     where char-code is the hexadecimal code of a character, and line1, line2
     and so on are hexadecimal bitmaps for the character scan lines.  The
     least significant bit corresponds to the left side, and scan lines are
     listed from top to bottom.  The file may contain comments.  Comments
     start with a ``#'' character and run to the end of the line.  Blank lines
     or lines containing only a comment are ignored.

     The default VGA character cell size is 8 columns by 16 lines; dots in the
     8th column can be duplicated in the 9th column by hardware.  EGA and
     CGA/MDA cell sizes are 8x14 and 8x8 correspondingly.  If a character def-
     inition string contains fewer line octets than are used by the video
     adapter, the lower part of the cell will be loaded with zeroes.  Extra
     line octets are ignored.

ENVIRONMENT
     If the following environment variable exists, it is utilized by vgafont.

     VGAFONT     Contains the name of a font which will be used instead of
                 default.

FILES
     /usr/share/vgafont  directory for the font files
     /dev/vga            VGA device file

SEE ALSO
     pccons(4),  environ(7)

HISTORY
     The vgafont command is currently under development.

BSDI BSD/386                    March 27, 1993                               1