diff options
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/epspdf.texi')
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.texi | 216 |
1 files changed, 121 insertions, 95 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.texi b/Master/texmf-dist/doc/support/epspdf/epspdf.texi index d1150537efc..ae7a8265d3e 100644 --- a/Master/texmf-dist/doc/support/epspdf/epspdf.texi +++ b/Master/texmf-dist/doc/support/epspdf/epspdf.texi @@ -11,6 +11,7 @@ @afourpaper @c %**end of header +@c Actually, we do not produce html anymore @ifhtml @alias chapter = unnumbered @alias section = unnumberedsec @@ -28,7 +29,7 @@ @hyphenation{epspdf-tk epspdf} @end iftex -@set version 0.6.0 +@set version 0.6.1 @set homepage http://tex.aanhet.net/epspdf/ @setchapternewpage off @@ -37,7 +38,7 @@ @copying This manual is for epspdf, version @value{version}. -Copyright @copyright{} 2006, 2008, 2009, 2010, 2011, 2013 Siep Kroonenberg. +Copyright @copyright{} 2006, 2008, 2009, 2010, 2011, 2013, 2014 Siep Kroonenberg. @quotation Copying and distribution of this file, with or without modification, @@ -49,7 +50,9 @@ without any warranty. @titlepage @sp 1 +@ifnotinfo @center @image{images/logo,,.4in} +@end ifnotinfo @sp 2 @center @titlefont {Epspdf and epspdftk User Manual} @sp 1 @@ -63,96 +66,78 @@ without any warranty. @contents @ifnottex -@node Top, What has changed?, (dir), (dir) +@node Top, Usage, (dir), (dir) @top Epspdf and epsdftk @insertcopying @end ifnottex @menu -* What has changed?:: -* Usage:: -* Command-line usage:: -* Notes on PostScript and pdf:: -* Bitmapped graphics for @LaTeX{} and pdflatex:: -* Troubleshooting:: -* Change history:: +* Usage:: +* Command-line usage:: +* Notes on PostScript and pdf:: +* Bitmapped graphics for @LaTeX{} and pdflatex:: +* Troubleshooting:: +* Change history:: @detailmenu --- The Detailed Node Listing --- Usage -* Overview:: -* Viewing:: -* Conversion options:: -* Converting:: -* The configuration screen:: +* Overview:: +* Viewing:: +* Conversion options:: +* Converting:: +* The configuration screen:: Command-line usage -* Option summary:: +* Option summary:: Notes on PostScript and pdf -* Bitmapped and vector:: -* Font embedding:: -* Eps preview headers:: -* Bounding- and other boxes:: -* Orientation:: -* Exporting PostScript or pdf from Windows programs:: +* Bitmapped and vector:: +* Font embedding:: +* Eps preview headers:: +* Bounding- and other boxes:: +* Orientation:: +* Exporting PostScript or pdf from Windows programs:: Bitmapped graphics for @LaTeX{} and pdflatex -* Linux:: -* Mac OS X:: -* Windows:: +* Linux:: +* Mac OS X:: +* Windows:: Troubleshooting -* Part of the graphic gets cut off:: -* Fonts look ugly:: -* The page has been converted to a bitmap:: -* Resources for troubleshooting:: +* No options for output format visible:: +* Ghostscript stackunderflow error:: +* Part of the graphic gets cut off:: +* Fonts look ugly:: +* The page has been converted to a bitmap:: +* Temporary files are not removed:: +* Resources for troubleshooting:: Change history -* Version 0.6:: -* Version 0.5:: -* Version 0.4:: +* Version 0.6:: +* Version 0.5:: +* Version 0.4:: @end detailmenu @end menu -@node What has changed?, Usage, Top, Top -@unnumbered What has changed? - -Improvements: -@itemize @bullet -@item -Grayscaling should now also work on bitmapped images. -@item -Revised multistep conversions, with less risk of losing high-level -structure -@item -Rewritten in TeXLua, which is a component of both TeX Live and of -MikTeX. Command-line use no longer requires an external scripting -language. -@end itemize - -I have been testing with Ghostscript version 9.05 and 9.06. - -For more details, see @ref{Version 0.6}. - -@node Usage, Command-line usage, What has changed?, Top +@node Usage, Command-line usage, Top, Top @chapter Usage @menu -* Overview:: -* Viewing:: -* Conversion options:: -* Converting:: -* The configuration screen:: +* Overview:: +* Viewing:: +* Conversion options:: +* Converting:: +* The configuration screen:: @end menu @node Overview, Viewing, Usage, Usage @@ -166,11 +151,13 @@ When opening a file, epspdf tries to find out file type and, in the case of a pdf file, the number of pages. This information is displayed in the box in the upper part of the screen. +@ifnotinfo @noindent @image{images/main_w8,,3in} @iftex @hfill @end iftex @image{images/cnv_linux,,3in} +@end ifnotinfo @node Viewing, Conversion options, Overview, Usage @section Viewing @@ -218,7 +205,9 @@ can judge the result by pressing the View button again. @node The configuration screen, , Converting, Usage @section The configuration screen +@ifnotinfo @image{images/config_lnx,3in} +@end ifnotinfo Epspdftk also has a configuration screen. The settings here are preserved between sessions. @@ -240,7 +229,8 @@ pdf''. ``prepress'' is for pdfs which are going to be printed commercially. The options prepress, printer and default will try to embed all fonts. Often, printshops insist on this. With luck, Ghostscript fonts and system fonts will be used for fonts which were not -originally embedded. +originally embedded. Note that ``printer'' may not work with some +versions of Ghostscript, due to a bug in the handling of color. On the other hand, you may prefer ``screen'' if file size is a concern. See also the Ghostscript documentation, in particular Use.htm @@ -259,10 +249,12 @@ low version number but otherwise leave this at ``default''. @subsection Options for converting to PostScript For conversion the other way you may opt @i{not} to use pdftops even if it is available. In this case, the conversion will be done by -Ghostscript. Characters may be converted to drawn shapes or little -bitmaps so this is not recommended if the file uses fonts. +Ghostscript. With older Ghostscript versions, characters may be +converted to drawn shapes or little bitmaps, so use pdftops if +available. With newer Ghostscript versions, with an eps2write rather +than an epswrite output device, Ghostscript does a much better job. -Under Windows and MikTeX, this is also the place to point the program to +Under MikTeX, this is also the place to point the program to the location of pdftops.exe. @node Command-line usage, Notes on PostScript and pdf, Usage, Top @@ -271,21 +263,22 @@ the location of pdftops.exe. epspdf.tlu is the backend of epspdftk, but it can also be used standalone. It shares configuration settings with epspdftk.tcl. +The first parameter of the epspdftk GUI program is interpreted as +startup directory for the file browser. Epspdf itself has a more +elaborate command-line interface. + Below, we assume that there is a suitable wrapper or symlink for epspdf on your searchpath. This is the case if you installed epspdf as a TeX Live package. -The first parameter of epspdftk is interpreted as startup directory for -the file browser. - -Basic usage: +Basic usage of epspdf itself: @example -epspdf [@var{options}] @var{infile} @var{outfile} +epspdf [@var{options}] @var{infile} [@var{outfile}] @end example @menu -* Option summary:: +* Option summary:: @end menu @node Option summary, , Command-line usage, Command-line usage @@ -294,8 +287,8 @@ epspdf [@var{options}] @var{infile} @var{outfile} Typing @kbd{epspdf --help} gives you the following summary: @example $ epspdf --help -Epspdf version 0.6.0 -Copyright (c) 2006, 2008, 2009, 2010, 2011, 2013 Siep Kroonenberg +Epspdf version 0.6.1 +Copyright (c) 2006, 2008, 2009, 2010, 2011, 2013, 2014 Siep Kroonenberg Convert between [e]ps and pdf formats Usage: epspdf[.tlu] [options] infile [outfile] @@ -315,6 +308,7 @@ Default for outfile is file.eps if infile is file.pdf -U Use pdftops if available -I Reverses the above -s, --save Save some settings to configuration file +-i, --info Info: display detected filetype and exit -d Debug: do not remove temp files -v, --version Display version info and exit @@ -325,12 +319,12 @@ Default for outfile is file.eps if infile is file.pdf @chapter Notes on PostScript and pdf @menu -* Bitmapped and vector:: -* Font embedding:: -* Eps preview headers:: -* Bounding- and other boxes:: -* Orientation:: -* Exporting PostScript or pdf from Windows programs:: +* Bitmapped and vector:: +* Font embedding:: +* Eps preview headers:: +* Bounding- and other boxes:: +* Orientation:: +* Exporting PostScript or pdf from Windows programs:: @end menu @node Bitmapped and vector, Font embedding, Notes on PostScript and pdf, Notes on PostScript and pdf @@ -410,7 +404,7 @@ or a selection. This removes a major headache for Windows users. As a last resort, you can ``print'' to a PostScript file. From some programs, you can print a selection. A suitable driver which comes with -Windows is Generic / MS Publisher Imagesetter. Pay attention to the +Windows is Generic / MS Publisher Color Printer. Pay attention to the printer properties: choose ``Outline'' for font downloading and avoid the ``Optimize for speed'' setting for PostScript Output Option. In my tests, ``Encapsulated PostScript'' did not look very promising @@ -425,9 +419,9 @@ format (best for photographs) directly. However, for @LaTeX{} you are stuck with .eps format. Tips for converting to .eps: @menu -* Linux:: -* Mac OS X:: -* Windows:: +* Linux:: +* Mac OS X:: +* Windows:: @end menu @node Linux, Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex, Bitmapped graphics for @LaTeX{} and pdflatex @@ -458,7 +452,7 @@ excellent alternative to epspdf. @node Windows, , Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex @section Windows -Windows is not a particularly friendly environment for PostScript and +Windows is not a particularly friendly environment for PostScript or pdf. A couple of command-line utilities try to fill the gap, @emph{e.g.} @example sam2p image.png image.eps @@ -479,13 +473,29 @@ or bmeps in the background. @chapter Troubleshooting @menu -* Part of the graphic gets cut off:: -* Fonts look ugly:: -* The page has been converted to a bitmap:: -* Resources for troubleshooting:: +* No options for output format visible:: +* Ghostscript stackunderflow error:: +* Part of the graphic gets cut off:: +* Fonts look ugly:: +* The page has been converted to a bitmap:: +* Temporary files are not removed:: +* Resources for troubleshooting:: @end menu -@node Part of the graphic gets cut off, Fonts look ugly, Troubleshooting, Troubleshooting +@node No options for output format visible, Ghostscript stackunderflow error, Troubleshooting, Troubleshooting +@section No options for output format visible + +Widen the window, to make the output format radio buttons visible. + +@node Ghostscript stackunderflow error, Part of the graphic gets cut off, No options for output format visible, Troubleshooting +@section Ghostscript stackunderflow error + +Due to an error in Ghostscript color handling when converting to pdf, +selecting ``printer'' as target may lead to an error @code{stackunderflow +in .setdistillerparams}. Use the ``default'' or ``prepress'' target +instead. + +@node Part of the graphic gets cut off, Fonts look ugly, Ghostscript stackunderflow error, Troubleshooting @section Part of the graphic gets cut off If the PostScript file was generated with the Windows PostScript driver, @@ -496,11 +506,12 @@ Speed. @section Fonts look ugly If Ghostscript has to do the conversion from pdf to ps then text may not -remain text, but may be replaced by bitmaps. Try to get hold of a more -recent Ghostscript and of either the xpdf suite or the Poppler -utilities, both of which include pdftops. +remain text, but may be replaced by bitmaps. Newer Ghostscript versions +tend to do better in this respect than older ones, but as to preserving +fonts, the pdftops utility still handles more cases. It is part of the +xpdf suite and of the Poppler utilities. -@node The page has been converted to a bitmap, Resources for troubleshooting, Fonts look ugly, Troubleshooting +@node The page has been converted to a bitmap, Temporary files are not removed, Fonts look ugly, Troubleshooting @section The page has been converted to a bitmap This may happen if the page contains features such as transparency which @@ -509,7 +520,22 @@ are not supported by intermediate formats. Set pdf target use and target version both to ``default'' to avoid unnecessary conversions: @code{-T default -N default} -@node Resources for troubleshooting, , The page has been converted to a bitmap, Troubleshooting +@node Temporary files are not removed, Resources for troubleshooting, The page has been converted to a bitmap, Troubleshooting +@section Temporary files are not removed + +@itemize +@item +Command-line: make sure that you did not specify the option @code{-d}. +@item +Epspdftk GUI: make sure that `Remove temp files' is checked. +@item +Windows: this platform is notorious for excessive file locking. I +already inserted a Windows-specific delay before attempting to delete +the temporary files, but this is not always enough. However, you should +have no trouble removing temporary files manually. +@end itemize + +@node Resources for troubleshooting, , Temporary files are not removed, Troubleshooting @section Resources for troubleshooting @i{Logfile.} The GUI has a button for viewing log output. This same @@ -519,7 +545,7 @@ Windows it is in a subdirectory epspdf of @file{%APPDATA%}. This APPDATA directory may be @file{c:\Documents and Settings\@var{your user name}\Application Data} or @file{c:\Users\@var{your user name}\AppData\Roaming}. Otherwise, open a command prompt and type -@kbd{echo %APPDATA%}, which will produce this information. +@kbd{echo %APPDATA%} to display this information. The logfile lists all epspdf calls and all Ghostscript- and pdftops calls plus error information. @@ -539,9 +565,9 @@ for Windows there is a file pdftops.txt in the distribution zip. @chapter Change history @menu -* Version 0.6:: -* Version 0.5:: -* Version 0.4:: +* Version 0.6:: +* Version 0.5:: +* Version 0.4:: @end menu @node Version 0.6, Version 0.5, Change history, Change history |