Penguin
Recent Changes
Annotated edit history of gsftopk(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 GSFTOPK
2 !!!GSFTOPK
3 NAME
4 SYNOPSIS
5 ARGUMENTS
6 DESCRIPTION
7 OPTIONS
8 ENVIRONMENT VARIABLES
9 CONFIGURATION
10 BUGS
11 SEE ALSO
12 AUTHOR
13 MODIFICATIONS
14 ----
15 !!NAME
16
17
18 gsftopk - render a ghostscript font in TeX pk format
19 !!SYNOPSIS
20
21
22 __gsftopk__ [[-i ''path''] [[-q] [[-t] [[--debug=''n'']
23 [[--dosnames] [[--interpreter=''path'']
24 [[--mapline=''line''] [[--mapfile=''file''] [[--quiet]
25 [[--test] [[--help] [[--version] ''font dpi''
26 !!ARGUMENTS
27
28
29 ''font''
30
31
32 Name of the font to be created.
33
34
35 ''dpi''
36
37
38 Desired resolution of the font to be created, in dots per
39 inch. This may be a real number.
40 !!DESCRIPTION
41
42
43 __gsftopk__ is a program which calls up the ghostscript
44 program gs(1) to render a given font at a given
45 resolution. It packs the resulting characters into the
46 __pk__ file format and writes them to a file whose name
47 is formed from the font name and the resolution (rounded to
48 the nearest integer). The font may be in any format
49 acceptable to Ghostscript, including .''pfa'',
50 .''pfb'', .''gsf'', and .''ttf''
51 files.
52
53
54 This program should normally be called by a script, such as
55 __mktexpk__, to create fonts on demand.
56
57
58 __gsftopk__ obtains the character widths from the
59 .''tfm'' file, which must exist in the standard search
60 path. It also must be able to find the font in a map file
61 (such as __psfonts.map__), formatted as in
62 dvips(1)), unless the __--mapline__ option is
63 used. The set of map files is given by the __--mapfile__
64 option, or in the files __config.ps__,
65 __$HOME/.dvipsrc__, and __config.gsftopk__ (as would
66 be used by __dvips -Pgsftopk__).
67
68
69 The following __pk__
70 __jobname=__''font''
71 ''mag=1____mode=modeless__
72 __pixels_per_inch=__''dpi''
73 ''
74 !!OPTIONS
75
76
77 __--debug=__''n''
78
79
80 Set the __Kpathsea__ debug flags according to the integer
81 ''n''.
82
83
84 __--dosnames__
85
86
87 Use a name of the form ''font''__.pk__ instead of
88 ''font''__.__''dpi''__pk__.
89
90
91 __-h__, __--help__
92
93
94 Print a brief help synopsis and exit.
95
96
97 __-i__ ''path'',
98 __--interpreter=__''path''
99
100
101 Use ''path'' as the Ghostscript interpreter.
102
103
104 __--mapfile=__''file''
105
106
107 Use ''file'' to look for the map information for
108 ''font''. This should be the full name of the file (in
109 other words, no path searching algorithms are
110 applied).
111
112
113 __--mapline=__''line''
114
115
116 Use ''line'' instead of looking for an entry in a map
117 file. The first word of ''line'' must match
118 ''font''.
119
120
121 __-q__, __--quiet__
122
123
124 Operate quietly; i.e., without writing any messages to the
125 standard output.
126
127
128 __-t__, __--test__
129
130
131 Test run: return zero status if the font can be found in the
132 map file(s), and nonzero status if it cannot. If this option
133 is specified, then the ''dpi'' argument is optional
134 (since the font will not be generated).
135
136
137 __-v__, __--version__
138
139
140 Print the version number and exit.
141 !!ENVIRONMENT VARIABLES
142
143
144 __TFMFONTS__
145
146
147 Colon-separated list of paths to search for the .''tfm''
148 file associated with the font. An extra colon in the list
149 will include the compiled-in default paths at that point. A
150 double slash will enable recursive subdirectory searching at
151 that point in the path.
152
153
154 __DVIPSHEADERS__
155
156
157 Colon-separated list of paths to search for the Ghostscript
2 perry 158 driver file __render.ps__ and for any !PostScript header
1 perry 159 or font files (.''enc'', .''pfa'', .''pfb'',
160 .''gsf'', or .''ttf'' files). Double slashes and extra
161 colons behave as with
162 __TFMFONTS.__
163
164
165 __TEXCONFIG__
166
167
168 Colon-separated list of paths to search for map files.
169 Double slashes and extra colons behave as with
170 __TFMFONTS.__
171
172
173 __DVIPSRC__
174
175
176 Name of file to read instead of __$HOME/.dvipsrc__. This
177 should be the full name of the file (in other words, no path
178 searching algorithms are applied).
179 !!CONFIGURATION
180
181
182 In order to determine the set of map files to be used and
2 perry 183 the path for finding !PostScript files, __gsftopk__ reads,
1 perry 184 in order, the files __config.ps__, __.dvipsrc__, and
185 __config.gsftopk__. The files __config.ps__ and
186 __config.gsftopk__ are searched for using the environment
187 variable __TEXCONFIG,__ the
188 __Kpathsea__ configuration file, or the compiled-in
189 default paths. The file __.dvipsrc__ is searched for in
190 the user's home directory.
191
192
193 These files are in the same format as for __dvips__ (as
194 well as being in the same locations). The entries used by
195 __gsftopk__ are as follows.
196
197
198 H ''path''
199
200
201 Indicates that the Ghostscript driver file __render.ps__
2 perry 202 and the !PostScript header and font files are to be searched
1 perry 203 for using ''path''.
204
205
206 p ''file''
207
208
209 Indicates that the list of map files is to be erased and
210 replaced by ''file''.
211
212
213 p +''file''
214
215
216 Indicates that ''file'' is to be added to the list of map
217 files.
218
219
220 All other entries are ignored.
221
222
223 This is similar to the handling of these options when
224 running __dvips -Pgsftopk__. For more details, see the
225 __Kpathsea__ manual.
226 !!BUGS
227
228
229 __gsftopk__ sometimes has trouble with fonts with very
230 complicated characters (such as the Seal of the University
231 of California). This is because __gsftopk__ uses the
232 __charpath__ operator to determine the bounding box of
233 each character. If the character is too complicated, then
234 old versions of Ghostscript fail, causing __gsftopk__ to
235 terminate with an error message
236
237
238 __Call to gs stopped by signal 10__
239
240
241 (The number may vary from system to system; it corresponds
242 to a bus error or a segmentation fault.) The best way to fix
243 this bug is to install a current version of ghostscript. As
244 an alternative, __gsftopk__ can be instructed to use the
245 bounding box provided with the font (if one exists) instead
246 of finding a bounding box for each character. To do this,
247 include the string
248
249
250 __/usefontbbox true def__
251
252
253 in the font map file; ''e.g.'',
254
255
256 __ucseal __
257
258
259 This will not affect use of the font by
260 __dvips__.
261 !!SEE ALSO
262
263
264 gs(1), gftopk(1), tex(1),
265 xdvi(1), dvips(1)
266 !!AUTHOR
267
268
269 Written by Paul Vojta. This program was inspired by Karl
270 Berry's __gsrenderfont__.
271 !!MODIFICATIONS
272
273
274 Modified by Yves Arrouye to use Karl Berry's __Kpathsea__
275 library.
276 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.