| 1 |
This is epspdf.info, produced by makeinfo version 7.1 from epspdf.texi. |
| 2 |
|
| 3 |
This manual is for epspdf and epspdftk, version 0.6.5.2. |
| 4 |
|
| 5 |
Copyright © 2006-2025 Siep Kroonenberg. |
| 6 |
|
| 7 |
Copying and distribution of this file, with or without |
| 8 |
modification, are permitted in any medium without royalty provided |
| 9 |
the copyright notice and this notice are preserved. This file is |
| 10 |
offered as-is, without any warranty. |
| 11 |
INFO-DIR-SECTION TeX |
| 12 |
START-INFO-DIR-ENTRY |
| 13 |
* EpsPDF: (epspdf). Portable GUI- and command-line EPS/PS/PDF conversion |
| 14 |
END-INFO-DIR-ENTRY |
| 15 |
|
| 16 |
|
| 17 |
File: epspdf.info, Node: Top, Next: Usage, Prev: (dir), Up: (dir) |
| 18 |
|
| 19 |
Epspdf and epspdftk |
| 20 |
******************* |
| 21 |
|
| 22 |
This manual is for epspdf and epspdftk, version 0.6.5.2. |
| 23 |
|
| 24 |
Copyright © 2006-2025 Siep Kroonenberg. |
| 25 |
|
| 26 |
Copying and distribution of this file, with or without |
| 27 |
modification, are permitted in any medium without royalty provided |
| 28 |
the copyright notice and this notice are preserved. This file is |
| 29 |
offered as-is, without any warranty. |
| 30 |
|
| 31 |
* Menu: |
| 32 |
|
| 33 |
* Usage:: |
| 34 |
* Command-line usage:: |
| 35 |
* Notes on PostScript and pdf:: |
| 36 |
* Bitmapped graphics for LaTeX and pdflatex:: |
| 37 |
* Troubleshooting:: |
| 38 |
* Requirements:: |
| 39 |
* Change history:: |
| 40 |
|
| 41 |
-- The Detailed Node Listing -- |
| 42 |
|
| 43 |
Usage |
| 44 |
|
| 45 |
* Overview:: |
| 46 |
* Viewing:: |
| 47 |
* Conversion options:: |
| 48 |
* Converting:: |
| 49 |
* The configuration screen:: |
| 50 |
|
| 51 |
Command-line usage |
| 52 |
|
| 53 |
* Option summary:: |
| 54 |
|
| 55 |
Notes on PostScript and pdf |
| 56 |
|
| 57 |
* Bitmapped and vector:: |
| 58 |
* Font embedding:: |
| 59 |
* Eps preview headers:: |
| 60 |
* Bounding- and other boxes:: |
| 61 |
* Orientation:: |
| 62 |
* Exporting PostScript or pdf from Windows programs:: |
| 63 |
|
| 64 |
Bitmapped graphics for LaTeX and pdflatex |
| 65 |
|
| 66 |
* Linux:: |
| 67 |
* Mac OS:: |
| 68 |
* Windows:: |
| 69 |
|
| 70 |
Troubleshooting |
| 71 |
|
| 72 |
* No options for output format visible:: |
| 73 |
* Ghostscript stackunderflow error:: |
| 74 |
* Error message ``pdf_crop failed'':: |
| 75 |
* Wrong boundingbox (.eps or .ps output):: |
| 76 |
* Part of the graphic gets cut off:: |
| 77 |
* Fonts look ugly:: |
| 78 |
* The page has been converted to a bitmap:: |
| 79 |
* Temporary files are not removed:: |
| 80 |
* Resources for troubleshooting:: |
| 81 |
|
| 82 |
Change history |
| 83 |
|
| 84 |
* Version 0.6.5.2:: |
| 85 |
* Version 0.6.5.1:: |
| 86 |
* Version 0.6.5:: |
| 87 |
* Version 0.6.4:: |
| 88 |
* Version 0.6:: |
| 89 |
* Version 0.5:: |
| 90 |
* Version 0.4:: |
| 91 |
|
| 92 |
|
| 93 |
|
| 94 |
File: epspdf.info, Node: Usage, Next: Command-line usage, Prev: Top, Up: Top |
| 95 |
|
| 96 |
1 Usage |
| 97 |
******* |
| 98 |
|
| 99 |
* Menu: |
| 100 |
|
| 101 |
* Overview:: |
| 102 |
* Viewing:: |
| 103 |
* Conversion options:: |
| 104 |
* Converting:: |
| 105 |
* The configuration screen:: |
| 106 |
|
| 107 |
|
| 108 |
File: epspdf.info, Node: Overview, Next: Viewing, Prev: Usage, Up: Usage |
| 109 |
|
| 110 |
1.1 Overview |
| 111 |
============ |
| 112 |
|
| 113 |
Epspdftk is a GUI program that converts files between eps, pdf and |
| 114 |
general PostScript in any direction. |
| 115 |
|
| 116 |
It lets you interactively select a file, set conversion options, and |
| 117 |
save in the same of another format. A configuration screen offers some |
| 118 |
additional conversion options. |
| 119 |
|
| 120 |
|
| 121 |
File: epspdf.info, Node: Viewing, Next: Conversion options, Prev: Overview, Up: Usage |
| 122 |
|
| 123 |
1.2 Viewing |
| 124 |
=========== |
| 125 |
|
| 126 |
The View button at the bottom of the screen invokes an external viewer. |
| 127 |
|
| 128 |
Windows and Mac OS: Epspdftk simply tries to use the default Open |
| 129 |
command. |
| 130 |
|
| 131 |
Under Linux the PostScript- and pdf viewers are configurable; see *note |
| 132 |
The configuration screen::. |
| 133 |
|
| 134 |
The View button is grayed if epspdf thinks that there is no previewer |
| 135 |
for the current file. |
| 136 |
|
| 137 |
|
| 138 |
File: epspdf.info, Node: Conversion options, Next: Converting, Prev: Viewing, Up: Usage |
| 139 |
|
| 140 |
1.3 Conversion options |
| 141 |
====================== |
| 142 |
|
| 143 |
• Grayscaling |
| 144 |
|
| 145 |
• Compute tight boundingbox. This option is only available if a |
| 146 |
single page is converted. |
| 147 |
|
| 148 |
• Page selection. The only possibilities are selecting a single page |
| 149 |
or selecting all pages. Converting to eps implies selecting a |
| 150 |
single page. |
| 151 |
|
| 152 |
Note. For general PostScript files, there is no quick way to determine |
| 153 |
the number of pages, so the program may not check beforehand whether you |
| 154 |
picked an existing page. If you don't like that, convert the entire |
| 155 |
document to pdf first - which will be done behind the scenes anyway. |
| 156 |
|
| 157 |
Specifying options such as grayscaling or page selection may require a |
| 158 |
multistep conversion. |
| 159 |
|
| 160 |
|
| 161 |
File: epspdf.info, Node: Converting, Next: The configuration screen, Prev: Conversion options, Up: Usage |
| 162 |
|
| 163 |
1.4 Converting |
| 164 |
============== |
| 165 |
|
| 166 |
The Convert and save... button calls up a file save dialog. After a |
| 167 |
successful conversion, the result becomes the new current file, so you |
| 168 |
can judge the result by pressing the View button again - if epspdftk |
| 169 |
thinks that there is a suitable viewer. |
| 170 |
|
| 171 |
|
| 172 |
File: epspdf.info, Node: The configuration screen, Prev: Converting, Up: Usage |
| 173 |
|
| 174 |
1.5 The configuration screen |
| 175 |
============================ |
| 176 |
|
| 177 |
Epspdftk also has a configuration screen. The settings here are |
| 178 |
preserved between sessions. |
| 179 |
|
| 180 |
1.5.1 Configuring viewers |
| 181 |
------------------------- |
| 182 |
|
| 183 |
Under Unix, the preferred PostScript- and pdf viewers can be configured |
| 184 |
in this screen. Epspdf looks for a number of PostScript- and pdf |
| 185 |
viewers, from which you can select one, but you can also enter one |
| 186 |
manually. |
| 187 |
|
| 188 |
Some viewers require a plugin for eps and PostScript. The GUI does not |
| 189 |
check whether such a plugin is actually installed. |
| 190 |
|
| 191 |
For Windows and Mac OS there is no such configuration option. Epspdf |
| 192 |
will use the program associated with the file type, which can be |
| 193 |
configured outside of epspdf. |
| 194 |
|
| 195 |
1.5.2 Options for converting to pdf |
| 196 |
----------------------------------- |
| 197 |
|
| 198 |
Double-check the setting "Target use" under "Conversion to pdf". |
| 199 |
"prepress" is for pdfs which are going to be printed commercially. The |
| 200 |
options prepress, printer and default will try to embed all fonts. |
| 201 |
Often, printshops insist on this. |
| 202 |
|
| 203 |
On the other hand, you may prefer "screen" if file size is a concern. |
| 204 |
See also the Ghostscript documentation, in particular Use.htm and |
| 205 |
VectorDevices.htm. |
| 206 |
|
| 207 |
Specifying anything other than "default" may cause an additional |
| 208 |
conversion step and possibly also loss of high-level structure. |
| 209 |
|
| 210 |
As to pdf versions: this is a trade-off between more features for higher |
| 211 |
versions and better compatibility for lower versions. Versions below |
| 212 |
1.4 do not support transparency. Converting a page or graphic with |
| 213 |
transparencies to version 1.3 will probably result in the whole page or |
| 214 |
graphic getting rasterized. For prepress use, consult your printshop or |
| 215 |
publisher. Otherwise leave the pdf version at "default". |
| 216 |
|
| 217 |
1.5.3 Options for converting to PostScript |
| 218 |
------------------------------------------ |
| 219 |
|
| 220 |
For conversion to plain or Encapsulated PostScript, pdftops sometimes |
| 221 |
does a better job of preserving fonts than Ghostscript. Under Windows, |
| 222 |
current versions of both MiKTeX and TeX Live include pdftops. Still, |
| 223 |
you may opt not to use pdftops even if it is available, in which case |
| 224 |
Ghostscript will be used instead. |
| 225 |
|
| 226 |
|
| 227 |
File: epspdf.info, Node: Command-line usage, Next: Notes on PostScript and pdf, Prev: Usage, Up: Top |
| 228 |
|
| 229 |
2 Command-line usage |
| 230 |
******************** |
| 231 |
|
| 232 |
epspdf.tlu is the backend of epspdftk, but it can also be used |
| 233 |
standalone. It shares configuration settings with epspdftk.tcl. |
| 234 |
|
| 235 |
The first parameter of the epspdftk GUI program is interpreted as |
| 236 |
startup directory for the file browser. Epspdf itself has a more |
| 237 |
elaborate command-line interface. |
| 238 |
|
| 239 |
Below, we assume that there is a suitable wrapper or symlink for epspdf |
| 240 |
on your searchpath. This is the case if you installed epspdf as a TeX |
| 241 |
Live- or MiKTeX package. |
| 242 |
|
| 243 |
Basic usage of epspdf itself: |
| 244 |
|
| 245 |
epspdf [OPTIONS] INFILE [OUTFILE] |
| 246 |
|
| 247 |
* Menu: |
| 248 |
|
| 249 |
* Option summary:: |
| 250 |
|
| 251 |
|
| 252 |
File: epspdf.info, Node: Option summary, Prev: Command-line usage, Up: Command-line usage |
| 253 |
|
| 254 |
2.1 Option summary |
| 255 |
================== |
| 256 |
|
| 257 |
Typing ‘epspdf --help’ gives you the following summary: |
| 258 |
$ epspdf --help |
| 259 |
Epspdf version 0.6.5.1 |
| 260 |
Copyright (c) 2006-2023 Siep Kroonenberg |
| 261 |
|
| 262 |
Convert between [e]ps and pdf formats |
| 263 |
Usage: epspdf[.tlu] [options] infile [outfile] |
| 264 |
Default for outfile is file.pdf if infile is file.eps or file.ps |
| 265 |
Default for outfile is file.eps if infile is file.pdf |
| 266 |
|
| 267 |
-p, --page, --pagenumber PNUM |
| 268 |
Page number; must be a positive integer |
| 269 |
-g, --grey, --gray, -G, --GREY, --GRAY |
| 270 |
Convert to grayscale |
| 271 |
-b, --bbox, --BoundingBox |
| 272 |
Compute tight boundingbox |
| 273 |
-T, --target TARGET |
| 274 |
One of screen, ebook, printer, prepress or default |
| 275 |
-N, --pdfversion VERSION |
| 276 |
One of 1.2, 1.3, 1.4, 1.5, 1.6, 1.7 or default |
| 277 |
-U Use pdftops if available |
| 278 |
-I Reverses the above |
| 279 |
-s, --save Save some settings to configuration file |
| 280 |
-i, --info Info: display detected filetype and exit |
| 281 |
-d Debug: do not remove temp files |
| 282 |
-v, --version |
| 283 |
Display version info and exit |
| 284 |
-h, --help Display this help message and exit |
| 285 |
|
| 286 |
|
| 287 |
File: epspdf.info, Node: Notes on PostScript and pdf, Next: Bitmapped graphics for LaTeX and pdflatex, Prev: Command-line usage, Up: Top |
| 288 |
|
| 289 |
3 Notes on PostScript and pdf |
| 290 |
***************************** |
| 291 |
|
| 292 |
* Menu: |
| 293 |
|
| 294 |
* Bitmapped and vector:: |
| 295 |
* Font embedding:: |
| 296 |
* Eps preview headers:: |
| 297 |
* Bounding- and other boxes:: |
| 298 |
* Orientation:: |
| 299 |
* Exporting PostScript or pdf from Windows programs:: |
| 300 |
|
| 301 |
|
| 302 |
File: epspdf.info, Node: Bitmapped and vector, Next: Font embedding, Prev: Notes on PostScript and pdf, Up: Notes on PostScript and pdf |
| 303 |
|
| 304 |
3.1 Bitmapped and vector |
| 305 |
======================== |
| 306 |
|
| 307 |
Pictures can be described either in terms of pixels, or more abstractly, |
| 308 |
in terms of geometric shapes, fonts and text. |
| 309 |
|
| 310 |
Bitmapped or pixel-based graphics are appropriate for photographs and |
| 311 |
screenshots, but less so for diagrams and spreadsheet-generated |
| 312 |
graphics. |
| 313 |
|
| 314 |
A file in PostScript- or pdf format can contain both types of graphic |
| 315 |
data. |
| 316 |
|
| 317 |
Vector graphics can be freely scaled without losing sharpness or |
| 318 |
becoming pixellated. If bitmapped graphics are enlarged too much, |
| 319 |
individual pixels become apparent. With low-resolution bitmaps this |
| 320 |
happens sooner than with high-resolution bitmaps, but high-resolution |
| 321 |
bitmaps have (much) larger file sizes, and take longer to process. |
| 322 |
|
| 323 |
So avoid converting vector to bitmap. However, converting from bitmap |
| 324 |
to vector is also best avoided, since it is very hard to do well. |
| 325 |
|
| 326 |
Epspdf usually avoids conversion from vector to bitmap and never |
| 327 |
converts the other way. With the screen- and ebook "Target use" option, |
| 328 |
included bitmaps tend to be downsampled, i.e. reduced to a lower |
| 329 |
resolution. |
| 330 |
|
| 331 |
|
| 332 |
File: epspdf.info, Node: Font embedding, Next: Eps preview headers, Prev: Bitmapped and vector, Up: Notes on PostScript and pdf |
| 333 |
|
| 334 |
3.2 Font embedding |
| 335 |
================== |
| 336 |
|
| 337 |
When converting to pdf, Ghostscript handles font embedding differently |
| 338 |
depending on the "Target use" option. According to the Ghostscript |
| 339 |
documentation, it embeds all fonts without exception for all targets |
| 340 |
except "screen", for which standard fonts such as Times may be omitted. |
| 341 |
|
| 342 |
|
| 343 |
File: epspdf.info, Node: Eps preview headers, Next: Bounding- and other boxes, Prev: Font embedding, Up: Notes on PostScript and pdf |
| 344 |
|
| 345 |
3.3 Eps preview headers |
| 346 |
======================= |
| 347 |
|
| 348 |
Preview headers are quietly stripped from eps files. These preview |
| 349 |
headers are used by e.g. desktop-publishing software to represent eps |
| 350 |
files on screen without having to interpret the PostScript code itself. |
| 351 |
Epspdf has no option to preserve or add them. |
| 352 |
|
| 353 |
|
| 354 |
File: epspdf.info, Node: Bounding- and other boxes, Next: Orientation, Prev: Eps preview headers, Up: Notes on PostScript and pdf |
| 355 |
|
| 356 |
3.4 Bounding- and other boxes |
| 357 |
============================= |
| 358 |
|
| 359 |
A PostScript file may have a page size and a boundingbox defined. A pdf |
| 360 |
file may have a mediabox, a trimbox and various other boxes. |
| 361 |
Ghostscript by itself normally converts the PostScript page - which is |
| 362 |
anchored at (0,0) - to the pdf mediabox. |
| 363 |
|
| 364 |
Conversion to pdf usually translates the bottom-left corner to the (0,0) |
| 365 |
origin and sets the ...box to the size of the graphic. Anything outside |
| 366 |
the ...box should be cut off. |
| 367 |
|
| 368 |
|
| 369 |
File: epspdf.info, Node: Orientation, Next: Exporting PostScript or pdf from Windows programs, Prev: Bounding- and other boxes, Up: Notes on PostScript and pdf |
| 370 |
|
| 371 |
3.5 Orientation |
| 372 |
=============== |
| 373 |
|
| 374 |
Ghostscript may not be able to determine the right orientation of a |
| 375 |
PostScript- or pdf file. This may result in part of a graphic being cut |
| 376 |
off after conversion or even everything falling outside the page / |
| 377 |
mediabox / boundingbox. |
| 378 |
|
| 379 |
|
| 380 |
File: epspdf.info, Node: Exporting PostScript or pdf from Windows programs, Prev: Orientation, Up: Notes on PostScript and pdf |
| 381 |
|
| 382 |
3.6 Exporting PostScript or pdf from Windows programs |
| 383 |
===================================================== |
| 384 |
|
| 385 |
Microsoft Office 2010 can now export to pdf, either the entire document |
| 386 |
or a selection. This removes a major headache for Windows users. |
| 387 |
Windows 10 also includes a pdf printer. |
| 388 |
|
| 389 |
As a last resort on earlier Windows versions, you can "print" to a |
| 390 |
PostScript file. From some programs, you can print a selection. A |
| 391 |
suitable driver which comes with Windows is Generic / MS Publisher Color |
| 392 |
Printer. Pay attention to the printer properties: choose "Outline" for |
| 393 |
font downloading and avoid the "Optimize for speed" setting for |
| 394 |
PostScript Output Option. In my tests, "Encapsulated PostScript" did |
| 395 |
not look very promising either. Try e.g. "Archive" instead. These |
| 396 |
options can be found under the Advanced button. |
| 397 |
|
| 398 |
|
| 399 |
File: epspdf.info, Node: Bitmapped graphics for LaTeX and pdflatex, Next: Troubleshooting, Prev: Notes on PostScript and pdf, Up: Top |
| 400 |
|
| 401 |
4 Bitmapped graphics for LaTeX and pdflatex |
| 402 |
******************************************* |
| 403 |
|
| 404 |
pdflatex can use graphics in .png format (best for screenshots) and .jpg |
| 405 |
format (best for photographs) directly. However, for LaTeX you are |
| 406 |
stuck with .eps format. Tips for converting to .eps: |
| 407 |
|
| 408 |
* Menu: |
| 409 |
|
| 410 |
* Linux:: |
| 411 |
* Mac OS:: |
| 412 |
* Windows:: |
| 413 |
|
| 414 |
|
| 415 |
File: epspdf.info, Node: Linux, Next: Mac OS, Prev: Bitmapped graphics for LaTeX and pdflatex, Up: Bitmapped graphics for LaTeX and pdflatex |
| 416 |
|
| 417 |
4.1 Linux |
| 418 |
========= |
| 419 |
|
| 420 |
_sam2p_ |
| 421 |
This command-line bitmap-to-PostScript/pdf conversion utility is |
| 422 |
available from <http://code.google.com/p/sam2p/> and may already be |
| 423 |
packaged for your distribution. It produces very small files: |
| 424 |
‘sam2p image.png image.eps’ |
| 425 |
_ImageMagick/convert_ |
| 426 |
‘convert’ from the ImageMagick package is a command-line utility: |
| 427 |
‘convert image.png image.eps’ |
| 428 |
_The GIMP_ |
| 429 |
This is the premier open source image editing program. It is often |
| 430 |
pre-installed on Linux, and is also available for other platforms. |
| 431 |
The GIMP can save in eps- and pdf format. |
| 432 |
|
| 433 |
|
| 434 |
File: epspdf.info, Node: Mac OS, Next: Windows, Prev: Linux, Up: Bitmapped graphics for LaTeX and pdflatex |
| 435 |
|
| 436 |
4.2 Mac OS |
| 437 |
========== |
| 438 |
|
| 439 |
Mac OS's built-in Preview application can read most bitmapped formats |
| 440 |
and save them as pdf or PostScript. In fact, in many cases it is an |
| 441 |
excellent alternative to epspdf. |
| 442 |
|
| 443 |
|
| 444 |
File: epspdf.info, Node: Windows, Prev: Mac OS, Up: Bitmapped graphics for LaTeX and pdflatex |
| 445 |
|
| 446 |
4.3 Windows |
| 447 |
=========== |
| 448 |
|
| 449 |
I know of no built-in facility for converting bitmaps to eps or pdf, |
| 450 |
apart from "printing" to PostScript or pdf. However, many image editors |
| 451 |
can convert to eps or pdf. A couple of command-line utilities: |
| 452 |
sam2p image.png image.eps |
| 453 |
or |
| 454 |
bmeps -c image.png image.eps |
| 455 |
sam2p is distributed with TeX Live (Windows only), bmeps both with TeX |
| 456 |
Live and with MikTeX. Without the ‘-c’ option, bmeps produces a |
| 457 |
grayscale image. It produces larger files than sam2p. |
| 458 |
|
| 459 |
With TeX Live, you can convert to eps by right-clicking an image in |
| 460 |
Windows Explorer and "open" with _bitmap2eps_, which uses sam2p or bmeps |
| 461 |
in the background. |
| 462 |
|
| 463 |
|
| 464 |
File: epspdf.info, Node: Troubleshooting, Next: Requirements, Prev: Bitmapped graphics for LaTeX and pdflatex, Up: Top |
| 465 |
|
| 466 |
5 Troubleshooting |
| 467 |
***************** |
| 468 |
|
| 469 |
* Menu: |
| 470 |
|
| 471 |
* No options for output format visible:: |
| 472 |
* Ghostscript stackunderflow error:: |
| 473 |
* Error message ``pdf_crop failed'':: |
| 474 |
* Wrong boundingbox (.eps or .ps output):: |
| 475 |
* Part of the graphic gets cut off:: |
| 476 |
* Fonts look ugly:: |
| 477 |
* The page has been converted to a bitmap:: |
| 478 |
* Temporary files are not removed:: |
| 479 |
* Resources for troubleshooting:: |
| 480 |
|
| 481 |
|
| 482 |
File: epspdf.info, Node: No options for output format visible, Next: Ghostscript stackunderflow error, Prev: Troubleshooting, Up: Troubleshooting |
| 483 |
|
| 484 |
5.1 No options for output format visible |
| 485 |
======================================== |
| 486 |
|
| 487 |
Widen the window, to make the output format radio buttons visible. |
| 488 |
|
| 489 |
|
| 490 |
File: epspdf.info, Node: Ghostscript stackunderflow error, Next: Error message ``pdf_crop failed'', Prev: No options for output format visible, Up: Troubleshooting |
| 491 |
|
| 492 |
5.2 Ghostscript stackunderflow error |
| 493 |
==================================== |
| 494 |
|
| 495 |
Some Ghostscript versions, _e.g._ 9.10, have an error in color handling |
| 496 |
when converting to pdf: selecting "printer" as target may lead to an |
| 497 |
error ‘stackunderflow in .setdistillerparams’. If you run into this, |
| 498 |
use the "default" or "prepress" target instead. |
| 499 |
|
| 500 |
|
| 501 |
File: epspdf.info, Node: Error message ``pdf_crop failed'', Next: Wrong boundingbox (.eps or .ps output), Prev: Ghostscript stackunderflow error, Up: Troubleshooting |
| 502 |
|
| 503 |
5.3 Error message mentioning failure of pdf_crop |
| 504 |
================================================ |
| 505 |
|
| 506 |
Problably, the luatex format has not been generated. Fix this with TeX |
| 507 |
Live Manager or with the MiKTeX Console. |
| 508 |
|
| 509 |
|
| 510 |
File: epspdf.info, Node: Wrong boundingbox (.eps or .ps output), Next: Part of the graphic gets cut off, Prev: Error message ``pdf_crop failed'', Up: Troubleshooting |
| 511 |
|
| 512 |
5.4 Wrong boundingbox (.eps or .ps output) |
| 513 |
========================================== |
| 514 |
|
| 515 |
This may be a bug in pdftops. Do not use pdftops (epspdftk: see |
| 516 |
configuration screen; command-line epspdf: use the "-I" option) |
| 517 |
|
| 518 |
|
| 519 |
File: epspdf.info, Node: Part of the graphic gets cut off, Next: Fonts look ugly, Prev: Wrong boundingbox (.eps or .ps output), Up: Troubleshooting |
| 520 |
|
| 521 |
5.5 Part of the graphic gets cut off |
| 522 |
==================================== |
| 523 |
|
| 524 |
If the PostScript file was generated with the old Windows PostScript |
| 525 |
driver, experiment with the PostScript Output option. Don't choose |
| 526 |
Optimize for Speed. |
| 527 |
|
| 528 |
|
| 529 |
File: epspdf.info, Node: Fonts look ugly, Next: The page has been converted to a bitmap, Prev: Part of the graphic gets cut off, Up: Troubleshooting |
| 530 |
|
| 531 |
5.6 Fonts look ugly |
| 532 |
=================== |
| 533 |
|
| 534 |
If Ghostscript has to do the conversion from pdf to ps then text may not |
| 535 |
remain text, but may be replaced by bitmaps. Newer Ghostscript versions |
| 536 |
tend to do better in this respect than older ones, but as to preserving |
| 537 |
fonts, the pdftops utility may still handle more cases. It is part of |
| 538 |
the xpdf suite and of the Poppler utilities. |
| 539 |
|
| 540 |
|
| 541 |
File: epspdf.info, Node: The page has been converted to a bitmap, Next: Temporary files are not removed, Prev: Fonts look ugly, Up: Troubleshooting |
| 542 |
|
| 543 |
5.7 The page has been converted to a bitmap |
| 544 |
=========================================== |
| 545 |
|
| 546 |
The usual cause is that the page contains features such as transparency |
| 547 |
which are not supported by the target format. |
| 548 |
|
| 549 |
Otherwise, set pdf target use and target version both to "default" to |
| 550 |
avoid unnecessary conversions: ‘-T default -N default’ |
| 551 |
|
| 552 |
|
| 553 |
File: epspdf.info, Node: Temporary files are not removed, Next: Resources for troubleshooting, Prev: The page has been converted to a bitmap, Up: Troubleshooting |
| 554 |
|
| 555 |
5.8 Temporary files are not removed |
| 556 |
=================================== |
| 557 |
|
| 558 |
• Command-line: make sure that you did not specify the option ‘-d’. |
| 559 |
• Epspdftk GUI: make sure that 'Remove temp files' is checked. |
| 560 |
• Windows: this platform is notorious for excessive file locking. I |
| 561 |
already inserted a Windows-specific delay before attempting to |
| 562 |
delete the temporary files, but this is not always enough. |
| 563 |
However, you should have no trouble removing temporary files |
| 564 |
manually. |
| 565 |
|
| 566 |
|
| 567 |
File: epspdf.info, Node: Resources for troubleshooting, Prev: Temporary files are not removed, Up: Troubleshooting |
| 568 |
|
| 569 |
5.9 Resources for troubleshooting |
| 570 |
================================= |
| 571 |
|
| 572 |
Logfile. The GUI has a button for viewing log output. This same output |
| 573 |
is also written to a file ‘epspdf.log’. For Linux/Unix/Mac Mac OS this |
| 574 |
is in a subdirectory .epspdf of your home directory; for Windows it is |
| 575 |
in a subdirectory epspdf of ‘%APPDATA%’. This APPDATA directory may be |
| 576 |
‘c:\Users\YOUR USER NAME\AppData\Roaming’. Type |
| 577 |
echo %APPDATA% |
| 578 |
in a Command Prompt window to find out which. |
| 579 |
|
| 580 |
The logfile lists all epspdf calls and all Ghostscript- and pdftops |
| 581 |
calls plus error information. |
| 582 |
|
| 583 |
Temporary files. The temporary files may give clues as well. Uncheck |
| 584 |
the button "Remove temp files", or for the command-line version, give a |
| 585 |
-d parameter to keep the temporary files. Check the log(file) as to |
| 586 |
which temporary files have been created. |
| 587 |
|
| 588 |
Ghostscript- and pdftops documentation. For Ghostscript, the most |
| 589 |
important files are VectorDevices.htm and Use.htm. For pdftops, type |
| 590 |
‘pdftops -h’. For Unix, there is also a man page, and for Windows there |
| 591 |
is a file pdftops.txt in the distribution zip. TeX Live includes the |
| 592 |
man page in pdf format: pdftops.pdf. |
| 593 |
|
| 594 |
|
| 595 |
File: epspdf.info, Node: Requirements, Next: Change history, Prev: Troubleshooting, Up: Top |
| 596 |
|
| 597 |
Appendix A Requirements |
| 598 |
*********************** |
| 599 |
|
| 600 |
Epspdftk consists of a GUI front end and a command-line back end. |
| 601 |
|
| 602 |
The command-line component, which can be used separately from the front |
| 603 |
end, requires ghostscript and a not too old TeX installation with |
| 604 |
luatex. It may further benefit from the presence of pdftops. MiKTeX |
| 605 |
and TeX Live for Windows meet these requirements out of the box. |
| 606 |
|
| 607 |
The front end requires a Tcl/Tk installation, or at least a tclkit |
| 608 |
runtime. TeX Live for Windows contains either a tclkit runtime or a |
| 609 |
minimal Tcl/Tk installation since late 2018, and epspdftk as a TeX Live |
| 610 |
package will make use of it. The minimum version is 8.5. |
| 611 |
|
| 612 |
At the time of writing, this front end does not work under MiKTeX; I do |
| 613 |
not know why not. The alternative epspdf-setup package for Windows with |
| 614 |
an embedded Tcl/Tk runtime and an installer has been withdrawn, since it |
| 615 |
was only useful on MiKTeX. |
| 616 |
|
| 617 |
|
| 618 |
File: epspdf.info, Node: Change history, Prev: Requirements, Up: Top |
| 619 |
|
| 620 |
Appendix B Change history |
| 621 |
************************* |
| 622 |
|
| 623 |
* Menu: |
| 624 |
|
| 625 |
* Version 0.6.5.2:: |
| 626 |
* Version 0.6.5.1:: |
| 627 |
* Version 0.6.5:: |
| 628 |
* Version 0.6.4:: |
| 629 |
* Version 0.6:: |
| 630 |
* Version 0.5:: |
| 631 |
* Version 0.4:: |
| 632 |
|
| 633 |
|
| 634 |
File: epspdf.info, Node: Version 0.6.5.2, Next: Version 0.6.5.1, Prev: Change history, Up: Change history |
| 635 |
|
| 636 |
B.1 Version 0.6.5.2 |
| 637 |
=================== |
| 638 |
|
| 639 |
Epspdftk: compatibility fix for Tcl/Tk 9. |
| 640 |
|
| 641 |
|
| 642 |
File: epspdf.info, Node: Version 0.6.5.1, Next: Version 0.6.5, Prev: Version 0.6.5.2, Up: Change history |
| 643 |
|
| 644 |
B.2 Version 0.6.5.1 |
| 645 |
=================== |
| 646 |
|
| 647 |
Epspdf: An erroneous and unnecessary check for writability, with |
| 648 |
possible security implications, has been removed. For MiKTeX, |
| 649 |
os.execute replaces os.spawn invocations, since os.spawn gave trouble in |
| 650 |
my tests on MiKTeX. |
| 651 |
|
| 652 |
|
| 653 |
File: epspdf.info, Node: Version 0.6.5, Next: Version 0.6.4, Prev: Version 0.6.5.1, Up: Change history |
| 654 |
|
| 655 |
B.3 Version 0.6.5 |
| 656 |
================= |
| 657 |
|
| 658 |
Epspdf: Compatibility change for ghostscript 9.50 and later. |
| 659 |
|
| 660 |
Epspdftk: improvements to viewer selection; does not impact Windows or |
| 661 |
MacOS. |
| 662 |
|
| 663 |
A few updates to the manual, mostly for the troubleshooting section. |
| 664 |
|
| 665 |
|
| 666 |
File: epspdf.info, Node: Version 0.6.4, Next: Version 0.6, Prev: Version 0.6.5, Up: Change history |
| 667 |
|
| 668 |
B.4 Version 0.6.4 |
| 669 |
================= |
| 670 |
|
| 671 |
Compatibility changes for luatex 1.9 and later. |
| 672 |
|
| 673 |
The location of pdftops is no longer configurable; it is only searched |
| 674 |
for on the searchpath. |
| 675 |
|
| 676 |
Some corner cases should be handled more successfully. |
| 677 |
|
| 678 |
The GUI now requires Tcl/Tk version 8.5 or higher. On Windows, |
| 679 |
epspdf.tlu is now invoked via a batchfile. This should prevent black |
| 680 |
console windows popping up. |
| 681 |
|
| 682 |
|
| 683 |
File: epspdf.info, Node: Version 0.6, Next: Version 0.5, Prev: Version 0.6.4, Up: Change history |
| 684 |
|
| 685 |
B.5 Version 0.6 |
| 686 |
=============== |
| 687 |
|
| 688 |
The command-line backend component has been rewritten in texlua and |
| 689 |
therefore no longer needs an external scripting language. |
| 690 |
|
| 691 |
Grayscaling is now done by Ghostscript's color options for pdf output. |
| 692 |
This also works for bitmaps. |
| 693 |
|
| 694 |
Croppping of pdfs is now accomplished by running luatex on a suitable |
| 695 |
wrapper file (same method as Heiko Oberdiek's pdfcrop). Such a |
| 696 |
conversion preserves advanced features which might otherwise get lost. |
| 697 |
|
| 698 |
I no longer try to provide an AppleScript wrapper. |
| 699 |
|
| 700 |
The current version has no provisions for custom Ghostscript- or pdftops |
| 701 |
parameters. The corresponding command-line options are accepted but |
| 702 |
have no effect. |
| 703 |
|
| 704 |
|
| 705 |
File: epspdf.info, Node: Version 0.5, Next: Version 0.4, Prev: Version 0.6, Up: Change history |
| 706 |
|
| 707 |
B.6 Version 0.5 |
| 708 |
=============== |
| 709 |
|
| 710 |
The GUI has been rewritten in Tcl/Tk, removing the dependence on the |
| 711 |
Ruby/Tk interface library. |
| 712 |
|
| 713 |
The Windows installer now installs a small Ruby subset and the standard |
| 714 |
epspdf distribution, but with epspdftk.tcl replaced with a starpack: a |
| 715 |
single executable containing ‘epspdftk.tcl’ and a Tcl/Tk runtime. See |
| 716 |
<http://wiki.tcl.tk/52>. |
| 717 |
|
| 718 |
Epspdf now uses its own subdirectory for both the logfile and the |
| 719 |
configuration file. For Linux/Unix/Mac OS this is ‘$HOME/.epspdf’, for |
| 720 |
Windows it is ‘%APPDATA%\epspdf’. On all supported platforms, settings |
| 721 |
are stored in the file ‘config’ in this directory. Under Windows, the |
| 722 |
registry is no longer used for this. |
| 723 |
|
| 724 |
A button has been added to view log output. |
| 725 |
|
| 726 |
There is a second new button "Remove temp files", which is normally |
| 727 |
checked, causing temporary files to be deleted after each conversion. |
| 728 |
Unchecking this button may be useful for troubleshooting. In previous |
| 729 |
versions, temporary files were deleted at the end of the entire epspdftk |
| 730 |
session but that has become less practical now that the GUI and epspdf |
| 731 |
itself have become two separate programs. |
| 732 |
|
| 733 |
The "Open with..." option for Windows has been dropped for technical |
| 734 |
reasons. |
| 735 |
|
| 736 |
The "-version" option now prints the version string instead of setting |
| 737 |
the desired pdf version. |
| 738 |
|
| 739 |
The "-info" option now also prints the number of pages for pdf files. |
| 740 |
|
| 741 |
|
| 742 |
File: epspdf.info, Node: Version 0.4, Prev: Version 0.5, Up: Change history |
| 743 |
|
| 744 |
B.7 Version 0.4 |
| 745 |
=============== |
| 746 |
|
| 747 |
Hi-res boundingboxes are now supported. By default, conversion from eps |
| 748 |
to pdf now uses the hires boundingbox as "page" to determine the page |
| 749 |
dimensions of the pdf file. Other conversions preserve or generate a |
| 750 |
hires boundingbox. |
| 751 |
|
| 752 |
Under Windows, the new version looks for an installed TeX and will use |
| 753 |
its private Ghostscript if it cannot find a separately installed |
| 754 |
Ghostscript. TeX Live's pdftops, being on the searchpath, will be used |
| 755 |
unless epspdf finds another copy first. |
| 756 |
|
| 757 |
There is now a "-v" (lowercase) option to print the version string. |
| 758 |
|
| 759 |
|
| 760 |
|
| 761 |
Tag Table: |
| 762 |
Node: Top553 |
| 763 |
Node: Usage2129 |
| 764 |
Node: Overview2332 |
| 765 |
Node: Viewing2717 |
| 766 |
Node: Conversion options3178 |
| 767 |
Ref: gray3327 |
| 768 |
Node: Converting3982 |
| 769 |
Node: The configuration screen4375 |
| 770 |
Node: Command-line usage6589 |
| 771 |
Node: Option summary7305 |
| 772 |
Node: Notes on PostScript and pdf8618 |
| 773 |
Node: Bitmapped and vector9001 |
| 774 |
Node: Font embedding10231 |
| 775 |
Node: Eps preview headers10686 |
| 776 |
Node: Bounding- and other boxes11133 |
| 777 |
Node: Orientation11755 |
| 778 |
Node: Exporting PostScript or pdf from Windows programs12188 |
| 779 |
Node: Bitmapped graphics for LaTeX and pdflatex13141 |
| 780 |
Node: Linux13610 |
| 781 |
Node: Mac OS14375 |
| 782 |
Node: Windows14685 |
| 783 |
Node: Troubleshooting15440 |
| 784 |
Node: No options for output format visible15943 |
| 785 |
Node: Ghostscript stackunderflow error16247 |
| 786 |
Node: Error message ``pdf_crop failed''16758 |
| 787 |
Node: Wrong boundingbox (.eps or .ps output)17144 |
| 788 |
Node: Part of the graphic gets cut off17534 |
| 789 |
Node: Fonts look ugly17922 |
| 790 |
Node: The page has been converted to a bitmap18454 |
| 791 |
Node: Temporary files are not removed18947 |
| 792 |
Node: Resources for troubleshooting19622 |
| 793 |
Ref: Documentation20581 |
| 794 |
Node: Requirements20903 |
| 795 |
Node: Change history21905 |
| 796 |
Node: Version 0.6.5.222167 |
| 797 |
Node: Version 0.6.5.122364 |
| 798 |
Node: Version 0.6.522739 |
| 799 |
Node: Version 0.6.423097 |
| 800 |
Node: Version 0.623603 |
| 801 |
Node: Version 0.524385 |
| 802 |
Node: Version 0.425880 |
| 803 |
|
| 804 |
End Tag Table |
| 805 |
|
| 806 |
|
| 807 |
Local Variables: |
| 808 |
coding: utf-8 |
| 809 |
End: |