1*ba26bce6Swiz.\" $NetBSD: wsfontload.8,v 1.28 2021/04/24 07:52:07 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.\" 27*ba26bce6Swiz.Dd April 24, 2021 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 357bdc4b94Swiz.Op Fl Bbv 36d77575d3Smycroft.Op Fl e Ar encoding 377bdc4b94Swiz.Op Fl f Ar wsdev 387bdc4b94Swiz.Op Fl h Ar height 39d77575d3Smycroft.Op Fl N Ar name 407bdc4b94Swiz.Op Fl w Ar width 41536eedccSdrochner.Op Ar fontfile 42*ba26bce6Swiz.Nm Fl l 43536eedccSdrochner.Sh DESCRIPTION 44536eedccSdrochnerThe 45536eedccSdrochner.Nm 46371be6adSdrochnerutility loads a font bitmap into the wsfont font pool 47371be6adSdrochner(or a wscons device if the device driver supports this). 48536eedccSdrochnerThe font gets assigned a name in this process which it can be referred to 49536eedccSdrochnerby later for use on a display screen. 50536eedccSdrochnerThe font is loaded from the specified 51536eedccSdrochner.Ar fontfile , 528c073449Sbjh21or from standard input if 53536eedccSdrochner.Ar fontfile 54536eedccSdrochneris not provided. 55536eedccSdrochner.Pp 56536eedccSdrochnerThe options are: 57536eedccSdrochner.Bl -tag -width xxxxxxxxxxx 587bdc4b94Swiz.It Fl B 597bdc4b94SwizSpecifies that the font data is ordered right-to-left byte wise. 607bdc4b94SwizThe default is left-to-right. 617bdc4b94Swiz.It Fl b 627bdc4b94SwizSpecifies that the font data is ordered right-to-left bit wise. 637bdc4b94SwizThe default is left-to-right. 64536eedccSdrochner.It Fl e Ar encoding 65662e5768SgmcgarrySets the encoding of the font. 66662e5768SgmcgarryThis can be either a symbolic abbreviation or a numeric value. 67e4daf4deSdrochnerCurrently recognized abbreviations are: 68e4daf4deSdrochner.Bl -tag -width xxxxxxx 69e4daf4deSdrochner.It Ql iso 70e4daf4deSdrochnerISO-8859-1 encoding 71e4daf4deSdrochner.It Ql ibm 72e4daf4deSdrochnerIBM encoded fonts 73e4daf4deSdrochner.It Ql pcvt 74e4daf4deSdrochnerthe custom encoding of the supplemental fonts which came with the 75ea46e54fSbjh21.Bx 76536eedccSdrochner.Dq pcvt 77e4daf4deSdrochnerconsole driver 78e4daf4deSdrochner.It Ql iso2 79e4daf4deSdrochnerISO-8859-2 (east european) encoding 80e4daf4deSdrochner.It Ql iso7 81e4daf4deSdrochnerISO-8859-7 (greek) encoding 82e4daf4deSdrochner.It Ql koi8r 83e4daf4deSdrochnerKOI8-R (russian) encoding 84e4daf4deSdrochner.El 85662e5768SgmcgarryPer default, 86ea46e54fSbjh21.Ql iso 87536eedccSdrochneris assumed. 887bdc4b94Swiz.It Fl f Ar wsdev 897bdc4b94SwizSpecify the device to operate on. 907bdc4b94SwizDefault is 917bdc4b94Swiz.Pa /dev/wsfont . 927bdc4b94Swiz.It Fl h Ar height 937bdc4b94SwizSets the height of a font character in pixels. 947bdc4b94SwizDefault is 16. 95*ba26bce6Swiz.It Fl l 96*ba26bce6SwizPrint a list of available fonts. 97536eedccSdrochner.It Fl N Ar name 98536eedccSdrochnerSpecifies a name which can be used later to refer to the font. 996533347dSdsaintyIf none is given, the 100536eedccSdrochner.Ar fontfile 101536eedccSdrochnername is used to create one. 1026c1d54c4Shubertf.It Fl v 1036c1d54c4ShubertfPrints the font's properties before loading it. 1047bdc4b94Swiz.It Fl w Ar width 1057bdc4b94SwizSets the width of a font character in pixels. 1067bdc4b94SwizDefault is 8. 107536eedccSdrochner.El 108719a8b0dSdrochner.Pp 109719a8b0dSdrochnerTypically, the 110719a8b0dSdrochner.Nm 111719a8b0dSdrochnerutility will be executed in system startup by the 112ab1ba363Slukem.Pa /etc/rc.d/wscons 113719a8b0dSdrochnerscript, controlled by the 114719a8b0dSdrochner.Pa /etc/wscons.conf 115719a8b0dSdrochnerconfiguration file. 116ea73e839Swiz.Sh FILES 117ea73e839Swiz.Pa /etc/wscons.conf 118ea73e839Swiz.Pa /usr/share/wscons/fonts 119719a8b0dSdrochner.Sh EXAMPLES 1203204ca28Swiz.Dl wsfontload -N myname -h 8 -e ibm /usr/share/wscons/fonts/vt220l.808 121719a8b0dSdrochner.Pp 122ea46e54fSbjh21Load the IBM-encoded 8\(mu8-font from the 1233204ca28Swiz.Xr wscons 4 1247bdc4b94Swizdistribution. 1257bdc4b94SwizThis (or another 8\(mu8-font) is necessary to use the 126719a8b0dSdrochner50-line screen type on 127719a8b0dSdrochner.Xr vga 4 128719a8b0dSdrochnerdisplays. 129662e5768Sgmcgarry.Pp 130662e5768Sgmcgarry.Dl wsfontload -N orator -e ibm /usr/share/wscons/fonts/orator.816 131662e5768Sgmcgarry.Dl wsconsctl -dw font=orator 132662e5768Sgmcgarry.Pp 133662e5768SgmcgarryLoad the 134662e5768Sgmcgarry.Dq orator 135e342c5fcSdrochnerIBM-encoded 8\(mu16 font and switch the first console screen 136e342c5fcSdrochner(ttyE0, wsconsctl's default) to this alternate font. 137b2275072Scgd.Sh SEE ALSO 13874345454Saugustss.Xr wscons 4 , 13974345454Saugustss.Xr wsconscfg 8 , 14074345454Saugustss.Xr wsconsctl 8 1418c073449Sbjh21.Sh BUGS 1428c073449Sbjh21Many features are missing. 1438c073449Sbjh21.Pp 1448c073449Sbjh21There is no way to remove a loaded font. 145ecdc8f8cSpgoyette.Pp 146ecdc8f8cSpgoyetteThere is no way to determine which fonts have been loaded. 147