.\" -*- nroff -*-
.\"
.\" psf2ams.1: psf2ams man page
.\" Copyright (c) 2005, 2007, 2020 John Elliott
.\"
.\"
.\"
.\" psftools: Manipulate console fonts in the .PSF format
.\" Copyright (C) 2005, 2007, 2020  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 psf2ams 1 "12 January, 2021" "Version 1.1.2" "PSF Tools"
.\"
.\"------------------------------------------------------------------
.\"
.SH NAME
psf2ams - convert a PC Screen Font file to an Amstrad CP/M font
.\"
.\"------------------------------------------------------------------
.\"
.SH SYNOPSIS
.PD 0
.B psf2ams
.RI [ "-ems=EMSFILE" ]
.RI [ "-scrchar=IDENTITY" ]
.RI [ INPUTFILE 
.RI [ OUTPUTFILE ]]
.P
.PD 1
.\"
.\"------------------------------------------------------------------
.\"
.SH DESCRIPTION
.LP 
psf2ams converts a font in the .PSF format to a font that can be used under
Amstrad CP/M or LocoScript 1. The font can be output either as a .COM file 
(which loads the associated font when run), a .EMS file (based on a standard 
CP/M or LocoScript 1 .EMS file) or a SCRCHAR.JOY file (screen characters for 
LocoScript 2/3/4).
.LP
For best results the font should be 8 pixels by 8 (for the CPC, PCW and 
Spectrum +3) or 8 pixels by 16 (for the PcW16).
.LP
It is also possible to load PCW fonts on a PCW using LOADPSF.COM or by 
converting to a raw font with psf2raw(1) and using SETFONT.COM, but for
those distributing a new font, a self-contained .COM file may be more 
convenient.
.LP
The .COM files generated by psf2ams will run under CP/M on the CPC, PCW, PcW16
and Spectrum +3. They will also fail gracefully rather than crash if run 
under PCDOS.
.LP
If the font has fewer than 256 characters, only those characters contained
within the font will be redefined.
.LP
If the font has more than 256 characters, then on the Spectrum +3 the 
first 256 will be loaded to the 8x8 font, and the second 256 (or whatever
is left) to the 8x5 font. If you don't want this, use psfxform(1) to reduce
the font to 256 characters before passing it to psf2ams(1).
.LP
If the font is 16 or more pixels high and a .COM file is being output, 
then it will primarily target the PcW16. When run on a CPC, PCW or Spectrum
+3, the font will be programmatically halved in height. 
.\"
.\"------------------------------------------------------------------
.\"
.SH OPTIONS
.TP
.B --ems=template
Output a .EMS file, using the provided CP/M or LocoScript 1 .EMS file as a 
template. 
.TP
.B --scrchar
.TP
.B --scrchar=identity_text
Output a SCRCHAR.JOY file. Up to 90 characters of identity text can be 
provided, which will be written to the header of the file. Characters 0-31 of
the input file will be discarded.
.\"
.\"------------------------------------------------------------------
.\"
.SH BUGS
.LP 
Attempting to use --ems with a LocoScript 2 or later .EMS file will
not work, owing to the different order in which the font is stored. 
.\"
.\"------------------------------------------------------------------
.\"
.SH SEE ALSO
ams2psf(1), psf2raw(1)
.\"
.\"------------------------------------------------------------------
.\"
.SH AUTHOR
John Elliott <seasip.webmaster@gmail.com>.
.PP