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