1*ea46e54fSbjh21.\" $NetBSD: wsfontload.8,v 1.9 2000/10/03 14:20:52 bjh21 Exp $ 2536eedccSdrochner.\" 3536eedccSdrochner.Dd January 13, 1999 4536eedccSdrochner.Os 5536eedccSdrochner.Dt WSFONTLOAD 8 6536eedccSdrochner.Sh NAME 7536eedccSdrochner.Nm wsfontload 8536eedccSdrochner.Nd load a font bitmap into a wscons display device 9536eedccSdrochner.Sh SYNOPSIS 10d77575d3Smycroft.Nm "" 11d77575d3Smycroft.Bk -words 12d77575d3Smycroft.Op Fl f Ar ctldev 13d77575d3Smycroft.Ek 14d77575d3Smycroft.Bk -words 15d77575d3Smycroft.Op Fl w Ar width 16d77575d3Smycroft.Ek 17d77575d3Smycroft.Bk -words 18d77575d3Smycroft.Op Fl h Ar height 19d77575d3Smycroft.Ek 20d77575d3Smycroft.Bk -words 21d77575d3Smycroft.Op Fl e Ar encoding 22d77575d3Smycroft.Ek 23d77575d3Smycroft.Bk -words 24d77575d3Smycroft.Op Fl N Ar name 25d77575d3Smycroft.Ek 26a4eb8384Sad.Bk -words 27a4eb8384Sad.Op Fl b 28a4eb8384Sad.Ek 29a4eb8384Sad.Bk -words 30a4eb8384Sad.Op Fl B 31a4eb8384Sad.Ek 32536eedccSdrochner.Op Ar fontfile 33536eedccSdrochner.Sh DESCRIPTION 34536eedccSdrochnerThe 35536eedccSdrochner.Nm 36536eedccSdrochnerutility loads a font bitmap to a wscons device if the device driver 37536eedccSdrochnersupports this. 38536eedccSdrochnerThe font gets assigned a name in this process which it can be referred to 39536eedccSdrochnerby later for use on a display screen. 40536eedccSdrochnerThe font is loaded from the specified 41536eedccSdrochner.Ar fontfile , 428c073449Sbjh21or from standard input if 43536eedccSdrochner.Ar fontfile 44536eedccSdrochneris not provided. 45536eedccSdrochner.Pp 46536eedccSdrochnerThe options are: 47536eedccSdrochner.Bl -tag -width xxxxxxxxxxx 48536eedccSdrochner.It Fl f Ar ctldev 49536eedccSdrochnerSpecify the control device of the wscons display to operate on. 50536eedccSdrochnerDefault is 51536eedccSdrochner.Pa /dev/ttyEcfg . 52536eedccSdrochner.It Fl w Ar width 53536eedccSdrochnerSets the width of a font character in pixels. Default is 8. 54536eedccSdrochner.It Fl h Ar height 55536eedccSdrochnerSets the width of a font character in pixels. Default is 16. 56536eedccSdrochner.It Fl e Ar encoding 57536eedccSdrochnerSets the encoding of the font. This can be either a symbolic abbreviation 58536eedccSdrochneror a numeric value. Currently recognized abbreviations are 59*ea46e54fSbjh21.Ql iso 60536eedccSdrochnerfor ISO-8859-1 encoding, 61*ea46e54fSbjh21.Ql ibm 62536eedccSdrochnerfor IBM encoded fonts and 63*ea46e54fSbjh21.Ql pcvt 64536eedccSdrochnerfor the custom encoding of the supplemental fonts which came with 65*ea46e54fSbjh21the 66*ea46e54fSbjh21.Bx 67536eedccSdrochner.Dq pcvt 68536eedccSdrochnerconsole driver. Per default, 69*ea46e54fSbjh21.Ql iso 70536eedccSdrochneris assumed. 71536eedccSdrochner.It Fl N Ar name 72536eedccSdrochnerSpecifies a name which can be used later to refer to the font. 73536eedccSdrochnerIn none is given, the 74536eedccSdrochner.Ar fontfile 75536eedccSdrochnername is used to create one. 76a4eb8384Sad.It Fl b 77a4eb8384SadSpecifies that the font data is ordered right-to-left bit wise. The default 78a4eb8384Sadis left-to-right. 79a4eb8384Sad.It Fl B 80a4eb8384SadSpecifies that the font data is ordered right-to-left byte wise. The default 81a4eb8384Sadis left-to-right. 82536eedccSdrochner.El 83719a8b0dSdrochner.Pp 84719a8b0dSdrochnerTypically, the 85719a8b0dSdrochner.Nm 86719a8b0dSdrochnerutility will be executed in system startup by the 87ab1ba363Slukem.Pa /etc/rc.d/wscons 88719a8b0dSdrochnerscript, controlled by the 89719a8b0dSdrochner.Pa /etc/wscons.conf 90719a8b0dSdrochnerconfiguration file. 91719a8b0dSdrochner.Pp 92719a8b0dSdrochnerNo font files are provided with the wscons framework. The fonts installed by 93719a8b0dSdrochner.Xr pcvt 4 94719a8b0dSdrochnercan be used instead, as can raw font files from other operating system 95719a8b0dSdrochnerdistributions. 96719a8b0dSdrochner.Sh EXAMPLES 97719a8b0dSdrochner.Dl wsfontload -N myname -h 8 -e ibm /usr/share/pcvt/fonts/vt220l.808 98719a8b0dSdrochner.Pp 99*ea46e54fSbjh21Load the IBM-encoded 8\(mu8-font from the 100719a8b0dSdrochner.Xr pcvt 4 101*ea46e54fSbjh21distribution. This (or another 8\(mu8-font) is necessary to use the 102719a8b0dSdrochner50-line screen type on 103719a8b0dSdrochner.Xr vga 4 104719a8b0dSdrochnerdisplays. 1058c073449Sbjh21.Sh FILES 1068c073449Sbjh21.Pa /etc/wscons.conf 107b2275072Scgd.Sh SEE ALSO 10874345454Saugustss.Xr wscons 4 , 10974345454Saugustss.Xr wsconscfg 8 , 11074345454Saugustss.Xr wsconsctl 8 1118c073449Sbjh21.Sh BUGS 1128c073449Sbjh21Many features are missing. 1138c073449Sbjh21.Pp 1148c073449Sbjh21There is no way to remove a loaded font. 115