# phpman > man > GSFTOPK(1) [GSFTOPK(1)](https://www.chedong.com/phpMan.php/man/GSFTOPK/1/markdown) General Commands Manual [GSFTOPK(1)](https://www.chedong.com/phpMan.php/man/GSFTOPK/1/markdown) ## NAME gsftopk - render a ghostscript font in TeX pk form ## SYNOPSIS **gsftopk** [-i _path_] [-q] [-t] [--debug=_n_] [--dosnames] [--interpreter=_path_] [--mapline=_line_] [--mapfile=_file_] [--quiet] [--test] [--help] [--version] _font_ _dpi_ ## ARGUMENTS _font_ Name of the font to be created. _dpi_ 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)](https://www.chedong.com/phpMan.php/man/gs/1/markdown) 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). The font may be in any format acceptable to Ghostscript, including ._pfa_, ._pfb_, ._gsf_, and ._ttf_ files. This program should normally be called by a script, such as **mktexpk**, to create fonts on de‐ mand. **gsftopk** obtains the character widths from the ._tfm_ file, which must exist in the standard search path. It also must be able to find the font in a map file (such as **psfonts.map**), for‐ matted as in [**dvips**(1)](https://www.chedong.com/phpMan.php/man/dvips/1/markdown)), unless the **--mapline** option is used. The set of map files is given by the **--mapfile** option, or in the files **config.ps**, **$HOME/.dvipsrc**, and **config.gsftopk** (as would be used by **dvips** **-Pgsftopk**). The following **pk** "specials" are added at the end of the output file, to provide an internal check on the contents of the file: "**jobname=**_font_", "**mag=1**", "**mode=modeless**", and "**pix**‐‐ **els**___**per**___**inch=**_dpi_". This is in accordance with the TeX Directory Standard (TDS). ## OPTIONS **--debug=**_n_ Set the **Kpathsea** debug flags according to the integer _n_. ### --dosnames Use a name of the form _font_**.pk** instead of _font_**.**_dpi_**pk**. ### -h --help Print a brief help synopsis and exit. ### -i --interpreter= Use _path_ as the Ghostscript interpreter. **--mapfile=**_file_ Use _file_ to look for the map information for _font_. This should be the full name of the file (in other words, no path searching algorithms are applied). **--mapline=**_line_ Use _line_ instead of looking for an entry in a map file. The first word of _line_ must match _font_. ### -q --quiet Operate quietly; i.e., without writing any messages to the standard output. ### -t --test Test run: return zero status if the font can be found in the map file(s), and nonzero status if it cannot. If this option is specified, then the _dpi_ argument is optional (since the font will not be generated). ### -v --version Print the version number and exit. ## ENVIRONMENT VARIABLES **DVIPSRC** Name of file to read instead of **$HOME/.dvipsrc**. This should be the full name of the file (in other words, no path searching algorithms are applied). **GSFTOPKFONTS** See **TFMFONTS.** **GSFTOPKHEADERS** See **TEXPSHEADERS.** **PSHEADERS** See **TEXPSHEADERS.** **TEXCONFIG** Colon-separated list of paths to search for map files. An extra colon in the list will include the compiled-in default paths at that point. A double slash will enable recursive subdirectory searching at that point in the path. **TFMFONTS** Colon-separated list of paths to search for the ._tfm_ file associated with the font. Double slashes and extra colons behave as with **TEXCONFIG.** This infor‐ mation may also be supplied by using the environment variables **TFMFONTS** or **GSFTOPKFONTS.** These environment variables are checked in the order **GSFTOPK**‐‐ **FONTS,** **TFMFONTS,** **TFMFONTS;** the first one (if any) having a value is used. **TEXPSHEADERS** Colon-separated list of paths to search for the Ghostscript driver file **ren**‐‐ **der.ps** and for any PostScript header or font files (._enc_, ._pfa_, ._pfb_, ._gsf_, or ._ttf_ files). Double slashes and extra colons behave as with **TEXCONFIG.** This information may also be supplied by using the environment variables **PSHEADERS** or **GSFTOPKHEADERS.** These environment variables are checked in the order **GSFTOPKHEADERS,** **TEXPSHEADERS,** **PSHEADERS;** the first one (if any) having a value is used. **TFMFONTS** See **TFMFONTS.** ## CONFIGURATION In order to determine the set of map files to be used and the path for finding PostScript files, **gsftopk** reads, in order, the files **config.ps**, **.dvipsrc**, and **config.gsftopk**. The files **config.ps** and **config.gsftopk** are searched for using the environment variable **TEXCONFIG,** the **Kpathsea** configuration file, or the compiled-in default paths. The file **.dvipsrc** is searched for in the user's home directory. These files are in the same format as for **dvips** (as well as being in the same locations). The entries used by **gsftopk** are as follows. H _path_ Indicates that the Ghostscript driver file **render.ps** and the PostScript header and font files are to be searched for using _path_. p _file_ Indicates that the list of map files is to be erased and replaced by _file_. p +_file_ Indicates that _file_ is to be added to the list of map files. All other entries are ignored. This is similar to the handling of these options when running **dvips** **-Pgsftopk**. For more de‐ tails, see the **Kpathsea** manual. ## BUGS **gsftopk** sometimes has trouble with fonts with very complicated characters (such as the Seal of the University of California). This is because **gsftopk** uses the **charpath** operator to de‐ termine 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 font map file; _e.g._, **ucseal** **"/usefontbbox** **true** **def"** This will not affect use of the font by **dvips**. ## SEE ALSO [**gs**(1)](https://www.chedong.com/phpMan.php/man/gs/1/markdown), [**gftopk**(1)](https://www.chedong.com/phpMan.php/man/gftopk/1/markdown), [**tex**(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown), [**xdvi**(1)](https://www.chedong.com/phpMan.php/man/xdvi/1/markdown), [**dvips**(1)](https://www.chedong.com/phpMan.php/man/dvips/1/markdown) ## AUTHOR Written by Paul Vojta. This program was inspired by Karl Berry's **gsrenderfont**. ## MODIFICATIONS Modified by Yves Arrouye to use Karl Berry's **Kpathsea** library. 28 November 1998 [GSFTOPK(1)](https://www.chedong.com/phpMan.php/man/GSFTOPK/1/markdown)