1*b2275072Scgd.\" $NetBSD: wsfontload.8,v 1.5 1999/04/06 04:54:22 cgd 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 72719a8b0dSdrochner.Pp 73719a8b0dSdrochnerTypically, the 74719a8b0dSdrochner.Nm 75719a8b0dSdrochnerutility will be executed in system startup by the 76719a8b0dSdrochner.Pa /etc/rc.wscons 77719a8b0dSdrochnerscript, controlled by the 78719a8b0dSdrochner.Pa /etc/wscons.conf 79719a8b0dSdrochnerconfiguration file. 80719a8b0dSdrochner.Pp 81719a8b0dSdrochnerNo font files are provided with the wscons framework. The fonts installed by 82719a8b0dSdrochner.Xr pcvt 4 83719a8b0dSdrochnercan be used instead, as can raw font files from other operating system 84719a8b0dSdrochnerdistributions. 85719a8b0dSdrochner.Sh FILES 86719a8b0dSdrochner.Pa /etc/wscons.conf 87719a8b0dSdrochner.Sh EXAMPLES 88719a8b0dSdrochner.Dl wsfontload -N myname -h 8 -e ibm /usr/share/pcvt/fonts/vt220l.808 89719a8b0dSdrochner.Pp 90719a8b0dSdrochnerLoad the IBM-encoded 8x8-font from the 91719a8b0dSdrochner.Xr pcvt 4 92719a8b0dSdrochnerdistribution. This (or another 8x8-font) is necessary to use the 93719a8b0dSdrochner50-line screen type on 94719a8b0dSdrochner.Xr vga 4 95719a8b0dSdrochnerdisplays. 96536eedccSdrochner.Sh BUGS 97536eedccSdrochnerMany features are missing. 98719a8b0dSdrochner.Pp 99719a8b0dSdrochnerThere is no way ro remove a loaded font. 100*b2275072Scgd.Sh SEE ALSO 10174345454Saugustss.Xr wscons 4 , 10274345454Saugustss.Xr wsconscfg 8 , 10374345454Saugustss.Xr wsconsctl 8 104