.Dd November 8, 2000 .Os .Dt WSFONTLOAD 8 .Sh NAME .Nm wsfontload .Nd load a font bitmap into the wsfont pool or a wscons display device .Sh SYNOPSIS .Nm "" k -words .Op Fl f Ar wsdev .Ek k -words .Op Fl w Ar width .Ek k -words .Op Fl h Ar height .Ek k -words .Op Fl e Ar encoding .Ek k -words .Op Fl N Ar name .Ek k -words .Op Fl b .Ek k -words .Op Fl B .Ek k -words .Op Fl v .Ek .Op Ar fontfile .Sh DESCRIPTION The .Nm 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 .Ar fontfile , or from standard input if .Ar fontfile is not provided.
p The options are: l -tag -width xxxxxxxxxxx t Fl f Ar wsdev Specify the device to operate on. Default is
a /dev/wsfont . t Fl w Ar width Sets the width of a font character in pixels. Default is 8. t Fl h Ar height Sets the height of a font character in pixels. Default is 16. t Fl e Ar encoding Sets the encoding of the font. This can be either a symbolic abbreviation or a numeric value. Currently recognized abbreviations are .Ql iso for ISO-8859-1 encoding, .Ql ibm for IBM encoded fonts and .Ql pcvt for the custom encoding of the supplemental fonts which came with the x .Dq pcvt console driver. Per default, .Ql iso is assumed. t Fl N Ar name Specifies a name which can be used later to refer to the font. In none is given, the .Ar fontfile name is used to create one. t Fl b Specifies that the font data is ordered right-to-left bit wise. The default is left-to-right. t Fl B Specifies that the font data is ordered right-to-left byte wise. The default is left-to-right. t Fl v Prints the font's properties before loading it. .El
p Typically, the .Nm utility will be executed in system startup by the
a /etc/rc.d/wscons script, controlled by the
a /etc/wscons.conf configuration file. .Sh EXAMPLES .Dl wsfontload -N myname -h 8 -e ibm /usr/share/wscons/fonts/vt220l.808
p Load the IBM-encoded 8\(mu8-font from the .Xr wscons 4 distribution. This (or another 8\(mu8-font) is necessary to use the 50-line screen type on .Xr vga 4 displays. .Sh FILES
a /etc/wscons.conf
a /usr/share/wscons/fonts .Sh SEE ALSO .Xr wscons 4 , .Xr wsconscfg 8 , .Xr wsconsctl 8 .Sh BUGS Many features are missing.
p There is no way to remove a loaded font.