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

NAME

6       zx2psf - convert a Spectrum font to PSF format
7

SYNOPSIS

9       zx2psf  [--rom]  [--sna]  [--mode=bare] [--mode=merge1] [--mode=latin1]
10       [--mode=synth1] [--graphics=none]  [--graphics=block]  [--graphics=udg]
11       [--psf1] [--psf2] [INPUTFILE [OUTPUTFILE]]

DESCRIPTION

13       zx2psf  converts  a Spectrum font (either a +3DOS file, a TAP file with
14       one member, or a raw memory dump) to PSF format.
15

OPTIONS

17       --rom  The file is a Spectrum ROM image; extract the embedded font.
18
19       --sna  The file is a Spectrum SNA snapshot  image;  if  it  contains  a
20              font,  extract  it.   This  depends on the CHARS system variable
21              having been set up so that the game outputs using the  ROM  rou‐
22              tines;  if  the  program in the snapshot uses some other form of
23              output, it may leave CHARS alone or set it to  a  random  value.
24              For  example,  the  font  in the game 2112 cannot be found using
25              this method.
26
27       --mode=bare
28              The Spectrum font is copied as-is. Characters outside the  range
29              defined by the Spectrum are set to blank.
30
31       --mode=latin1
32              The  Spectrum font is copied as-is. Characters outside the range
33              defined by the Spectrum are set to those in  LAT1-01.PSF  (which
34              is based on ISO-8859-1, but with extra character shapes).
35
36       --mode=merge1
37              As  latin1  above,  but  the  pound sign, up arrow and copyright
38              characters are moved to their correct positions for ISO Latin-1.
39
40       --mode=synth1
41              As merge1, except that the Latin-1 characters are mostly  gener‐
42              ated  from the Spectrum characters rather than being copied from
43              LAT1-08.PSF. If this option is used the font will require manual
44              editing afterwards to make it look better.
45
46       --graphics=none
47              The  graphics  characters 128-159 will be blank (--mode=bare) or
48              those from LAT1-08.PSF (other modes).
49
50       --graphics=block
51              Characters 128-143 will be the Spectrum block graphics.  144-159
52              will  be  blank  (--mode=bare)  or those from LAT1-08.PSF (other
53              modes).
54
55       --graphics=udg
56              Characters 128-143 will be the Spectrum block graphics.  If  the
57              --sna  option  was present, characters 144-159 will be the first
58              16 user-defined graphics; otherwise they will be copies  of  "A"
59              to  "P".  If  --mode=bare is set, characters 160-164 will be the
60              last five UDGs (if the --sna option is present) or copies of "Q"
61              to "U" (otherwise).
62
63       --psf1 Output in the PSF1 format.
64
65       --psf2 Output in the PSF2 format (default).
66

BUGS

68       The  whole Latin-1 thing is ugly. Fortunately zx2psf always puts a cor‐
69       rect Unicode directory on the resulting file, so  Unicode-aware  utili‐
70       ties should always be able to find the correct character.
71

SEE ALSO

73       psf2zx(1)
74

AUTHOR

76       John Elliott <jce@seasip.demon.co.uk>.
77
78Version 1.0.8                    21 June, 2008                       zx2psf(1)