1.\" $NetBSD: wsfontload.8,v 1.18 2002/04/06 03:17:47 dsainty Exp $ 2.\" 3.Dd November 8, 2000 4.Os 5.Dt WSFONTLOAD 8 6.Sh NAME 7.Nm wsfontload 8.Nd "load a font bitmap into the wsfont pool or a wscons display device" 9.Sh SYNOPSIS 10.Nm "" 11.Bk -words 12.Op Fl f Ar wsdev 13.Ek 14.Bk -words 15.Op Fl w Ar width 16.Ek 17.Bk -words 18.Op Fl h Ar height 19.Ek 20.Bk -words 21.Op Fl e Ar encoding 22.Ek 23.Bk -words 24.Op Fl N Ar name 25.Ek 26.Bk -words 27.Op Fl b 28.Ek 29.Bk -words 30.Op Fl B 31.Ek 32.Bk -words 33.Op Fl v 34.Ek 35.Op Ar fontfile 36.Sh DESCRIPTION 37The 38.Nm 39utility loads a font bitmap into the wsfont font pool 40(or a wscons device if the device driver supports this). 41The font gets assigned a name in this process which it can be referred to 42by later for use on a display screen. 43The font is loaded from the specified 44.Ar fontfile , 45or from standard input if 46.Ar fontfile 47is not provided. 48.Pp 49The options are: 50.Bl -tag -width xxxxxxxxxxx 51.It Fl f Ar wsdev 52Specify the device to operate on. 53Default is 54.Pa /dev/wsfont . 55.It Fl w Ar width 56Sets the width of a font character in pixels. Default is 8. 57.It Fl h Ar height 58Sets the height of a font character in pixels. Default is 16. 59.It Fl e Ar encoding 60Sets the encoding of the font. This can be either a symbolic abbreviation 61or a numeric value. Currently recognized abbreviations are 62.Ql iso 63for ISO-8859-1 encoding, 64.Ql ibm 65for IBM encoded fonts and 66.Ql pcvt 67for the custom encoding of the supplemental fonts which came with 68the 69.Bx 70.Dq pcvt 71console driver. Per default, 72.Ql iso 73is assumed. 74.It Fl N Ar name 75Specifies a name which can be used later to refer to the font. 76If none is given, the 77.Ar fontfile 78name is used to create one. 79.It Fl b 80Specifies that the font data is ordered right-to-left bit wise. The default 81is left-to-right. 82.It Fl B 83Specifies that the font data is ordered right-to-left byte wise. The default 84is left-to-right. 85.It Fl v 86Prints the font's properties before loading it. 87.El 88.Pp 89Typically, the 90.Nm 91utility will be executed in system startup by the 92.Pa /etc/rc.d/wscons 93script, controlled by the 94.Pa /etc/wscons.conf 95configuration file. 96.Sh FILES 97.Pa /etc/wscons.conf 98.Pa /usr/share/wscons/fonts 99.Sh EXAMPLES 100.Dl wsfontload -N myname -h 8 -e ibm /usr/share/wscons/fonts/vt220l.808 101.Pp 102Load the IBM-encoded 8\(mu8-font from the 103.Xr wscons 4 104distribution. This (or another 8\(mu8-font) is necessary to use the 10550-line screen type on 106.Xr vga 4 107displays. 108.Sh SEE ALSO 109.Xr wscons 4 , 110.Xr wsconscfg 8 , 111.Xr wsconsctl 8 112.Sh BUGS 113Many features are missing. 114.Pp 115There is no way to remove a loaded font. 116