.\" -*- nroff -*-
.\"
.\" fnt2vfont.1: fnt2vfont man page
.\" Copyright (c) 2005, 2007 John Elliott
.\"
.\"
.\"
.\" psftools: Manipulate console fonts in the .PSF format
.\" Copyright (C) 2005, 2007  John Elliott
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH fnt2vfont 1 "26 May, 2024" "Version 1.1.2" "PSF Tools"
.\"
.\"------------------------------------------------------------------
.\"
.SH NAME
fnt2vfont - Convert a Windows font-resource file to BSD vfont format
.\"
.\"------------------------------------------------------------------
.\"
.SH SYNOPSIS
.PD 0
.B fnt2vfont
.RI [ "--codepage=page" ]
.RI [ "--v1" ]
.RI [ "--v2" ]
.RI [ "--big-endian" ]
.RI [ "--basepoint=x" ]
.RI [ "--codepage=x" ]
.RI [ INPUTFILE 
.RI [ OUTPUTFILE ]]
.P
.PD 1
.\"
.\"------------------------------------------------------------------
.\"
.SH DESCRIPTION
fnt2vfont converts a Windows font-resource file (.FNT) to BSD vfont 
format.
.\"
.\"------------------------------------------------------------------
.\"
.SH OPTIONS
.TP
.B --v1
Output in the original vfont(5) format. This is subject to the limitations
of the format: At most 256 characters, at most 127x127 pixels per character,
and no Unicode directory.
.TP
.B --v2
Output in vfont2(5) format. This allows more characters, larger bitmaps,
and Unicode, but is currently supported only by psftools utilities.
.TP
.B --big-endian
When writing in the original vfont format, create a big-endian file 
(suitable for platforms such as SunOS).
.TP
.B --basepoint=x
In a vfont each character has a basepoint, and when characters are printed 
the basepoints are used to align them. The vertical position of the basepoint
is determined from the FNT file. By default the horizontal position is the 
bottom left-hand corner of character 65 (capital A), but this option allows 
it to be set manually.
.TP
.B --codepage=page
Add a Unicode directory for the specified codepage, which can be identified
by number or name. See psfpages(1) for a list of valid codepage names.
If this option is not supplied, the program will assume codepage 437 for 
fonts in the "OEM" character set, and 1252 for fonts in the "ANSI" character
set.
.\"
.\"------------------------------------------------------------------
.\"
.\".SH BUGS
.\"
.\"------------------------------------------------------------------
.\"
.SH SEE ALSO
vfont2fnt(1), psf2raw(1), mda2psf(1), psfpages(1)
.\"
.\"------------------------------------------------------------------
.\"
.SH AUTHOR
John Elliott <seasip.webmaster@gmail.com>.
.PP