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.texi89
1 files changed, 86 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.texi b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
index 284b106bdd7..6bbb50f9456 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.texi
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
@@ -21,7 +21,7 @@
@raggedbottom
@end iftex
-@set version 0.4.0
+@set version 0.4.1
@set homepage http://tex.aanhet.net/epspdf/
@setchapternewpage off
@@ -63,6 +63,7 @@ notice are preserved.
* Usage::
* Command-line usage::
* Notes on PostScript and pdf::
+* Bitmapped graphics for @LaTeX{} and pdflatex::
* Troubleshooting::
* Changes in version 0.4::
@@ -90,6 +91,16 @@ Notes on PostScript and pdf
* Orientation::
* Exporting PostScript from Windows programs::
+Bitmapped graphics for @LaTeX{} and pdflatex
+
+* Linux::
+* Mac OS X::
+* Windows::
+
+Windows
+
+* GUI use of sam2p and bmeps::
+
Troubleshooting
* Grayscaling fails::
@@ -273,9 +284,9 @@ The summary below is the output of a command @kbd{epspdf --help}
for help.
@example
$ epspdf --help
-Epspdf version 0.4.0
+Epspdf version 0.4.1
Copyright (C) 2006, 2008, 2009 Siep Kroonenberg
-Epspdf 0.4.0
+Epspdf 0.4.1
Convert between [e]ps and pdf formats
Usage: epspdf.rb [options] infile [outfile]
Default for outfile is file.pdf if infile is file.eps or file.ps
@@ -419,6 +430,78 @@ 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
+@chapter Bitmapped graphics for @LaTeX{} and pdflatex
+
+pdflatex can use graphics in .png format (best for screenshots) and .jpg
+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::
+@end menu
+
+@node Linux
+@section Linux
+
+@table @emph
+@item ImageMagick/convert
+@command{convert} from the ImageMagick package is a command-line
+utility: @samp{convert image.png image.eps}
+@item The GIMP
+This is the premier open source image editing program. It is often
+pre-installed on Linux, and is also available for other platforms. The
+GIMP can save in eps format.
+@end table
+
+@node Mac OS X
+@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
+@section Windows
+
+Windows is not a particularly friendly environment for PostScript and
+pdf. A couple of command-line utilities try to fill the gap, @emph{e.g.}
+@example
+sam2p image.png image.eps
+@end example
+or
+@example
+bmeps -c image.png image.eps
+@end example
+sam2p is distributed with TeX Live, bmeps both with TeX Live and with
+MikTeX. Without the @code{-c} option, bmeps produces a grayscale
+image. It produces larger files than sam2p.
+
+@menu
+* GUI use of sam2p and bmeps::
+@end menu
+
+@node GUI use of sam2p and bmeps
+@subsection GUI use of sam2p and bmeps
+
+Create a batchfile @file{bitmap2eps.bat} with contents
+@verbatim
+sam2p "%~1" "%~dpn1.eps"
+@end verbatim
+(TeX Live) or
+@verbatim
+bmeps -c "%~1" "%~dpn1.eps"
+@end verbatim
+(MikTeX) and place it @emph{e.g.} on your desktop. Now if you drop a
+bitmapped graphic on this batchfile then you will get an eps file with
+the same name as the original, but with extension @code{.eps}.
+
+You can also right-click on a bitmap, choose @emph{Open With...} and
+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
@chapter Troubleshooting