WSFONTLOAD(8)           NetBSD System Manager's Manual           WSFONTLOAD(8)

NAME
     wsfontload -- load a font bitmap into the wsfont pool or a wscons display
     device

SYNOPSIS
     wsfontload [-f wsdev] [-w width] [-h height] [-e encoding] [-N name] [-b]
                [-B] [-v] [fontfile]

DESCRIPTION
     The wsfontload utility loads a font bitmap into the wsfont font pool (or
     a wscons device if the device driver supports this).  The font gets
     assigned a name in this process which it can be referred to by later for
     use on a display screen.  The font is loaded from the specified fontfile,
     or from standard input if fontfile is not provided.

     The options are:

     -f wsdev     Specify the device to operate on.  Default is /dev/wsfont.

     -w width     Sets the width of a font character in pixels.  Default is 8.

     -h height    Sets the height of a font character in pixels.  Default is
                  16.

     -e encoding  Sets the encoding of the font.  This can be either a sym-
                  bolic abbreviation or a numeric value.  Currently recognized
                  abbreviations are `iso' for ISO-8859-1 encoding, `ibm' for
                  IBM encoded fonts and `pcvt' for the custom encoding of the
                  supplemental fonts which came with the BSD ``pcvt'' console
                  driver.  Per default, `iso' is assumed.

     -N name      Specifies a name which can be used later to refer to the
                  font.  If none is given, the fontfile name is used to create
                  one.

     -b           Specifies that the font data is ordered right-to-left bit
                  wise.  The default is left-to-right.

     -B           Specifies that the font data is ordered right-to-left byte
                  wise.  The default is left-to-right.

     -v           Prints the font's properties before loading it.

     Typically, the wsfontload utility will be executed in system startup by
     the /etc/rc.d/wscons script, controlled by the /etc/wscons.conf configu-
     ration file.

FILES
     /etc/wscons.conf /usr/share/wscons/fonts

EXAMPLES
           wsfontload -N myname -h 8 -e ibm /usr/share/wscons/fonts/vt220l.808

     Load the IBM-encoded 8x8-font from the wscons(4) distribution. This (or
     another 8x8-font) is necessary to use the 50-line screen type on vga(4)
     displays.

           wsfontload -N orator -e ibm /usr/share/wscons/fonts/orator.816
           wsconsctl -dw font=orator

     Load the ``orator'' IBM-encoded 8x16 font and switch the first console
     screen (ttyE0, wsconsctl's default) to this alternate font.

SEE ALSO
     wscons(4), wsconscfg(8), wsconsctl(8)

BUGS
     Many features are missing.

     There is no way to remove a loaded font.

NetBSD 5.0_STABLE                 May 4, 2003                NetBSD 5.0_STABLE
