summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf/epspdf.texi
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/epspdf.texi')
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.texi192
1 files changed, 124 insertions, 68 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.texi b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
index 36d69d53327..2001ccb0675 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.texi
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
@@ -19,9 +19,10 @@
@textfonts
@rm
@raggedbottom
+@hyphenation{epspdf-tk epspdf}
@end iftex
-@set version 0.4.3
+@set version 0.5
@set homepage http://tex.aanhet.net/epspdf/
@setchapternewpage off
@@ -41,6 +42,8 @@ without any warranty.
@end copying
@titlepage
+@sp 1
+@center @image{images/logo,,.4in}
@sp 2
@center @titlefont {Epspdf and epspdftk User Manual}
@sp 1
@@ -54,7 +57,7 @@ without any warranty.
@contents
@ifnottex
-@node Top
+@node Top, Usage, (dir), (dir)
@top Epspdf and epsdftk
@insertcopying
@@ -66,7 +69,7 @@ without any warranty.
* Notes on PostScript and pdf::
* Bitmapped graphics for @LaTeX{} and pdflatex::
* Troubleshooting::
-* Changes in version 0.4::
+* Change history::
@detailmenu
--- The Detailed Node Listing ---
@@ -107,12 +110,18 @@ Troubleshooting
* Grayscaling fails::
* Part of the graphic gets cut off::
* Fonts look ugly::
+* epspdftk quit unexpectedly (Mac OS X applet)::
* Resources for troubleshooting::
+Change history
+
+* Version 0.5::
+* Version 0.4::
+
@end detailmenu
@end menu
-@node Usage
+@node Usage, Command-line usage, Top, Top
@chapter Usage
@menu
@@ -123,7 +132,7 @@ Troubleshooting
* The configuration screen::
@end menu
-@node Overview
+@node Overview, Viewing, Usage, Usage
@section Overview
Epspdftk converts files between eps, pdf and general
@@ -140,18 +149,14 @@ displayed in the box in the upper part of the screen.
@end iftex
@image{images/cnv_osx,,3in}
-@node Viewing
+@node Viewing, Conversion options, Overview, Usage
@section Viewing
The View button at the bottom of the screen calls an appropriate
external viewer.
-@i{Windows:} Epspdftk simply tries to use the default Open command. A
-second button, labeled @i{View with...}, lets the user select a
-different program to view the file.
-
-For OS X the viewer is also the default program, but there is no @i{View
-with...} button.
+@i{Windows and OS X:} Epspdftk simply tries to use the default Open
+command.
Under Linux the PostScript- and pdf viewers are
configurable; see @ref{The configuration screen}.
@@ -159,7 +164,7 @@ configurable; see @ref{The configuration screen}.
The View button is grayed if epspdf thinks that there is no
previewer for the current file.
-@node Conversion options
+@node Conversion options, Converting, Viewing, Usage
@section Conversion options
@anchor{gray}@i{Grayscaling:} Simple color figures can be converted to
@@ -175,24 +180,22 @@ if a single page is converted.
single page or selecting all pages. When converting to eps you are
restricted to a single page.
-For general PostScript files, there is no quick way to determine
-the number of pages, so the program won't check beforehand whether
-you picked an existing page. If you picked a non-existent page, the
-program will abort. If you don't like that, convert the entire
-document to pdf first -- which will be done behind the scenes
-anyhow.
+For general PostScript files, there is no quick way to determine the
+number of pages, so the program may not check beforehand whether you
+picked an existing page. If you don't like that, convert the entire
+document to pdf first -- which will be done behind the scenes anyhow.
Specifying options such as grayscaling or page selection may require
several roundtrips between PostScript or eps and pdf.
-@node Converting
+@node Converting, The configuration screen, Conversion options, Usage
@section Converting
The Convert and save... button calls up a file save dialog. After a
successful conversion, the result becomes the new current file, so you
can judge the result by pressing the View button again.
-@node The configuration screen
+@node The configuration screen, , Converting, Usage
@section The configuration screen
@image{images/config_lnx,3in}
@@ -209,8 +212,7 @@ manually.
For Windows and Mac OS X, there is no such configuration option. Epspdf
will use the program associated with the file type, which can be
-configured outside epspdf. Under Windows, you can use the ``View
-with...'' button instead.
+configured outside epspdf.
@subsection Options for converting to pdf
Double-check the setting ``Target use'' under ``Conversion to
@@ -228,15 +230,14 @@ and Ps2pdf.htm.
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.
+bitmaps so this is not recommended if the file uses fonts.
Under Windows, this is also the place to point the program to the
location of pdftops.exe.
@anchor{hires}@subsection Hires BoundingBox
-Uncheck the option ``Use hires boundingbox if possible'' if otherwise
-the computed boundingbox is slightly too tight, resulting in some
-clipping. It has two effects:
+Uncheck the option ``Use hires boundingbox if possible'' if your
+conversions come out slightly clipped. It has two effects:
@itemize @bullet
@item
When converting to pdf, it uses the standard rather than the hires
@@ -247,12 +248,11 @@ the standard boundingbox, except where it would make any boundingbox
coordinate negative.
@end itemize
-@node Command-line usage
+@node Command-line usage, Notes on PostScript and pdf, Usage, Top
@chapter Command-line usage
-epspdf.rb, the library for epspdftk.rb, does double duty as command-line
-version of epspdftk.rb. It shares configuration settings with
-epspdftk.rb.
+epspdf.rb is the backend of epspdftk, but it can also be used
+standalone. It shares configuration settings with epspdftk.tcl.
It is strongly recommended to invoke epspdf.rb via a wrapper script
epspdf or epspdf.bat on the search path, e.g.
@@ -279,13 +279,13 @@ epspdf [@var{options}] @var{infile} @var{outfile}
* Option summary::
@end menu
-@node Option summary
+@node Option summary, , Command-line usage, Command-line usage
@section Option summary
Typing @kbd{epspdf --help} gives you the following summary:
@example
$ epspdf --help
-Epspdf version 0.4.3
+Epspdf version 0.5
Copyright (C) 2006, 2008, 2009, 2010 Siep Kroonenberg
Convert between [e]ps and pdf formats
Usage: epspdf.rb [options] infile [outfile]
@@ -303,7 +303,6 @@ Default for outfile is file.eps if infile is file.pdf
-T, --target=TARGET Target use of pdf; one of
default, printer, prepress, screen, ebook
-N, --pdfversion=PDFVERSION Pdf version to be generated
- -V, --version=PDFVERSION Deprecated; use `-N' or `--pdfversion'.
-I Ignore pdftops even if available
(default: use if available)
-U Use pdftops if available
@@ -317,12 +316,13 @@ Default for outfile is file.eps if infile is file.pdf
-i, --info Info: display detected filetype
-s Save (some) settings
-d Debug: don't remove temp files
+ --gui[=ACTION] Do not use; reserved for GUI
- -v Prints version info
+ -v, --version Prints version info
-h, --help Show this message
@end example
-@node Notes on PostScript and pdf
+@node Notes on PostScript and pdf, Bitmapped graphics for @LaTeX{} and pdflatex, Command-line usage, Top
@chapter Notes on PostScript and pdf
@menu
@@ -334,7 +334,7 @@ Default for outfile is file.eps if infile is file.pdf
* Exporting PostScript from Windows programs::
@end menu
-@node Bitmapped and vector
+@node Bitmapped and vector, Font embedding, Notes on PostScript and pdf, Notes on PostScript and pdf
@section Bitmapped and vector
Pictures can be described either in terms of pixels, or more abstractly,
@@ -361,7 +361,7 @@ converts the other way. With the screen- and ebook ``Target use''
option, included bitmaps tend to be downsampled, i.e. reduced to a lower
resolution.
-@node Font embedding
+@node Font embedding, Eps preview headers, Bitmapped and vector, Notes on PostScript and pdf
@section Font embedding
When converting to pdf, Ghostscript handles font embedding differently
@@ -377,7 +377,7 @@ unless you have pdftops.
If target use is set to ``screen'', then standard fonts will be removed
instead of added. This option may also cause downsampling of bitmaps.
-@node Eps preview headers
+@node Eps preview headers, Bounding- and other boxes, Font embedding, Notes on PostScript and pdf
@section Eps preview headers
Preview headers are quietly stripped from eps files. These
@@ -386,7 +386,7 @@ represent eps files on screen without having to interpret the
PostScript code itself. Epspdf currently has no option to preserve
or add them.
-@node Bounding- and other boxes
+@node Bounding- and other boxes, Orientation, Eps preview headers, Notes on PostScript and pdf
@section Bounding- and other boxes
A PostScript file may have a page size and a boundingbox defined. A pdf
@@ -403,7 +403,7 @@ Both Ghostscript and pdftops have some parameters for setting or using
these boxes; consult Ps2pdf.htm from the Ghostscript documentation and
``pdftops --help'' or ``man pdftops''.
-@node Orientation
+@node Orientation, Exporting PostScript from Windows programs, Bounding- and other boxes, Notes on PostScript and pdf
@section Orientation
There appears to be no reliable way to set orientation for PostScript-
@@ -413,7 +413,7 @@ boundingbox. It may help to change the extension from ``.eps'' to
``.ps'' before converting to pdf. In this case, let epspdf generate a
new boundingbox.
-@node Exporting PostScript from Windows programs
+@node Exporting PostScript from Windows programs, , Orientation, Notes on PostScript and pdf
@section Exporting PostScript from Windows programs
Often, the only way to get EPS or PostScript from a Windows program is
@@ -432,7 +432,7 @@ uses a printer driver in the background. For faithful conversion,
pick wmf2eps; for subsequent editing, choose TpX. Both programs are
available from @url{http://www.tug.org/ctan.html}.
-@node Bitmapped graphics for @LaTeX{} and pdflatex
+@node Bitmapped graphics for @LaTeX{} and pdflatex, Troubleshooting, Notes on PostScript and pdf, Top
@chapter Bitmapped graphics for @LaTeX{} and pdflatex
pdflatex can use graphics in .png format (best for screenshots) and .jpg
@@ -445,7 +445,7 @@ stuck with .eps format. Tips for converting to .eps:
* Windows::
@end menu
-@node Linux
+@node Linux, Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex, Bitmapped graphics for @LaTeX{} and pdflatex
@section Linux
@table @emph
@@ -463,13 +463,13 @@ pre-installed on Linux, and is also available for other platforms. The
GIMP can save in eps format.
@end table
-@node Mac OS X
+@node Mac OS X, Windows, Linux, Bitmapped graphics for @LaTeX{} and pdflatex
@section Mac OS X
Mac OS X's built-in Preview application can read most bitmapped formats
and save them as .pdf, which epspdf can convert to .eps.
-@node Windows
+@node Windows, , Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex
@section Windows
Windows is not a particularly friendly environment for PostScript and
@@ -489,7 +489,7 @@ grayscale image. It produces larger files than sam2p.
* GUI use of sam2p and bmeps::
@end menu
-@node GUI use of sam2p and bmeps
+@node GUI use of sam2p and bmeps, , Windows, Windows
@subsection GUI use of sam2p and bmeps
Create a batchfile @file{bitmap2eps.bat} with contents
@@ -509,24 +509,25 @@ browse to this file bitmap2eps.bat, resulting in conversion to .eps. The
next time you do this with a file of the same type, bitmap2eps.bat will
already be in the list of possible programs for opening the file.
-@node Troubleshooting
+@node Troubleshooting, Change history, Bitmapped graphics for @LaTeX{} and pdflatex, Top
@chapter Troubleshooting
@menu
* Grayscaling fails::
* Part of the graphic gets cut off::
* Fonts look ugly::
+* epspdftk quit unexpectedly (Mac OS X applet)::
* Resources for troubleshooting::
@end menu
-@node Grayscaling fails
+@node Grayscaling fails, Part of the graphic gets cut off, Troubleshooting, Troubleshooting
@section Grayscaling fails
See above, under @ref{gray,,Grayscaling}. Epspdf is
limited by what can be done by the backend tools, i.e. Ghostscript
and pdftops. In particular, epspdf cannot grayscale bitmapped data.
-@node Part of the graphic gets cut off
+@node Part of the graphic gets cut off, Fonts look ugly, Grayscaling fails, Troubleshooting
@section Part of the graphic gets cut off
Things to try:
@@ -545,33 +546,44 @@ high-resolutuion boundingbox. Command-line option: ``-n'' or
``--no-hires''.
@end itemize
-@node Fonts look ugly
+@node Fonts look ugly, epspdftk quit unexpectedly (Mac OS X applet), Part of the graphic gets cut off, Troubleshooting
@section Fonts look ugly
If Ghostscript has to do the conversion from pdf to ps then text will
not remain text, but will be replaced by drawn shapes or bitmaps. Try
-to get hold of the xpdf suite, which includes pdftops, especially if
-your files contain serious amount of text.
+to get hold of the xpdf suite, which includes pdftops.
+
+@node epspdftk quit unexpectedly (Mac OS X applet), Resources for troubleshooting, Fonts look ugly, Troubleshooting
+@section Epspdftk quit unexpectedly (Mac OS X applet)
-@node Resources for troubleshooting
+This sometimes happens to me when I start epspdftk from the AppleScript
+applet. Unfortunately, I have no idea where this comes from.
+
+Try the ``Reopen'' button in the popup dialog. If this repeatedly fails,
+install the regular Unix edition instead and run it from the
+command-line.
+
+@node Resources for troubleshooting, , epspdftk quit unexpectedly (Mac OS X applet), Troubleshooting
@section Resources for troubleshooting
-@i{Logfile.} Epspdf and epspdftk maintain a log file
-epspdf.log in your home directory or, in case of Windows, your
-profile directory. This profile directory may be @file{c:\Documents and
-Settings\@var{your user name}}. Otherwise, open a DOS box and type
-@kbd{echo %USERPROFILE%}, which will produce this
-information.
+@i{Logfile.} The GUI has a button for viewing log output. This same
+output is also written to a file @file{epspdf.log}. For Linux/Unix/Mac
+OS X this is in a subdirectory .epspdf of your home directory; for
+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.
-This logfile lists all Ghostscript- and pdftops program
+The logfile lists all epspdf calls and all Ghostscript- and pdftops
calls plus error information. ``EPCallError'' is probably a program
-error. 'EPSystemError'' is more likely caused by a faulty file, but
-may be a program error as well.
+error. 'EPSystemError'' is more likely caused by a faulty file, but may
+be a program error as well.
@i{Temporary files.} The temporary files may give clues as
-well. They will be deleted at the end of the session (for the
+well. Uncheck the button ``Remove temp files'', or for the
command-line version, give a -d parameter to keep the temporary
-files). Check the logfile as to which temporary files have been
+files. Check the log(file) as to which temporary files have been
created.
@anchor{Documentation}@i{Ghostscript- and pdftops documentation.} For
@@ -579,12 +591,56 @@ Ghostscript, the most important files are Ps2pdf.htm and Use.htm. For
pdftops, type @kbd{pdftops -h}. For Unix, there is also a man page, and
for Windows there is a file pdftops.txt in the distribution zip.
-@node Changes in version 0.4
-@chapter Changes in version 0.4
+@node Change history, , Troubleshooting, Top
+@chapter Change history
+
+@menu
+* Version 0.5::
+* Version 0.4::
+@end menu
+
+@node Version 0.5, Version 0.4, Change history, Change history
+@section Version 0.5
+
+The GUI has been rewritten in Tcl/Tk, removing the dependence on the
+Ruby/Tk interface library.
+
+The Windows installer now installs a small Ruby subset and the standard
+epspdf distribution, but with epspdftk.tcl replaced with a starpack: a
+single executable containing @file{epspdftk.tcl} and a Tcl/Tk
+runtime. See @url{http://wiki.tcl.tk/52}.
+
+Epspdf now uses its own subdirectory for both the logfile and the
+configuration file. For Linux/Unix/Mac OS X this is
+@file{$HOME/.epspdf}, for Windows it is @file{%APPDATA%\epspdf}.
+On all supported platforms, settings are stored in the file
+@file{config} in this directory. Under Windows, the registry is no
+longer used for this.
+
+A button has been added to view log output.
+
+There is a second new button ``Remove temp files'', which is normally
+checked, causing temporary files to be deleted after each
+conversion. Unchecking this button may be useful for troubleshooting. In
+previous versions, temporary files were deleted at the end of the entire
+epspdftk session but that has become less practical now that the GUI and
+epspdf itself have become two separate programs.
+
+The ``Open with...'' option for Windows has been dropped for technical
+reasons.
+
+The ``--version'' option now prints the version string instead of
+setting the desired pdf version.
+
+The ``--info'' option now also prints the number of pages for pdf
+files.
+
+@node Version 0.4, , Version 0.5, Change history
+@section Version 0.4
Hi-res boundingboxes are now supported. By default, conversion from eps
to pdf now uses the hires boundingbox as ``page'' to determine the page
-dmensions of the pdf file. Other conversions preserve or generate a
+dimensions of the pdf file. Other conversions preserve or generate a
hires boundingbox.
Under Windows, the new version looks for an installed @TeX{} and will