GSFTOPK(1) User Commands GSFTOPK(1) NAME gsftopk - render a ghostscript font in TeX pk format SYNOPSIS gsftopk [-q] _f_o_n_t _d_p_i ARGUMENTS _f_o_n_t Name of the font to be created. _d_p_i Desired resolution of the font to be created, in dots per inch. This may be a real number. DESCRIPTION gsftopk is a program which calls up the ghostscript program gs(1) to render a given font at a given resolution. It packs the resulting characters into the pk file format and writes them to a file whose name is formed from the font name and the resolution (rounded to the nearest integer). This program should normally be called by a script, such as MakeTeXPK, to create fonts on demand. gsftopk obtains the character widths from the ._t_f_m file, which must exist in the standard search path. It also must be able to find a file psfonts.map (formatted as in dvips(1)), listing the available fonts. The following pk "specials" are added at the end of the out- put file, to provide an internal check on the contents of the file: " .}S 3 1 "" " "jobname=_f_o_n_t"" "" ","" "" "" " .}S 3 1 "" " "mag=1"" "" ","" "" "" " .}S 3 1 "" " "mode=(gsftopk)Unknown"" "" ","" "" "" " .}S 3 1 "" " "pixels_per_inch=_d_p_i"" "" "."" "" "" This is in accordance with the TeX Directory Standard (TDS). OPTIONS -q Operate quietly; i.e., without writing any messages to the standard output. ENVIRONMENT VARIABLES Xdvik uses the same environment variables and algorithms for finding font files and _p_s_f_o_n_t_s._m_a_p as TeX and friends. See the documentation for the Kpathsea library for details. (Repeating it here is too cumbersome.) KPATHSEA_DEBUG: Trace Kpathsea lookups; set to -1 for com- plete tracing. BUGS gsftopk sometimes has trouble with fonts with very compli- cated characters (such as the Seal of the University of Cal- ifornia). This is because gsftopk uses the charpath SunOS 5.5 Last change: 3 February 1997 1 GSFTOPK(1) User Commands GSFTOPK(1) operator to determine the bounding box of each character. If the character is too complicated, then old versions of ghostscript fail, causing gsftopk to terminate with an error message Call to gs stopped by signal 10 (The number may vary from system to system; it corresponds to a bus error or a segmentation fault.) The best way to fix this bug is to install a current version of ghostscript. As an alternative, gsftopk can be instructed to use the bounding box provided with the font (if one exists) instead of finding a bounding box for each character. To do this, include the string /usefontbbox true def in the psfonts.map file; _e._g., ucseal "/usefontbbox true def" This will not affect use of the font by dvips. SEE ALSO gs(1), gftopk(1), tex(1), xdvi(1), dvips(1) AUTHOR Written by Paul Vojta. This program was inspired by gsren- derfont, which was written by Karl Berry. Modified by Yves Arrouye to use Karl Berry's kpathsea library. SunOS 5.5 Last change: 3 February 1997 2