summaryrefslogtreecommitdiff
path: root/support/hp2pl/hptfm2pl.doc
blob: 5aa2124be99b142ef4a97ee89c9185558c583315 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246



























                                  HPtfm2pl

     HPtfm2pl converts HP AutoFont Metric Files into TeX PL (TFM) files

                              Version 1.0b\beta

























               Copyright (c) 1992,93 by Small Planet Software

                            All Rights Reserved




        THIS PROGRAM IS ABSOLUTELY FREE. THIS PROGRAM IS  PROVIDED
        ``AS IS'' WITHOUT WARRANTY  OF ANY KIND, EITHER  EXPRESSED
        OR  IMPLIED,  INCLUDING  BUT  NOT  LIMITED TO, THE IMPLIED
        WARRANTIES   OF   MERCHANTABILITY   AND   FITNESS   FOR  A
        PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY  AND
        PERFORMANCE  OF  THE  PROGRAM  IS  WITH  YOU.   SHOULD THE
        PROGRAM  PROVE  DEFECTIVE,  YOU  ASSUME  THE  COST  OF ALL
        NECESSARY SERVICING, REPAIR OR CORRECTION.

        IN NO  EVENT WILL  ANY COPYRIGHT  HOLDER BE  LIABLE TO YOU
        FOR DAMAGES,  INCLUDING ANY  GENERAL, SPECIAL,  INCIDENTAL
        OR  CONSEQUENTIAL  DAMAGES  ARISING  OUT  OF  THE  USE  OR
        INABILITY TO  USE THE  PROGRAM (INCLUDING  BUT NOT LIMITED
        TO  LOSS  OF  DATA  OR  DATA  BEING RENDERED INACCURATE OR
        LOSSES SUSTAINED BY YOU OR  THIRD PARTIES OR A FAILURE  OF
        THE PROGRAM TO OPERATE  WITH ANY OTHER PROGRAMS),  EVEN IF
        SUCH  HOLDER  OR  OTHER  PARTY  HAS  BEEN  ADVISED  OF THE
        POSSIBILITY OF SUCH DAMAGES.

  Every reasonable effort has been made to assure the quality and
  completeness of this program, if you have any questions, comments, or
  suggestions or if you believe that you have found a bug please contact
  the author at the address given at the end of this document.

  All trademarks used within this document are trademarks of their
  respective owners.

Changes (what's new and exciting)
---------------------------------

 Version 1.0b\beta

 o Changed the STRETCH, SHRINK, EXTRASPACE, QUAD, and SPACE parameters
   to reasonable defaults.  Previous versions of this program attempted
   to use a mathematical function to select the appropriate measure
   based on the design size.  Unfortunately, I created the function by
   interpolation over a small range of points (5-17pt fonts) and its
   predictive value when extrapolated out to 250ish points was absolutely
   bogus.  Let me know how the new measurements work.

 Version 1.0a\beta

 o Added support for HP LJ4 TrueType TFMs.  I've left in a switch (/I)
   to override the alternate rounding suggested by the folks at HP.
   It seems to make too much difference to me.  But since I don't have
   an LJ4 ...

 Version 0.91beta

 o I modified the calculation of "design size" so that the design size
   of the HP AutoFont file is used instead of always using 10pt.  This
   means that the default size of the fixed-sized fonts will be correct.
   Unfortunately, it means you'll get a 250pt Times Roman font if you
   don't specify 'at Npt'.

 Version 0.9beta

 o First release.

Usage
-----

HPtfm2pl is run from the DOS command prompt. In order to keep the program
small and simple, a command-line interface has been chosen instead of
something more user-friendly.  The general format for running HPtfm2pl
looks like this:

        HPTFM2PL autofont symsyet <ligfile> </i>

Where:

autofont        is the name of the HP AutoFont Support file to read.

symset          is the symbol set to use.  The symbol set must be present
                in the AutoFont file.  If you select a symbol set that is
                not present, HPtfm2pl will list the symbol sets which are
                present.

ligfile         is the name of the ligature file to use.  Information about
                ligatures is not present in the AutoFont file.  The default
                ligature file is 'symset.lig'.  For example, if you are
                creating a TFM file for symbol set 9U, the default symbol
                set file is '9U.LIG'.

/i              Turns off the special rounding algorithm suggested by the
                HP LJ4 Developer's Kit.  This option only matters on HP
                TFMs for TrueType fonts.

Assuming that no errors occur, the PL file is written to standard output.
This means that you must use I/O redirection to write it to a file.  For
example, you might run:

        hptfm2pl c:\autofont\trr0000s.tfm 0u > trr0u.pl

To create a TeX PL file for Times-Roman Regular symbol set 0U.

If anyone is really distressed by the fact that I was lazy and didn't feel
like adding a third parameter (with the resulting positional parameter
hairyness), "I'm sorry."  There, does that help? ;-)

Caveat
------

I don't have access to the symbol tables for some of the new symbol sets
in the LJ4.  Consequently, I do not have ligature files for those symbol
sets...

If you create ligature files for the missing symbol sets, _please_ send
them to me.

Bye Bye
-------

I hope that you find HPtfm2pl useful.  HPtfm2pl is absolutely free.  You
may copy it and give it away to anyone that you think might benefit from
it.  However, you may not sell it or profit from it's distribution in any
way, shape, or form.

If you wish to contact the author, you may write to:

    Norman Walsh
    87 South Silver Ln, #2
    Sunderland, MA 01375
    USA

or send electronic mail to:

    walsh@cs.umass.edu

Other Programs by Small Planet Software
---------------------------------------

PKtoSFP
-------

PKtoSFP converts TeX PK fonts into HP LaserJet softfonts. PKtoSFP can
produce HP AutoFont Support files to provide accurate spacing and kerning
information to other applications.PKtoSFP is the inverse of SFPtoPK.

SFPtoPK
-------

SFPtoPK converts HP LaserJet softfonts into TeX fonts. SFPtoPK can use
AutoFont Support files to provide accurate spacing and kerning information
to TeX. SFPtoPK is the inverse of PKtoSFP.

PKscale
-------

Changes the magnification of TeX PK files. This can be especially useful if
you are working with devices of differing resolutions. PKscale is included
in the SFPtoPK package.

MergeSFP
--------

Merges multiple LaserJet softfonts into a single file. If you are
generating TeX fonts, you may discover that you need characters from
several different symbol sets (and, hence, several different LaserJet
softfonts) in order to create a complete TeX character set.MergeSFP allows
you to construct a single LaserJet softfont containing the appropriate
characters from several different softfonts.

Sfware
------

The Sfware utilities allow you to download, rotate, compress, expand, view,
and perform special effects on softfonts. The effects provided include
bold, fill, convert to fixed spacing, halftone, hollow, invert, mirror,
outline, convert to proportional spacing, resize, reverse, shade, shadow,
slant, stripe, tilt, three-d, hollow-three-d, and filled-three-d effects.
The effects can be tailored and customized for any font with various
parameters and shading patterns. Sfware is distributed under a shareware
license agreement.

SFP2Auto
--------

SFP2Auto reads HP LaserJet softfonts and produces HP AutoFont Support files
directly.Many applications that cannot use softfonts directly, can install
them with HP AutoFont Support. For example, this program allows you to
install arbitrary softfonts into WordPerfect using only the PTR program!