2022-06-09 01:38:29 +03:00
|
|
|
.\" $NetBSD: wsfontload.8,v 1.32 2022/06/08 22:38:29 uwe Exp $
|
2003-02-17 23:07:06 +03:00
|
|
|
.\"
|
|
|
|
.\" Copyright (c) 1999, 2001
|
|
|
|
.\" Matthias Drochner. All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
.\" SUCH DAMAGE.
|
1999-01-13 22:02:34 +03:00
|
|
|
.\"
|
2022-06-09 01:38:29 +03:00
|
|
|
.Dd June 9, 2022
|
1999-01-13 22:02:34 +03:00
|
|
|
.Dt WSFONTLOAD 8
|
2009-03-09 22:24:26 +03:00
|
|
|
.Os
|
1999-01-13 22:02:34 +03:00
|
|
|
.Sh NAME
|
|
|
|
.Nm wsfontload
|
2002-03-20 19:18:47 +03:00
|
|
|
.Nd "load a font bitmap into the wsfont pool or a wscons display device"
|
1999-01-13 22:02:34 +03:00
|
|
|
.Sh SYNOPSIS
|
2003-02-25 13:34:36 +03:00
|
|
|
.Nm
|
2011-06-08 16:47:51 +04:00
|
|
|
.Op Fl Bbv
|
|
|
|
.Op Fl e Ar encoding
|
2001-10-29 20:59:00 +03:00
|
|
|
.Op Fl f Ar wsdev
|
1999-03-07 14:58:22 +03:00
|
|
|
.Op Fl h Ar height
|
|
|
|
.Op Fl N Ar name
|
2011-06-08 16:47:51 +04:00
|
|
|
.Op Fl w Ar width
|
1999-01-13 22:02:34 +03:00
|
|
|
.Op Ar fontfile
|
2022-06-09 01:38:29 +03:00
|
|
|
.Nm
|
|
|
|
.Fl l
|
1999-01-13 22:02:34 +03:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
|
|
|
.Nm
|
2002-01-19 14:44:57 +03:00
|
|
|
utility loads a font bitmap into the wsfont font pool
|
2001-10-29 20:59:00 +03:00
|
|
|
(or a wscons device if the device driver supports this).
|
1999-01-13 22:02:34 +03:00
|
|
|
The font gets assigned a name in this process which it can be referred to
|
|
|
|
by later for use on a display screen.
|
|
|
|
The font is loaded from the specified
|
|
|
|
.Ar fontfile ,
|
2000-10-02 21:04:12 +04:00
|
|
|
or from standard input if
|
1999-01-13 22:02:34 +03:00
|
|
|
.Ar fontfile
|
|
|
|
is not provided.
|
|
|
|
.Pp
|
|
|
|
The options are:
|
2022-06-09 01:38:29 +03:00
|
|
|
.Bl -tag -width Fl
|
2011-06-08 16:47:51 +04:00
|
|
|
.It Fl B
|
|
|
|
Specifies that the font data is ordered right-to-left byte wise.
|
|
|
|
The default is left-to-right.
|
|
|
|
.It Fl b
|
|
|
|
Specifies that the font data is ordered right-to-left bit wise.
|
|
|
|
The default is left-to-right.
|
1999-01-13 22:02:34 +03:00
|
|
|
.It Fl e Ar encoding
|
2003-05-04 04:52:39 +04:00
|
|
|
Sets the encoding of the font.
|
2022-06-09 01:38:29 +03:00
|
|
|
This can be either a symbolic name or a numeric value.
|
|
|
|
Currently recognized names are:
|
|
|
|
.Bl -tag -width Ql
|
2011-06-08 14:25:21 +04:00
|
|
|
.It Ql iso
|
|
|
|
ISO-8859-1 encoding
|
|
|
|
.It Ql ibm
|
2022-06-09 01:38:29 +03:00
|
|
|
IBM CP437 encoding
|
2011-06-08 14:25:21 +04:00
|
|
|
.It Ql pcvt
|
|
|
|
the custom encoding of the supplemental fonts which came with the
|
2000-10-03 18:20:52 +04:00
|
|
|
.Bx
|
1999-01-13 22:02:34 +03:00
|
|
|
.Dq pcvt
|
2011-06-08 14:25:21 +04:00
|
|
|
console driver
|
|
|
|
.It Ql iso2
|
2022-06-09 01:38:29 +03:00
|
|
|
ISO-8859-2 (Eastern European) encoding
|
2011-06-08 14:25:21 +04:00
|
|
|
.It Ql iso7
|
2022-06-09 01:38:29 +03:00
|
|
|
ISO-8859-7 (Greek) encoding
|
2011-06-08 14:25:21 +04:00
|
|
|
.It Ql koi8r
|
2022-06-09 01:38:29 +03:00
|
|
|
KOI8-R (Russian) encoding
|
2011-06-08 14:25:21 +04:00
|
|
|
.El
|
2022-06-09 01:38:29 +03:00
|
|
|
.Pp
|
2003-05-04 04:52:39 +04:00
|
|
|
Per default,
|
2000-10-03 18:20:52 +04:00
|
|
|
.Ql iso
|
1999-01-13 22:02:34 +03:00
|
|
|
is assumed.
|
2011-06-08 16:47:51 +04:00
|
|
|
.It Fl f Ar wsdev
|
|
|
|
Specify the device to operate on.
|
|
|
|
Default is
|
|
|
|
.Pa /dev/wsfont .
|
|
|
|
.It Fl h Ar height
|
|
|
|
Sets the height of a font character in pixels.
|
|
|
|
Default is 16.
|
2021-04-24 10:52:07 +03:00
|
|
|
.It Fl l
|
2021-04-24 12:03:05 +03:00
|
|
|
Print a list of fonts that have been loaded or are built-in to the kernel.
|
1999-01-13 22:02:34 +03:00
|
|
|
.It Fl N Ar name
|
|
|
|
Specifies a name which can be used later to refer to the font.
|
2002-04-06 07:17:47 +04:00
|
|
|
If none is given, the
|
1999-01-13 22:02:34 +03:00
|
|
|
.Ar fontfile
|
|
|
|
name is used to create one.
|
2001-01-26 23:25:25 +03:00
|
|
|
.It Fl v
|
|
|
|
Prints the font's properties before loading it.
|
2011-06-08 16:47:51 +04:00
|
|
|
.It Fl w Ar width
|
|
|
|
Sets the width of a font character in pixels.
|
|
|
|
Default is 8.
|
1999-01-13 22:02:34 +03:00
|
|
|
.El
|
1999-03-31 19:15:57 +04:00
|
|
|
.Pp
|
2022-06-09 01:38:29 +03:00
|
|
|
.Nm
|
|
|
|
supports
|
|
|
|
.Ql \&.wsf
|
|
|
|
file format that contains the necessary information about the font in
|
|
|
|
the font file itself.
|
|
|
|
Such files can be loaded without specifying any arguments,
|
|
|
|
though
|
|
|
|
.Fl N
|
|
|
|
can be used to override the font name.
|
|
|
|
.Pp
|
1999-03-31 19:15:57 +04:00
|
|
|
Typically, the
|
|
|
|
.Nm
|
2022-06-09 01:38:29 +03:00
|
|
|
utility will be executed during system startup by the
|
|
|
|
.Xr rc 8
|
|
|
|
script.
|
|
|
|
See
|
|
|
|
.Xr wscons.conf 5 .
|
2002-02-02 05:09:04 +03:00
|
|
|
.Sh FILES
|
2022-06-09 01:38:29 +03:00
|
|
|
.Bl -item -compact
|
|
|
|
.It
|
2002-02-02 05:09:04 +03:00
|
|
|
.Pa /usr/share/wscons/fonts
|
2022-06-09 01:38:29 +03:00
|
|
|
.El
|
1999-03-31 19:15:57 +04:00
|
|
|
.Sh EXAMPLES
|
2022-06-09 01:38:29 +03:00
|
|
|
Load ISO-encoded 20-pixel high Terminus font
|
|
|
|
and use it on the current console
|
2021-04-24 12:18:44 +03:00
|
|
|
.Pp
|
2022-06-09 01:38:29 +03:00
|
|
|
.Bd -literal -offset indent
|
|
|
|
# wsfontload /usr/share/wscons/fonts/ter-120n.wsf
|
|
|
|
# wsfontload -l | grep Terminus
|
|
|
|
Terminus20-ISO8859-1 10x20
|
|
|
|
# wsconsctl -f `tty` -dw font=Terminus20-ISO8859-1
|
|
|
|
.Ed
|
|
|
|
.Pp
|
|
|
|
Load the ISO-encoded 16\[tmu]32 Spleen font
|
|
|
|
and switch the first console screen to use it:
|
|
|
|
.Pp
|
|
|
|
.Bd -literal -offset indent
|
|
|
|
# wsfontload -w 16 -h 32 -e iso -N spleen32 \e
|
2021-04-24 12:18:44 +03:00
|
|
|
/usr/share/wscons/fonts/spleen-16x32.fnt
|
|
|
|
# wsconsctl -dw font=spleen32
|
|
|
|
.Ed
|
1999-03-31 19:15:57 +04:00
|
|
|
.Pp
|
2022-06-09 01:38:29 +03:00
|
|
|
Load the IBM-encoded 8\[tmu]8-font from the
|
2000-10-27 15:31:32 +04:00
|
|
|
.Xr wscons 4
|
2021-04-24 12:18:44 +03:00
|
|
|
distribution:
|
|
|
|
.Pp
|
2022-06-09 01:38:29 +03:00
|
|
|
.Bd -literal -offset indent
|
|
|
|
# wsfontload -N myname -h 8 -e ibm \e
|
|
|
|
/usr/share/wscons/fonts/vt220l.808
|
2021-04-24 12:18:44 +03:00
|
|
|
.Ed
|
|
|
|
.Pp
|
2022-06-09 01:38:29 +03:00
|
|
|
This or another 8\[tmu]8-font is necessary to use the
|
1999-03-31 19:15:57 +04:00
|
|
|
50-line screen type on
|
|
|
|
.Xr vga 4
|
|
|
|
displays.
|
1999-04-06 08:54:19 +04:00
|
|
|
.Sh SEE ALSO
|
1999-02-04 00:01:40 +03:00
|
|
|
.Xr wscons 4 ,
|
2022-06-09 01:38:29 +03:00
|
|
|
.Xr wsfont 4 ,
|
|
|
|
.Xr wscons.conf 5 ,
|
|
|
|
.\" XXX: BUGS: not yet
|
|
|
|
.\" .Xr wsf 5 ,
|
1999-02-04 00:01:40 +03:00
|
|
|
.Xr wsconsctl 8
|
2022-06-09 01:38:29 +03:00
|
|
|
.Sh HISTORY
|
|
|
|
Support for
|
|
|
|
.Ql \&.wsf
|
|
|
|
font files appeared in
|
|
|
|
.Nx 10.0 .
|
2000-10-02 21:04:12 +04:00
|
|
|
.Sh BUGS
|
|
|
|
Many features are missing.
|
|
|
|
.Pp
|
2022-06-09 01:38:29 +03:00
|
|
|
The
|
|
|
|
.Ql \&.wsf
|
|
|
|
file format is undocumented.
|
|
|
|
.Pp
|
2000-10-02 21:04:12 +04:00
|
|
|
There is no way to remove a loaded font.
|