Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ps2pk(1) [osx man page]

PS2PK(1)						      General Commands Manual							  PS2PK(1)

       ps2pk - creates a TeX pkfont from a type1 PostScript font

       ps2pk  [ -v ] [ -eenc ] [ -Xxres ] [ -Eexpansion ] [ -Sslant  ] [ -Ppointsize ] [ -Rbaseres ] [ -raspectratio  ] [ -Yyres ] [ -aAFMfile ] [
       -mmodename ] type1 [pkfont]

       This program renders a given type1 PostScript font at a given pointsize (default 10.0 points) and resolution (default 300dpi)  into  a  TeX

       To  generate  the  pkfont  ps2pk needs a valid type1 font file (for example Utopia-Regular, Utopia-Regula.pfb or Utopia-Regula.pfa) and its
       corresponding AFM-file (Utopia-Regular.afm) with the font metrics.  The program accepts both the binary	type1  format  (Utopia-Regula.pfb)
       and its ASCII equivalent (Utopia-Regular or Utopia-Regula.pfa).	To locate the files, ps2pk uses the kpathsea library (see the info page on
       kpathsea). Additionally, pfb and pfa files are searched for in the directory specified in the environment variable T1INPUTS, and afm  files
       are searched in AFMFONTS, if they are set (the -v flag will report which filenames are looked for).

       The  program  will  make a pkfont in which the character codes are derived from their AFM (Adobe Font Metrics) defined values.  This can be
       overruled by specifying an explicit encoding file via the -e option.  The encoding file enc should contain a valid PostScript encoding con-
       taining PostScript names like /hyphen.  Here is an incomplete example (see afm2tfm for complete syntax):

	      % This is the EC encoding.
	      /ECEncoding [	     % now 256 chars follow
	      % 0x00
		/grave /acute /circumflex /tilde /dieresis /hungarumlaut
		/ring /caron /breve /macron /dotaccent /cedilla
		/ogonek /quotesinglbase /guilsinglleft /guilsinglright

		(Rest of lines omitted.)

	      % 0xF0
		/eth /ntilde /ograve /oacute /ocircumflex /otilde
		/odieresis /oe /oslash /ugrave /uacute /ucircumflex
		/udieresis /yacute /thorn /germandbls ] def

       Options and arguments:

       -aAFMfile   Overrules the name that is used to locate the AFM file.

       -eenc	   Name  of  a	file  containing an encoding scheme (default - the encoding named in the AFM-file is used).  The actual PostScript
		   name of the encoding scheme is written as a "special" at the end of the pkfont.

       -Eextension The extension factor (real value, default 1.0).

       -mmodename  A modename such as would be used by METAFONT (default "Unknown mode").

       -Ppointsize The desired pointsize (real value, default 10.0 points).

       -Rbaseres   The desired base resolution (integer value, default 300 dpi).  If this differs from the value of xres, the appropriate magnifi-
		   cation will be shown in the "specials" at the end of the pkfont. If possible, this will be expressed as a magstep, otherwise as
		   a real number. For example, a pkfont with an xres of 329, using the default base resolution of 300, will include the  "special"
		   text "mag=magstep(0.5)" at the end of the font.

		   The	desired aspect ratio (expression, integerY/integerX, default 300/300).	This will be shown in the "specials" at the end of
		   the pkfont.	Setting the aspect ratio creates a value for yres but an explicit yres value will take precedence.  Argument  must
		   be in "" if spaces are left around `/'.

       -Sslant	   The slant (real value, default 0.0).

       -Xxres	   The resolution in the X direction (integer value, default 300 dpi).

       -Yyres	   The	resolution in the Y direction (integer value, default the value of xres). If yres differs from xres, a "special" text giv-
		   ing the aspect ratio will be written at the end of the pkfont.

       -v	   Verbose flag. (Tells what the program is doing.)

       type1	   The name of the PostScript type1 font.  The name of the AFM-file will be constructed from this name by removing  the  extension
		   (if	suplied)  and adding ".afm".  The PostScript "FontName" is extracted from the AFM-file and written into a "special" at the
		   end of the pkfont.

       [pkfont]    The name of the resulting pkfont can be overruled with this name.  The default name of pkfont is derived from the  basename	of
		   the	type1  font,  the pointsize and xres.  For example `ps2pk -P17.28 Utopia-Regular' will result in `Utopia-Regular17.300pk'.
		   An explicit value for the name of the pkfont is necessary when the type1 font name already shows the point size, otherwise  the
		   pointsize value is catenated on to the pkfont basename which is usually not what is wanted.

       The  following  PK "specials" provide an internal check on the characteristics of the pkfont, in accordance with the recommendations of the
       TeX Working Group on the TeX Directory Standard (TWG-TDS):
       "fontid=FontName", "codingscheme=Encoding", "fontfacebyte", "mag", "mode=(ps2pk)modename", "pixels-per-inch", and "aspect-ratio" if  it	is
       other than unity.

       This program uses the type1 hinting and rendering software IBM has donated to the X-consortium.

       `METAFONT: The Program', Donald Knuth.
       `The GFtoPK processor', belonging to the METAFONTware.
       `Adobe Font Metric Files', Version 3.0, PostScript Developer
       Support Group.
       info kpathsea

       1.4 (January 1994)

       Piet Tutelaers <>.  Modified for ps2pkm by Pierre A. Mackay <>, This manpage was adapted to teTeX by
       Frank Kuester <>.

									TeX								  PS2PK(1)
Man Page