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 [-Bbv] [-e encoding] [-f wsdev] [-h height] [-N name] [-w width] [fontfile] wsfontload -l
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: -B Specifies that the font data is ordered right-to-left byte wise. The default is left-to-right. -b Specifies that the font data is ordered right-to-left bit wise. The default is left-to-right. -e encoding Sets the encoding of the font. This can be either a symbolic name or a numeric value. Currently recognized names are: `iso' ISO-8859-1 encoding `ibm' IBM CP437 encoding `pcvt' the custom encoding of the supplemental fonts which came with the BSD ``pcvt'' con- sole driver `iso2' ISO-8859-2 (Eastern European) encoding `iso7' ISO-8859-7 (Greek) encoding `koi8r' KOI8-R (Russian) encoding Per default, `iso' is assumed. -f wsdev Specify the device to operate on. Default is /dev/wsfont. -h height Sets the height of a font character in pixels. Default is 16. -l Print a list of fonts that have been loaded or are built-in to the kernel. -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. -v Prints the font's properties before loading it. -w width Sets the width of a font character in pixels. Default is 8. wsfontload supports `.wsf' file format that contains the necessary infor- mation about the font in the font file itself. Such files can be loaded without specifying any arguments, though -N can be used to override the font name. Typically, the wsfontload utility will be executed during system startup by the rc(8) script. See wscons.conf(5).
FILES
/usr/share/wscons/fonts
EXAMPLES
Load ISO-encoded 20-pixel high Terminus font and use it on the current console # wsfontload /usr/share/wscons/fonts/ter-120n.wsf # wsfontload -l | grep Terminus Terminus20-ISO8859-1 10x20 # wsconsctl -f `tty` -dw font=Terminus20-ISO8859-1 Load the ISO-encoded 1632 Spleen font and switch the first console screen to use it: # wsfontload -w 16 -h 32 -e iso -N spleen32 \ /usr/share/wscons/fonts/spleen-16x32.fnt # wsconsctl -dw font=spleen32 Load the IBM-encoded 88-font from the wscons(4) distribution: # wsfontload -N myname -h 8 -e ibm \ /usr/share/wscons/fonts/vt220l.808 This or another 88-font is necessary to use the 50-line screen type on vga(4) displays.
SEE ALSO
wscons(4), wsfont(4), wscons.conf(5), wsconsctl(8)
HISTORY
Support for `.wsf' font files appeared in NetBSD 10.0.
BUGS
Many features are missing. The `.wsf' file format is undocumented. There is no way to remove a loaded font. NetBSD 9.99 June 9, 2022 NetBSD 9.99
Powered by man-cgi (2021-06-01). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.