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

NAME
     wsfontload - load a font bitmap into a wscons display device

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

DESCRIPTION
     The wsfontload utility loads a font bitmap to a wscons device if the de-
     vice driver supports it.  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 stdin if fontfile is
     not provided.

     The options are as follows:

     -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.

     -e encoding
             Sets the encoding of the font.  This can be either a symbolic ab-
             breviation or a numeric value.  Currently recognized abbrevia-
             tions are ``iso'' for ISO-8859-1 encoding, ``ibm'' for IBM encod-
             ed fonts, and ``pcvt'' for the custom encoding of the supplemen-
             tal fonts which came with the BSD PCVT console driver.  Per de-
             fault, ``iso'' is assumed.

     -f file
             Specify the control device of the wscons display to operate on.
             Default is /dev/ttyCcfg.

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

     -l      Specifies to print out a list of loaded fonts, no other arguments
             should be specified.

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

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

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

     No font files are provided with the wscons framework.  The fonts in-
     stalled by PCVT can be used instead, as can raw font files from other op-
     erating system distributions.

EXAMPLES
     wsfontload -N myname -h 8 -e ibm /usr/share/misc/pcvtfonts/vt220l.808

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

FILES

     /usr/share/misc/pcvtfonts/
                       fonts directory.

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

HISTORY
     The wsfontload program appeared in OpenBSD 2.8.

BUGS
     Many features are missing.

     There is no way to remove a loaded font.

OpenBSD 3.0                    January 13, 1999                              2
