wsfontload(8) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
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 8×8-font from the wscons(4) distribution. This (or
     another 8×8-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 8×16 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.2                        May 4, 2003                       NetBSD 5.2