1*7bdc4b94Swiz.\" $NetBSD: wsfontload.8,v 1.26 2011/06/08 12:47:51 wiz Exp $ 22b294580Sdrochner.\" 32b294580Sdrochner.\" Copyright (c) 1999, 2001 42b294580Sdrochner.\" Matthias Drochner. All rights reserved. 52b294580Sdrochner.\" 62b294580Sdrochner.\" Redistribution and use in source and binary forms, with or without 72b294580Sdrochner.\" modification, are permitted provided that the following conditions 82b294580Sdrochner.\" are met: 92b294580Sdrochner.\" 1. Redistributions of source code must retain the above copyright 102b294580Sdrochner.\" notice, this list of conditions and the following disclaimer. 112b294580Sdrochner.\" 2. Redistributions in binary form must reproduce the above copyright 122b294580Sdrochner.\" notice, this list of conditions and the following disclaimer in the 132b294580Sdrochner.\" documentation and/or other materials provided with the distribution. 142b294580Sdrochner.\" 152b294580Sdrochner.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 162b294580Sdrochner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 172b294580Sdrochner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 182b294580Sdrochner.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 192b294580Sdrochner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 202b294580Sdrochner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 212b294580Sdrochner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 222b294580Sdrochner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 232b294580Sdrochner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 242b294580Sdrochner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 252b294580Sdrochner.\" SUCH DAMAGE. 26536eedccSdrochner.\" 278dc7b32aSwiz.Dd May 4, 2003 28536eedccSdrochner.Dt WSFONTLOAD 8 29997634feSjoerg.Os 30536eedccSdrochner.Sh NAME 31536eedccSdrochner.Nm wsfontload 32574575c5Swiz.Nd "load a font bitmap into the wsfont pool or a wscons display device" 33536eedccSdrochner.Sh SYNOPSIS 34990562bfSwiz.Nm 35*7bdc4b94Swiz.Op Fl Bbv 36d77575d3Smycroft.Op Fl e Ar encoding 37*7bdc4b94Swiz.Op Fl f Ar wsdev 38*7bdc4b94Swiz.Op Fl h Ar height 39d77575d3Smycroft.Op Fl N Ar name 40*7bdc4b94Swiz.Op Fl w Ar width 41536eedccSdrochner.Op Ar fontfile 42536eedccSdrochner.Sh DESCRIPTION 43536eedccSdrochnerThe 44536eedccSdrochner.Nm 45371be6adSdrochnerutility loads a font bitmap into the wsfont font pool 46371be6adSdrochner(or a wscons device if the device driver supports this). 47536eedccSdrochnerThe font gets assigned a name in this process which it can be referred to 48536eedccSdrochnerby later for use on a display screen. 49536eedccSdrochnerThe font is loaded from the specified 50536eedccSdrochner.Ar fontfile , 518c073449Sbjh21or from standard input if 52536eedccSdrochner.Ar fontfile 53536eedccSdrochneris not provided. 54536eedccSdrochner.Pp 55536eedccSdrochnerThe options are: 56536eedccSdrochner.Bl -tag -width xxxxxxxxxxx 57*7bdc4b94Swiz.It Fl B 58*7bdc4b94SwizSpecifies that the font data is ordered right-to-left byte wise. 59*7bdc4b94SwizThe default is left-to-right. 60*7bdc4b94Swiz.It Fl b 61*7bdc4b94SwizSpecifies that the font data is ordered right-to-left bit wise. 62*7bdc4b94SwizThe default is left-to-right. 63536eedccSdrochner.It Fl e Ar encoding 64662e5768SgmcgarrySets the encoding of the font. 65662e5768SgmcgarryThis can be either a symbolic abbreviation or a numeric value. 66e4daf4deSdrochnerCurrently recognized abbreviations are: 67e4daf4deSdrochner.Bl -tag -width xxxxxxx 68e4daf4deSdrochner.It Ql iso 69e4daf4deSdrochnerISO-8859-1 encoding 70e4daf4deSdrochner.It Ql ibm 71e4daf4deSdrochnerIBM encoded fonts 72e4daf4deSdrochner.It Ql pcvt 73e4daf4deSdrochnerthe custom encoding of the supplemental fonts which came with the 74ea46e54fSbjh21.Bx 75536eedccSdrochner.Dq pcvt 76e4daf4deSdrochnerconsole driver 77e4daf4deSdrochner.It Ql iso2 78e4daf4deSdrochnerISO-8859-2 (east european) encoding 79e4daf4deSdrochner.It Ql iso7 80e4daf4deSdrochnerISO-8859-7 (greek) encoding 81e4daf4deSdrochner.It Ql koi8r 82e4daf4deSdrochnerKOI8-R (russian) encoding 83e4daf4deSdrochner.El 84662e5768SgmcgarryPer default, 85ea46e54fSbjh21.Ql iso 86536eedccSdrochneris assumed. 87*7bdc4b94Swiz.It Fl f Ar wsdev 88*7bdc4b94SwizSpecify the device to operate on. 89*7bdc4b94SwizDefault is 90*7bdc4b94Swiz.Pa /dev/wsfont . 91*7bdc4b94Swiz.It Fl h Ar height 92*7bdc4b94SwizSets the height of a font character in pixels. 93*7bdc4b94SwizDefault is 16. 94536eedccSdrochner.It Fl N Ar name 95536eedccSdrochnerSpecifies a name which can be used later to refer to the font. 966533347dSdsaintyIf none is given, the 97536eedccSdrochner.Ar fontfile 98536eedccSdrochnername is used to create one. 996c1d54c4Shubertf.It Fl v 1006c1d54c4ShubertfPrints the font's properties before loading it. 101*7bdc4b94Swiz.It Fl w Ar width 102*7bdc4b94SwizSets the width of a font character in pixels. 103*7bdc4b94SwizDefault is 8. 104536eedccSdrochner.El 105719a8b0dSdrochner.Pp 106719a8b0dSdrochnerTypically, the 107719a8b0dSdrochner.Nm 108719a8b0dSdrochnerutility will be executed in system startup by the 109ab1ba363Slukem.Pa /etc/rc.d/wscons 110719a8b0dSdrochnerscript, controlled by the 111719a8b0dSdrochner.Pa /etc/wscons.conf 112719a8b0dSdrochnerconfiguration file. 113ea73e839Swiz.Sh FILES 114ea73e839Swiz.Pa /etc/wscons.conf 115ea73e839Swiz.Pa /usr/share/wscons/fonts 116719a8b0dSdrochner.Sh EXAMPLES 1173204ca28Swiz.Dl wsfontload -N myname -h 8 -e ibm /usr/share/wscons/fonts/vt220l.808 118719a8b0dSdrochner.Pp 119ea46e54fSbjh21Load the IBM-encoded 8\(mu8-font from the 1203204ca28Swiz.Xr wscons 4 121*7bdc4b94Swizdistribution. 122*7bdc4b94SwizThis (or another 8\(mu8-font) is necessary to use the 123719a8b0dSdrochner50-line screen type on 124719a8b0dSdrochner.Xr vga 4 125719a8b0dSdrochnerdisplays. 126662e5768Sgmcgarry.Pp 127662e5768Sgmcgarry.Dl wsfontload -N orator -e ibm /usr/share/wscons/fonts/orator.816 128662e5768Sgmcgarry.Dl wsconsctl -dw font=orator 129662e5768Sgmcgarry.Pp 130662e5768SgmcgarryLoad the 131662e5768Sgmcgarry.Dq orator 132e342c5fcSdrochnerIBM-encoded 8\(mu16 font and switch the first console screen 133e342c5fcSdrochner(ttyE0, wsconsctl's default) to this alternate font. 134b2275072Scgd.Sh SEE ALSO 13574345454Saugustss.Xr wscons 4 , 13674345454Saugustss.Xr wsconscfg 8 , 13774345454Saugustss.Xr wsconsctl 8 1388c073449Sbjh21.Sh BUGS 1398c073449Sbjh21Many features are missing. 1408c073449Sbjh21.Pp 1418c073449Sbjh21There is no way to remove a loaded font. 142