1*719a8b0dSdrochner.\" $NetBSD: wsfontload.8,v 1.4 1999/03/31 15:15:57 drochner 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 26536eedccSdrochner.Op Ar fontfile 27536eedccSdrochner.Sh DESCRIPTION 28536eedccSdrochnerThe 29536eedccSdrochner.Nm 30536eedccSdrochnerutility loads a font bitmap to a wscons device if the device driver 31536eedccSdrochnersupports this. 32536eedccSdrochnerThe font gets assigned a name in this process which it can be referred to 33536eedccSdrochnerby later for use on a display screen. 34536eedccSdrochnerThe font is loaded from the specified 35536eedccSdrochner.Ar fontfile , 36536eedccSdrochneror from 37536eedccSdrochner.Pa stdin 38536eedccSdrochnerif 39536eedccSdrochner.Ar fontfile 40536eedccSdrochneris not provided. 41536eedccSdrochner.Pp 42536eedccSdrochnerThe options are: 43536eedccSdrochner.Bl -tag -width xxxxxxxxxxx 44536eedccSdrochner.It Fl f Ar ctldev 45536eedccSdrochnerSpecify the control device of the wscons display to operate on. 46536eedccSdrochnerDefault is 47536eedccSdrochner.Pa /dev/ttyEcfg . 48536eedccSdrochner.It Fl w Ar width 49536eedccSdrochnerSets the width of a font character in pixels. Default is 8. 50536eedccSdrochner.It Fl h Ar height 51536eedccSdrochnerSets the width of a font character in pixels. Default is 16. 52536eedccSdrochner.It Fl e Ar encoding 53536eedccSdrochnerSets the encoding of the font. This can be either a symbolic abbreviation 54536eedccSdrochneror a numeric value. Currently recognized abbreviations are 55536eedccSdrochner.Dq iso 56536eedccSdrochnerfor ISO-8859-1 encoding, 57536eedccSdrochner.Dq ibm 58536eedccSdrochnerfor IBM encoded fonts and 59536eedccSdrochner.Dq pcvt 60536eedccSdrochnerfor the custom encoding of the supplemental fonts which came with 61536eedccSdrochnerthe BSD 62536eedccSdrochner.Dq pcvt 63536eedccSdrochnerconsole driver. Per default, 64536eedccSdrochner.Dq iso 65536eedccSdrochneris assumed. 66536eedccSdrochner.It Fl N Ar name 67536eedccSdrochnerSpecifies a name which can be used later to refer to the font. 68536eedccSdrochnerIn none is given, the 69536eedccSdrochner.Ar fontfile 70536eedccSdrochnername is used to create one. 71536eedccSdrochner.El 72*719a8b0dSdrochner.Pp 73*719a8b0dSdrochnerTypically, the 74*719a8b0dSdrochner.Nm 75*719a8b0dSdrochnerutility will be executed in system startup by the 76*719a8b0dSdrochner.Pa /etc/rc.wscons 77*719a8b0dSdrochnerscript, controlled by the 78*719a8b0dSdrochner.Pa /etc/wscons.conf 79*719a8b0dSdrochnerconfiguration file. 80*719a8b0dSdrochner.Pp 81*719a8b0dSdrochnerNo font files are provided with the wscons framework. The fonts installed by 82*719a8b0dSdrochner.Xr pcvt 4 83*719a8b0dSdrochnercan be used instead, as can raw font files from other operating system 84*719a8b0dSdrochnerdistributions. 85*719a8b0dSdrochner.Sh FILES 86*719a8b0dSdrochner.Pa /etc/wscons.conf 87*719a8b0dSdrochner.Sh EXAMPLES 88*719a8b0dSdrochner.Dl wsfontload -N myname -h 8 -e ibm /usr/share/pcvt/fonts/vt220l.808 89*719a8b0dSdrochner.Pp 90*719a8b0dSdrochnerLoad the IBM-encoded 8x8-font from the 91*719a8b0dSdrochner.Xr pcvt 4 92*719a8b0dSdrochnerdistribution. This (or another 8x8-font) is necessary to use the 93*719a8b0dSdrochner50-line screen type on 94*719a8b0dSdrochner.Xr vga 4 95*719a8b0dSdrochnerdisplays. 96536eedccSdrochner.Sh BUGS 97536eedccSdrochnerMany features are missing. 98*719a8b0dSdrochner.Pp 99*719a8b0dSdrochnerThere is no way ro remove a loaded font. 100536eedccSdrochner.Sh "SEE ALSO" 10174345454Saugustss.Xr wscons 4 , 10274345454Saugustss.Xr wsconscfg 8 , 10374345454Saugustss.Xr wsconsctl 8 104