NAME    [Toc]    [Back]

     wsfontload - load a font bitmap into a wscons display device

SYNOPSIS    [Toc]    [Back]

     wsfontload  [-Bbl]  [-e  encoding] [-f file] [-h height] [-N
name]
                [-w width] [fontfile]

DESCRIPTION    [Toc]    [Back]

     The wsfontload utility loads a font bitmap to a  wscons  device if the device
  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-toleft byte wise.
             The default is left-to-right.

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

     -e encoding
             Sets the encoding of the font.  This can be either a
symbolic 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.

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

     No  font  files are provided with the wscons framework.  The
fonts installed
 by PCVT can be used instead, as can raw  font  files
from other operating
 system distributions.

FILES    [Toc]    [Back]

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

EXAMPLES    [Toc]    [Back]

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

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

SEE ALSO    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

     The wsfontload program appeared in OpenBSD 2.8.

BUGS    [Toc]    [Back]

     Many features are missing.

     There is no way to remove a loaded font.

OpenBSD     3.6                        January      13,      1999