1psf2zx(1)                          PSF Tools                         psf2zx(1)
2
3
4

NAME

6       psf2zx - convert a PSF font to Spectrum format
7

SYNOPSIS

9       psf2zx [--tap] [--naked] [--rom=romfile] [--sna=snapfile] [--mode=bare]
10       [--mode=merge1] [INPUTFILE [OUTPUTFILE]]

DESCRIPTION

12       psf2zx converts a PSF font into a font suitable for use on  a  Sinclair
13       Spectrum.
14

OPTIONS

16       --p3dos
17              Sets the output format to Spectrum +3DOS, with a 128-byte header
18              followed by the font data. This is the default output format.
19
20       --tap  Sets the output format to .TAP (Spectrum emulator  tape  image).
21              The  resulting  TAP  image  will  contain  a  single file called
22              T:font.bin.
23
24       --naked
25              Sets the output format to a simple 768-byte binary file will  be
26              written, with no header or trailer records.
27
28       --rom=romfile
29              Sets  the output to be a Spectrum ROM, based on the ROM image in
30              romfile.  The file written will be a copy of  romfile  but  with
31              the font replaced by the result of psf2zx.
32
33       --sna=snapfile
34
35       Sets  the output to be a .SNA snapshot, based on the snapshot passed as
36       snapfile.  The file written will be a copy of  snapfile  but  with  the
37       font replaced by the result of psf2zx.
38
39       This  depends  on  the CHARS system variable having been set up so that
40       the game outputs using the ROM routines; if the program in the snapshot
41       uses some other form of output, it may leave CHARS alone or set it to a
42       random value. For example, the font in the game 2112 cannot be replaced
43       using this method.
44
45       --mode=raw
46              Copies  characters  32-127 from the PSF file, without attempting
47              to translate the pound sign, up arrow or copyright symbol.  This
48              is the default conversion mode if the source file has no Unicode
49              directory.
50
51       --mode=merge1
52              Copies characters from the PSF file, converting the pound  sign,
53              up arrow and copyright symbol. This is the default conversion if
54              the source file has a  Unicode  directory.  If  this  option  is
55              selected  but  the source file has no Unicode directory, it will
56              be assumed to be using a variant of the ISO-8859-1 codepage with
57              the  up-arrow  at  character  position 18h (based on LAT1-08.PSF
58              supplied with Linux).
59

BUGS

61       The behaviour of the 'merge1' mode is ugly when applied to  non-Unicode
62       PSF files.
63

SEE ALSO

65       zx2psf(1)
66

AUTHOR

68       John Elliott <jce@seasip.demon.co.uk>.
69
70Version 1.0.8                    21 June, 2008                       psf2zx(1)