May 4, 2003

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

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