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:

   [email protected]

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!