summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf
diff options
context:
space:
mode:
authorSiep Kroonenberg <siepo@cybercomm.nl>2009-03-12 21:45:21 +0000
committerSiep Kroonenberg <siepo@cybercomm.nl>2009-03-12 21:45:21 +0000
commit45d4e495492214d0ff89696cfd2161ca68dce631 (patch)
treeeb7e93b25a8872b6bbe22c2385e25c5ca7046f95 /Master/texmf-dist/doc/support/epspdf
parentb97357980a311968eb1272f3b179b55545fd2687 (diff)
Update to v. 0.4.1: documentation update
git-svn-id: svn://tug.org/texlive/trunk@12371 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf')
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.install108
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.pdfbin224690 -> 233016 bytes
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.texi89
-rw-r--r--Master/texmf-dist/doc/support/epspdf/index.html101
4 files changed, 196 insertions, 102 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.install b/Master/texmf-dist/doc/support/epspdf/epspdf.install
index 8aa4fa90f07..d397f96f630 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.install
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.install
@@ -205,14 +205,12 @@ Installation
Mac OS X
- Install as for Unix/Linux. Here, too, all files should be in the same
- directory.
+ You can install as for Unix/Linux. Here, too, all files should be in the
+ same directory.
- You can try to start epspdftk.rb from the dock or by doubleclicking. If
- that doesn't work out, give the [25]epspdf.app applet a try. After
- unpacking, move the file epspdf.app to the same directory as the .rb
- files. The zipfile also includes this file in text format
- (epspdf.applescript).
+ There is also a compressed disk image epspdf.x.x.x.dmg.gz which wraps
+ epspdftk into a Max OS X app. Double-click once to expand, a second time
+ to mount, then drag epspdftk.app to the Applications folder.
Epspdf mostly duplicates functionality of Preview. But having an alternate
conversion engine means that you can have another shot at problem files.
@@ -232,7 +230,7 @@ Preview programs
Supported PostScript viewers include evince, gv, gsview and okular. These
are also listed as pdf viewers. Additional pdf viewers are xpdf, gpdf,
epdfview and acroread/Adobe Reader. You can also specify a previewer
- manually in the configuration screen; see the [26]user manual..
+ manually in the configuration screen; see the [25]user manual..
Mac OS X
@@ -241,34 +239,42 @@ Preview programs
Files
- * [27]epspdf.0.4.0.tgz preferred for Unix and Mac OS X
- * [28]epspdf.0.4.0.zip preferred for Windows
- * [29]epspdf.0.4.0.exe Windows setup program, including Ruby/Tk subset
- * [30]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
+ * [26]epspdf.0.4.1.tgz preferred for Unix and Mac OS X
+ * [27]epspdf.0.4.1.zip preferred for Windows
+ * [28]epspdf.0.4.1.exe Windows setup program, including Ruby/Tk subset
+ * [29]epspdftk.0.4.1.dmg.gz compressed disk image with epspdftk wrapped
+ into a Mac OS X app
Older releases
- * [31]epspdf.0.3.0.tgz for Unix and Mac OS X
- * [32]epspdf.0.3.0.zip for Windows
- * [33]epspdf.0.3.0.exe Windows setup program
- * [34]epspdf.0.2.12.tgz for Unix and Mac OS X
- * [35]epspdf.0.2.12.zip for Windows
- * [36]epspdf.0.2.12.exe Windows setup program
- * [37]epspdf.0.2.11.tgz for Unix and Mac OS X
- * [38]epspdf.0.2.11.zip for Windows
- * [39]epspdf.0.2.11.exe Windows setup program
- * [40]epspdf.0.2.01.tgz for Unix and Mac OS X
- * [41]epspdf.0.2.01.zip for Windows
- * [42]epspdf.0.2.exe, Windows setup program
+ * [30]epspdf.0.3.0.tgz for Unix and Mac OS X
+ * [31]epspdf.0.3.0.zip for Windows
+ * [32]epspdf.0.3.0.exe Windows setup program
+ * [33]epspdf.0.2.12.tgz for Unix and Mac OS X
+ * [34]epspdf.0.2.12.zip for Windows
+ * [35]epspdf.0.2.12.exe Windows setup program
+ * [36]epspdf.0.2.11.tgz for Unix and Mac OS X
+ * [37]epspdf.0.2.11.zip for Windows
+ * [38]epspdf.0.2.11.exe Windows setup program
+ * [39]epspdf.0.2.01.tgz for Unix and Mac OS X
+ * [40]epspdf.0.2.01.zip for Windows
+ * [41]epspdf.0.2.exe, Windows setup program
+ * [42]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
Releases
+ 0.4.1
+ Current version. Documentation: added section on bitmaps. Windows
+ setup program: added missing Tcl/Tk licenses. Mac:
+ double-clickable epspdftk.app with included epspdftk replaces
+ double-clickable epspdf.app add-on.
+
0.4.0
- Current version. Optionally uses hires boundingbox. Faster startup
- due to simpler testing of prerequisites. Grayscaling: support for
- HSB color model, although I yet have to encounter a PostScript
- file using this. Manual converted to texinfo format. Windows: new
- View with... button; support for MikTeX's built-in Ghostscript;
+ Optionally uses hires boundingbox. Faster startup due to simpler
+ testing of prerequisites. Grayscaling: support for HSB color
+ model, although I yet have to encounter a PostScript file using
+ this. Manual converted to texinfo format. Windows: new View
+ with... button; support for MikTeX's built-in Ghostscript;
streamlined Ruby subset, with Tcl/Tk compiled from source.
0.3.0
@@ -310,7 +316,7 @@ Releases
--------------------------------------------------------------------------
- Last revised: February 29, 2009
+ Last revised: March 12, 2009
References
@@ -336,24 +342,24 @@ References
19. http://rubyforge.org/frs/?group_id=167
20. http://www.ruby-lang.org/en/downloads/
21. http://activestate.com/Products/ActiveTcl/
- 22. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
- 23. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
- 24. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
- 25. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
- 26. http://tex.aanhet.net/epspdf/epspdf.pdf
- 27. http://tex.aanhet.net/epspdf/epspdf.0.4.0.tgz
- 28. http://tex.aanhet.net/epspdf/epspdf.0.4.0.zip
- 29. http://tex.aanhet.net/epspdf/epspdf.0.4.0.exe
- 30. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
- 31. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
- 32. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
- 33. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
- 34. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
- 35. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
- 36. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
- 37. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz
- 38. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip
- 39. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe
- 40. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
- 41. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
- 42. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
+ 22. http://tex.aanhet.net/epspdf/epspdf.0.4.1.exe
+ 23. http://tex.aanhet.net/epspdf/epspdf.0.4.1.zip
+ 24. http://tex.aanhet.net/epspdf/epspdf.0.4.1.tgz
+ 25. http://tex.aanhet.net/epspdf/epspdf.pdf
+ 26. http://tex.aanhet.net/epspdf/epspdf.0.4.1.tgz
+ 27. http://tex.aanhet.net/epspdf/epspdf.0.4.1.zip
+ 28. http://tex.aanhet.net/epspdf/epspdf.0.4.1.exe
+ 29. http://tex.aanhet.net/epspdf/epspdftk.0.4.1.dmg.gz
+ 30. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
+ 31. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
+ 32. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
+ 33. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
+ 34. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
+ 35. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
+ 36. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz
+ 37. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip
+ 38. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe
+ 39. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
+ 40. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
+ 41. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
+ 42. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
index 9ac30cf1cf0..69485d0a314 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
Binary files differ
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
diff --git a/Master/texmf-dist/doc/support/epspdf/index.html b/Master/texmf-dist/doc/support/epspdf/index.html
index f1a02ef4db2..4480eb82696 100644
--- a/Master/texmf-dist/doc/support/epspdf/index.html
+++ b/Master/texmf-dist/doc/support/epspdf/index.html
@@ -229,14 +229,14 @@ installation. See the table below:</p>
<h3>Windows setup program</h3>
-<p>Download the <a href="epspdf.0.3.0.exe">epspdftk setup
+<p>Download the <a href="epspdf.0.4.1.exe">epspdftk setup
program.</a> You can run it in the usual way, by double-clicking. The
setup program will create entries in your start menu for epspdftk
and for the user manual.</p>
<h3>Windows zipfile</h3>
-<p>Download the <a href="epspdf.0.3.0.zip">epspdf zip file</a>,
+<p>Download the <a href="epspdf.0.4.1.zip">epspdf zip file</a>,
unpack it somewhere and create a shortcut for epspdftk.rbw. If you
plan to use the command-line version, put a batchfile in a directory
on your path with the line</p>
@@ -255,7 +255,7 @@ Windows Vista.</p>
<h3>Unix/Linux</h3>
-<p>Download the <a href="epspdf.0.3.0.tgz">tar.gz archive</a> and
+<p>Download the <a href="epspdf.0.4.1.tgz">tar.gz archive</a> and
unpack it in some directory. All files should be in the same
directory; that is how they find each other. If you plan to use
epspdf.rb from the command-line, then create a shell script
@@ -274,15 +274,13 @@ browser.</p>
<h3>Mac OS X</h3>
-<p>Install as for Unix/Linux. Here, too, all files should be in the
-same directory.</p>
+<p>You can install as for Unix/Linux. Here, too, all files should be
+in the same directory.</p>
-<p>You can try to start epspdftk.rb from the dock or by
-doubleclicking. If that doesn't work out, give the <a
-href="epspdf_app.0.2.01.zip">epspdf.app</a> applet a try. After
-unpacking, move the file <tt>epspdf.app</tt> to the same directory
-as the .rb files. The zipfile also includes this file in text format
-(<tt>epspdf.applescript</tt>).</p>
+<p>There is also a compressed disk image epspdf.x.x.x.dmg.gz which
+wraps epspdftk into a Max OS X <q>app</q>. Double-click once to
+expand, a second time to mount, then drag epspdftk.app to the
+Applications folder.</p>
<p>Epspdf mostly duplicates functionality of Preview. But having an
alternate conversion engine means that you can have another shot at
@@ -314,17 +312,17 @@ usually Preview or Adobe Reader.</p>
<h2><a name="files"/>Files</h2>
<ul>
-<li><a href="epspdf.0.4.0.tgz">epspdf.0.4.0.tgz</a> preferred for Unix
+<li><a href="epspdf.0.4.1.tgz">epspdf.0.4.1.tgz</a> preferred for Unix
and Mac OS X</li>
-<li><a href="epspdf.0.4.0.zip">epspdf.0.4.0.zip</a> preferred for
+<li><a href="epspdf.0.4.1.zip">epspdf.0.4.1.zip</a> preferred for
Windows</li>
-<li><a href="epspdf.0.4.0.exe">epspdf.0.4.0.exe</a> Windows setup
+<li><a href="epspdf.0.4.1.exe">epspdf.0.4.1.exe</a> Windows setup
program, including Ruby/Tk subset</li>
-<li><a href="epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a> Mac OS X
-applet for starting epspdftk.rb</li>
+<li><a href="epspdftk.0.4.1.dmg.gz">epspdftk.0.4.1.dmg.gz</a>
+ compressed disk image with epspdftk wrapped into a Mac OS X <q>app</q></li>
</ul>
<h3>Older releases</h3>
@@ -353,54 +351,61 @@ Windows</li>
Windows</li>
<li><a href="epspdf.0.2.exe">epspdf.0.2.exe</a>, Windows setup
program</li>
+
+<li><a href="epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a> Mac OS X
+applet for starting epspdftk.rb</li>
</ul>
<h2><a name="releases"/>Releases</h2>
-<dl> <dt>0.4.0</dt><dd>Current version. Optionally uses hires
- boundingbox. Faster startup due to simpler testing of
- prerequisites. Grayscaling: support for HSB color model, although
- I yet have to encounter a PostScript file using this. Manual
- converted to texinfo format. Windows: new <q>View with...</q>
- button; support for MikTeX's built-in Ghostscript; streamlined
- Ruby subset, with Tcl/Tk compiled from source.</dd>
+<dl><dt>0.4.1</dt><dd>Current version. Documentation: added section
+ on bitmaps. Windows setup program: added missing Tcl/Tk
+ licenses. Mac: double-clickable epspdftk.app with included
+ epspdftk replaces double-clickable epspdf.app add-on.</dd>
+
+<dt>0.4.0</dt><dd>Optionally uses hires boundingbox. Faster startup
+ due to simpler testing of prerequisites. Grayscaling: support for
+ HSB color model, although I yet have to encounter a PostScript
+ file using this. Manual converted to texinfo format. Windows: new
+ <q>View with...</q> button; support for MikTeX's built-in
+ Ghostscript; streamlined Ruby subset, with Tcl/Tk compiled from
+ source.</dd>
<dt>0.3.0</dt><dd>Under Windows, now recognizes whether it is
-embedded in TeX Live 2008 and then can use ghostscript/pdftops from
-TeX Live. Also added TeX Live wrapper scripts. Uninstaller for
-Windows setup program. Bug fixes: now accepts non-numerical version
-strings for pdftops. No longer checks for viewers under Mac OS
-X.</dd>
-
-<dt>0.2.12</dt><dd>Bug fixes: log rotation now
-works. Under Windows, sometimes boundingboxes couldn't be
-calculated. This was caused by double quotes within backquotes. This
-is now avoided by using short filenames within backquotes. Minor
-changes in user guide.</dd>
+ embedded in TeX Live 2008 and then can use ghostscript/pdftops
+ from TeX Live. Also added TeX Live wrapper scripts. Uninstaller
+ for Windows setup program. Bug fixes: now accepts non-numerical
+ version strings for pdftops. No longer checks for viewers under
+ Mac OS X.</dd>
+
+<dt>0.2.12</dt><dd>Bug fixes: log rotation now works. Under Windows,
+ sometimes boundingboxes couldn't be calculated. This was caused by
+ double quotes within backquotes. This is now avoided by using
+ short filenames within backquotes. Minor changes in user
+ guide.</dd>
<dt>0.2.11</dt><dd> Minor fixes. Changes in documentation.</dd>
<dt>0.2.10</dt><dd>A computed boundingbox is now expanded by one
-point in all directions. This should prevent too-tight
-cropping. There is no interface for changing this amount; it can
-only be changed by hand-editing the bb_spread
-option in the .epspdfrc file or in the HKCU\software\epspdf registry
-key.</dd> <dd>The File Open dialog remembers the last directory
-visited (between calls, not between program
-sessions).</dd><dd>Changes in documentation.</dd>
+ point in all directions. This should prevent too-tight
+ cropping. There is no interface for changing this amount; it can
+ only be changed by hand-editing the bb_spread option in the
+ .epspdfrc file or in the HKCU\software\epspdf registry key.</dd>
+ <dd>The File Open dialog remembers the last directory visited
+ (between calls, not between program sessions).</dd><dd>Changes in
+ documentation.</dd>
<dt>0.2.01</dt><dd>Fixes to the Applescript applet epspdf.app for
-starting up epspdftk under Mac OS X. It picks up the terminal search
-path and no longer requires correct settings in
-$HOME/.MacOSX/environment.plist. Epspdf.app is now
-packaged separately, under Mac OS
-X, and now has an intact resource fork. It has been removed from the
-other archives.</dd>
+ starting up epspdftk under Mac OS X. It picks up the terminal
+ search path and no longer requires correct settings in
+ $HOME/.MacOSX/environment.plist. Epspdf.app is now packaged
+ separately, under Mac OS X, and now has an intact resource
+ fork. It has been removed from the other archives.</dd>
<dt>0.2</dt><dd>Original release</dd>
</dl>
<hr/>
-<p class="fineprint">Last revised: February 29, 2009</p>
+<p class="fineprint">Last revised: March 12, 2009</p>
</body></html>