Penguin
Recent Changes
Annotated edit history of xpdfrc(5) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 xpdfrc
2 !!!xpdfrc
3 NAME
4 DESCRIPTION
5 CHARACTER MAPPING
6 DISPLAY FONTS
7 POSTSCRIPT CONTROL
8 TEXT CONTROL
9 MISCELLANEOUS SETTINGS
10 EXAMPLES
11 FILES
12 AUTHOR
13 SEE ALSO
14 ----
15 !!NAME
16
17
18 xpdfrc - configuration file for Xpdf tools (version 1.00)
19 !!DESCRIPTION
20
21
22 All of the Xpdf tools read a single configuration file. If
23 you have a ''.xpdfrc'' file in your home directory, it
24 will be read. Otherwise, a system-wide configuration file
25 will be read from ''/usr/local/etc/xpdfrc'', if it
26 exists. (This is its default location; depending on build
27 options, it may be placed elsewhere.) On Win32 systems, the
28 ''xpdfrc'' file should be placed in the same directory as
29 the executables.
30
31
32 The xpdfrc file consists of a series of configuration
33 options, one per line. Blank lines and lines starting with a
34 #' (comments) are ignored.
35
36
37 The following sections list all of the configuration
38 options, sorted into functional groups. There is an examples
39 section at the end.
40 !!CHARACTER MAPPING
41
42
43 __nameToUnicode__ ''map-file''
44
45
46 Specifies a file with the mapping from character names to
47 Unicode. This is used to handle PDF fonts that have valid
2 perry 48 encodings but no !ToUnicode entry. Each line of a
1 perry 49 nameToUnicode file looks like this:
50
51
52 ''hex-string name''
53
54
55 The ''hex-string'' is the Unicode (UCS-2) character
56 index, and ''name'' is the corresponding character name.
57 Multiple nameToUnicode files can be used; if a character
58 name is given more than once, the code in the last specified
59 file is used. There is a built-in default nameToUnicode
60 table with all of Adobe's standard character
61 names.
62
63
64 __cidToUnicode__ ''registry-ordering
65 map-file''
66
67
68 Specifies the file with the mapping from character
69 collection to Unicode. Each line of a cidToUnicode file
70 represents one character:
71
72
73 ''hex-string''
74
75
76 The ''hex-string'' is the Unicode (UCS-2) index for that
77 character. The first line maps CID 0, the second line CID 1,
78 etc. File size is determined by size of the character
79 collection. Only one file is allowed per character
80 collection; the last specified file is used. There are no
81 built-in cidToUnicode mappings.
82
83
84 __unicodeMap__ ''encoding-name map-file''
85
86
87 Specifies the file with mapping from Unicode to
88 ''encoding-name''. These encodings are used for X display
89 fonts and text output (see below). Each line of a unicodeMap
90 file represents a range of one or more Unicode characters
91 which maps linearly to a range in the output
92 encoding:
93
94
95 '' in-start-hex in-end-hex out-start-hex
96 ''Entries for single characters can be abbreviated to:
97
98
99 '' in-hex out-hex
2 perry 100 ''The ''in-start-hex'' and ''in-end-hex'' fields (or the single ''in-hex'' field) specify the Unicode range. The ''out-start-hex'' field (or the ''out-hex'' field) specifies the start of the output encoding range. The length of the ''out-start-hex'' (or ''out-hex'') string determines the length of the output characters (e.g., UTF-8 uses different numbers of bytes to represent characters in different ranges). Entries must be given in increasing Unicode order. Only one file is allowed per encoding; the last specified file is used. The ''Latin1'', ''ASCII7'', ''Symbol'', ''!ZapfDingbats'', and ''UTF-8'' encodings are predefined.
1 perry 101
102
103 __cMapDir__ ''registry-ordering dir''
104
105
106 Specifies a search directory, ''dir'', for CMaps for the
107 ''registry-ordering'' character collection. There can be
108 multiple directories for a particular collection. There are
109 no default CMap directories.
110
111
112 __toUnicodeDir__ ''dir''
113
114
2 perry 115 Specifies a search directory, ''dir'', for !ToUnicode
116 CMaps. There can be multiple !ToUnicode directories. There
117 are no default !ToUnicode directories.
1 perry 118 !!DISPLAY FONTS
119
120
121 __displayFontX__ ''PDF-font-name XLFD
122 encoding-name''
123
124
125 Maps a PDF font, ''PDF-font-name'', to an X font,
126 ''XLFD'', for display. The XLFD (X Logical Font
127 Descriptor) should contain the string
128 ''encoding-name''
129 must be defined with the ''unicodeMap'' command (see
130 above). By default, the Base-14 fonts are mapped to standard
131 X fonts, using the ''Latin1'', ''Symbol'', and
2 perry 132 ''!ZapfDingbats'' encodings.
1 perry 133
134
135 __displayFontT1__ ''PDF-font-name
136 T1-file''
137
138
139 Maps a PDF font, ''PDF-font-name'', to a Type 1 font for
140 display. The Type 1 font file, ''T1-file'', should be a
141 standard .pfa or .pfb file.
142
143
144 __displayFontTT__ ''PDF-font-name
145 TT-file''
146
147
2 perry 148 Maps a PDF font, ''PDF-font-name'', to a !TrueType font
149 for display. The !TrueType font file, ''TT-file'', should
1 perry 150 be a standard .ttf file.
151
152
153 __displayCIDFontX__ ''registry-ordering XLFD
154 encoding-name''
155
156
157 Maps the ''registry-ordering'' character collection to
158 the X font, ''XLFD'', for display. The encoding given by
159 ''encoding-name'' must be defined with the unicodeMap
160 command. There are no default display CID font
161 mappings.
162
163
164 __fontDir__ ''dir''
165
166
167 Specifies a search directory for external font files. There
168 can be multiple fontDir directories. If a PDF file uses a
169 font but doesn't embed it, these directories will be
170 searched for a matching font file. These fonts are used by
171 both xpdf (for display) and pdftops (for embedding in the
2 perry 172 generated !PostScript). Only files with suffixes of
1 perry 173 !!POSTSCRIPT CONTROL
174
175
176 __psPaperSize__ ''width(pts)
177 height(pts)''
178
179
2 perry 180 Sets the paper size for !PostScript output. The ''width''
1 perry 181 and ''height'' parameters give the paper size in
2 perry 182 !PostScript points.
1 perry 183
184
185 __psPaperSize__ letter | legal | A4 | A3
186
187
2 perry 188 Sets the paper size for !PostScript output to a standard
1 perry 189 size. The default paper size is set when xpdf and pdftops
190 are built, typically to
191
192
193 __psDuplex__ yes | no
194
195
196 If set to
197
198
199 __psLevel__ level1 | level1sep | level2 |
200 level2sep
201
202
2 perry 203 Sets the !PostScript level to generate. This defaults to
1 perry 204
205
206 __psFont__ ''PDF-font-name PS-font-name''
207
208
209 When the ''PDF-font-name'' font is used in a PDF file, it
2 perry 210 will be translated to the !PostScript font
1 perry 211 ''PS-font-name'', which is assumed to be resident in the
212 printer. Typically, ''PDF-font-name'' and
213 ''PS-font-name'' are the same. By default, only the
214 Base-14 fonts are assumed to be resident.
215
216
217 __psEmbedType1Fonts__ yes | no
218
219
220 If set to
221
222
223 __psEmbedTrueTypeFonts__ yes | no
224
225
226 If set to
227
228
229 __psOPI__ yes | no
230
231
232 If set to
233
234
235 __psFile__ ''file-or-command''
236
237
2 perry 238 Sets the default !PostScript file or print command for xpdf.
1 perry 239 Commands start with a |' character; anything else is a file.
240 If the file name or command contains spaces it must be
241 quoted. This defaults to unset, which tells xpdf to generate
242 a name of the form
243
244
245 __fontDir__ ''dir''
246
247
248 See the description above, in the DISPLAY FONTS
249 section.
250 !!TEXT CONTROL
251
252
253 __textEncoding__ ''encoding-name''
254
255
256 Sets the encoding to use for text output. (This can be
257 overridden with the
258 encoding-name'' must be defined with the
259 unicodeMap command (see above). This defaults to
260 ''
261
262
263 __textEOL__ unix | dos | mac
264
265
266 Sets the end-of-line convention to use for text output. The
267 options are:
268
269
270 unix = LF
271 dos = CR+LF
272 mac = CR
273 (This can be overridden with the
274 !!MISCELLANEOUS SETTINGS
275
276
277 __t1libControl__ none | plain | low | high
278
279
280 Sets the type of font rendering for t1lib (the Type 1
281 rasterizer) to use. Options are
282
283
284 __freetypeControl__ none | plain | low |
285 high
286
287
2 perry 288 Sets the type of font rendering for !FreeType (the !TrueType
1 perry 289 rasterizer) to use. Options are
290
291
292 __urlCommand__ ''command''
293
294
295 Sets the command executed when you click on a URL link. The
296 string
297
298
299 __mapNumericCharNames__ ''yes | no''
300
301
302 If set to
303
304
305 __errQuiet__ ''yes | no''
306
307
308 If set to
309 !!EXAMPLES
310
311
312 The following is a sample xpdfrc file.
313
314
315 # from the Thai support package
316 nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
317 # from the Japanese support package
318 cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
319 unicodeMap JISX0208 /usr/local/share/xpdf/JISX0208.unicodeMap
320 cMapDir Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
321 # use an X server font for Times-Roman
322 # (this is the built-in default)
323 displayFontX Times-Roman
324 !!FILES
325
326
327 __/usr/local/etc/xpdfrc__
328
329
330 This is the default location for the system-wide
331 configuration file. Depending on build options, it may be
332 placed elsewhere.
333
334
335 __$HOME/.xpdfrc__
336
337
338 This is the user's configuration file. If it exists, it will
339 be read in place of the system-wide file.
340 !!AUTHOR
341
342
343 The Xpdf software and documentation are copyright 1996-2002
344 Derek B. Noonburg (derekn@foolabs.com).
345 !!SEE ALSO
346
347
348 xpdf(1), pdftops(1), pdftotext(1),
349 pdfinfo(1), pdftopbm(1),
350 pdfimages(1)__
351 http://www.foolabs.com/xpdf/__
352 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.