PS2PK(1) User Commands PS2PK(1) NAME ps2pk - creates a TeX pkfont from a type1 PostScript font SYNOPSIS pk2pk [ _o_p_t_i_o_n_s] type1 [pkfont] options: -v -e_e_n_c -X_x_r_e_s -E_e_x_p_a_n_s_i_o_n -S_s_l_a_n_t options: -P_p_o_i_n_t_s_i_z_e -R_b_a_s_e_r_e_s -r_a_s_p_e_c_t_r_a_t_i_o options: -Y_y_r_e_s -a_A_F_M_f_i_l_e -m_m_o_d_e_n_a_m_e DESCRIPTION This program renders a given type1 PostScript font at a given pointsize (default 10.0 points) and resolution (default 300dpi) into a TeX pkfont. To generate the pkfont pk2ps needs a valid type1 fontname (for example Utopia-Regular, Utopia-Regula.pfb or Utopia- Regula.pfa) and its corresponding AFM-file (Utopia- Regular.afm). The program accepts both the MSDOS binary type1 format (Utopia-Regula.pfb) and its ASCII equivalent (Utopia-Regular or Utopia-Regula.pfa). To locate the type1 font and its AFM-file ps2pk will use the environment T1INPUTS if it is set otherwise its built in default (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 _e_n_c should contain a valid PostScript encoding containing PostScript names like /hyphen. Here is an incomplete exam- ple (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: -a_A_F_M_f_i_l_e Overrules the name that is used to locate the SunOS 5.5 Last change: TeX 1 PS2PK(1) User Commands PS2PK(1) AFM file. -e_e_n_c Name of a file containing an encoding scheme (default - the encoding named in the AFM-file is used). The actual PostScript name of the encod- ing scheme is written as a "special" at the end of the pkfont. -E_e_x_t_e_n_s_i_o_n The extension factor (real value, default 1.0). -m_m_o_d_e_n_a_m_e A modename such as would be used by METAFONT (default "Unknown mode"). -P_p_o_i_n_t_s_i_z_e The desired pointsize (real value, default 10.0 points). -R_b_a_s_e_r_e_s The desired base resolution (integer value, default 300 dpi). If this differs from the value of _x_r_e_s, the appropriate magnification 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 exam- ple, a pkfont with an _x_r_e_s of 329, using the default base resolution of 300, will include the "special" text "mag=magstep(0.5)" at the end of the font. -r_a_s_p_e_c_t_r_a_t_i_o 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 _y_r_e_s but an explicit _y_r_e_s value will take precedence. Argument must be in "" if spaces are left around `/'. -S_s_l_a_n_t The slant (real value, default 0.0). -X_x_r_e_s The resolution in the X direction (integer value, default 300 dpi). -Y_y_r_e_s The resolution in the Y direction (integer value, default the value of _x_r_e_s). If _y_r_e_s SunOS 5.5 Last change: TeX 2 PS2PK(1) User Commands PS2PK(1) differs from _x_r_e_s, a "special" text giving 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 over- ruled with this name. The default name of pkfont is derived from the basename of the type1 font, the pointsize and _x_r_e_s. 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 _p_o_i_n_t_s_i_z_e 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 recom- mendations of the TeX Working Group on the TeX Directory Standard (TWG-TDS): "fontid=_F_o_n_t_N_a_m_e", "codingscheme=_E_n_c_o_d_i_n_g", "fontfacebyte", "mag", "mode=(ps2pk)_m_o_d_e_n_a_m_e", "pixels-per-inch", and "aspect-ratio" if it is other than unity. ACKNOWLEDGEMENT This program uses the type1 hinting and rendering software IBM has donated to the X-consortium. SEE ALSO `METAFONT: The Program', Donald Knuth. `The GFtoPK processor', belonging to the METAFONTware. `Adobe Font Metric Files', Version 3.0, PostScript Developer Support Group. afm2tfm(1) pk2bm(1) SunOS 5.5 Last change: TeX 3 PS2PK(1) User Commands PS2PK(1) VERSION 1.1 (May 1992) AUTHOR Piet Tutelaers rcpt@urc.tue.nl modified for ps2pkm by Pierre A. Mackay mackay@cs.washington.edu SunOS 5.5 Last change: TeX 4