diff options
| author | Siep Kroonenberg <siepo@cybercomm.nl> | 2013-02-07 21:36:03 +0000 |
|---|---|---|
| committer | Siep Kroonenberg <siepo@cybercomm.nl> | 2013-02-07 21:36:03 +0000 |
| commit | cb3b7cca1b0b066646b30f90ba02f0e61c30dd13 (patch) | |
| tree | 5c05c238a1d88a233b24f16b7938f47371e65ca5 /Master/texmf-dist/doc/support/epspdf | |
| parent | d4e04448079e0962ac0d665e41a7a50168c662a0 (diff) | |
Epspdf updated to 0.6
git-svn-id: svn://tug.org/texlive/trunk@29050 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf')
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/Changelog | 20 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/README | 16 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.install | 377 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.pdf | bin | 235104 -> 226736 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.texi | 424 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/cnv_linux.png | bin | 0 -> 26507 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png | bin | 42762 -> 0 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/config_lnx.png | bin | 6671 -> 21253 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/main_w32.png | bin | 6158 -> 0 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/main_w8.png | bin | 0 -> 13273 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/ps_settings.png | bin | 10205 -> 0 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/index.html | 386 |
12 files changed, 387 insertions, 836 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/Changelog b/Master/texmf-dist/doc/support/epspdf/Changelog index 76cc969ce2d..144f82caff9 100644 --- a/Master/texmf-dist/doc/support/epspdf/Changelog +++ b/Master/texmf-dist/doc/support/epspdf/Changelog @@ -1,3 +1,23 @@ +2013-02-07 0.6.0 + + Command-line component rewritten in TeXLua + + Texlua's epdf library replaces Ghostscript's pdf2dsc.ps. + + Grayscaling done by Ghostscript; both old grayscaling options now + do the same thing. + + When going from eps to pdf, a PostScript wrapper is no longer + used. Instead, Ghostscript now takes care of translating the eps + boundingbox to a pdf MediaBox. This implies that the hires + boundingbox will be used if available. + + Pdf crop adapted from Heiko Oberdiek's pdfcrop perl script + + ATM custom options for GhostScript and pdftops are no-ops. + + AppleScript wrapper dropped since I no longer own a Mac. + 2011-02-27 0.5.3 Windows: AppData now read from registry, because this value may not diff --git a/Master/texmf-dist/doc/support/epspdf/README b/Master/texmf-dist/doc/support/epspdf/README index 2037d0a4bea..6cc6e40c5d7 100644 --- a/Master/texmf-dist/doc/support/epspdf/README +++ b/Master/texmf-dist/doc/support/epspdf/README @@ -4,16 +4,6 @@ command-line and as a GUI application. Full documentation is available in the doc subdirectory. Windows users: you may prefer the Windows setup program instead. It -is available from http://tex.aanhet.net/epspdf/ and on CTAN as part -of epspdf-extra. The setup program already provides the necessary -pieces of Ruby and Tcl/Tk. - -Mac OS X Leopard users: you may want to have a look at epspdftk.app, -which wraps epspdftk into a Mac OS X double-clickable "app" with the -help of a bit of AppleScript. Available from -http://tex.aanhet.net/epspdf/ or on CTAN as part of -epspdf-extra. - -The former texlive subdirectory has been dropped. Under -Unix/Linux/Mac OS X, wrapper scripts are no longer needed; symlinks -to epspdf.rb and epspdftk.tcl suffice. +is available from http://tex.aanhet.net/epspdf/ and on CTAN as +epspdf-extra. The setup program already provides the necessary +pieces of Tcl/Tk. diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.install b/Master/texmf-dist/doc/support/epspdf/epspdf.install index 120acd3cb1f..020a79d6483 100644 --- a/Master/texmf-dist/doc/support/epspdf/epspdf.install +++ b/Master/texmf-dist/doc/support/epspdf/epspdf.install @@ -7,15 +7,15 @@ [1]Current online version of this page + [2]Legacy Ruby-based versions + Table of Contents - * [2]Features - * [3]Prerequisites - * [4]Installation - * [5]Preview programs + * [3]Features + * [4]Prerequisites + * [5]Installation * [6]Files * [7]Releases - * [8]User Manual Features @@ -25,10 +25,10 @@ Features * Also converts from pdf back to PostScript and eps * Removal of preview headers from eps files * Cropping extra whitespace - * Grayscaling (sometimes) + * Grayscaling * GUI- and command-line version * GUI-configurable preferences - * Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS X + * Multiplatform: works unchanged on Windows and Unix/Linux * Support for TeX Live and MiKTeX Epspdf has been created with TeX in mind. For TeX and its derivatives, eps @@ -42,20 +42,21 @@ Features Epspdftk adds a GUI, with buttons to select options and with dialogs for opening and saving files. - A lot more can be done if you can round-trip between PostScript and pdf. - Although Ghostscript can go from pdf to PostScript, pdftops does a much - better job converting text back to PostScript. This opens several new - possibilities: grayscaling and computing a better boundingbox for either - eps- or pdf graphics, and page selection from multipage PostScript- and - pdf documents. Epspdf will use pdftops if it can find it, and silently - does whatever back-and-forth conversions are necessary. + A lot more can be done with multistep conversions: grayscaling, page + selection, computing a tight boundingbox. People who depend on PSTricks + will appreciate the option to go from pdf to PostScript. + + Where it makes sense, epspdf uses additional software for a better + outcome. - The command-line program epspdf is written in Ruby. Epspdftk, its GUI - companion, in Tcl/Tk. Versions prior to 0.5 were written in Ruby/Tk. + The command-line program epspdf is written in texlua, which is already + part of recent versions of MikTeX and TeX Live. Versions [8]prior to 0.6 + were written in Ruby. Epspdftk, its GUI companion, is written in in + Tcl/Tk. - Starting with the 2008 edition, TeX Live includes epspdf as an optional - package, complete with wrapper scripts epspdf and epspdftk which can be - called from the command-line without further ado. + Starting with the 2008 edition, TeX Live includes epspdf in some form as + an optional package, complete with wrapper scripts epspdf and epspdftk + which can be called from the command-line without further ado. There is also a third-party LaTeX package epspdfconversion which uses epspdf for on-the-fly conversion of eps graphics to pdf, with options to @@ -67,324 +68,102 @@ Prerequisites These are the required and optional prerequisites, which will be checked for when epspdf starts: - * Ghostscript - * pdftops from the xpdf suite, strongly recommended for better pdf to - PostScript conversions - * Ruby 1.8.x or 1.9.x - * Tcl/Tk is only required for the GUI interface. Versions 8.4 and 8.5 - have been tested. + * A recent TeX installation, either [9]TeX Live or [10]MikTeX. If this + is not an option, get a [11]legacy version of epspdf instead. + * [12]Ghostscript + * Optional: pdftops from the [13]xpdf suite or from the [14]Poppler + utilities. Pdftops may do a better job of preserving scalable fonts + when converting from pdf to ps. + * [15]Tcl/Tk for the GUI interface. Versions 8.4 and 8.5 have been + tested. A single-file [16]TclKit runtime is sufficient. Recent + [17]Windows precompiled tclkit binaries are available. * Optional: viewers for PostScript and pdf - You may not have to install all of these yourself. - - Linux - - On a current Linux distribution you can almost certainly install - everything from your distribution's package repositories. As to - PostScript- and pdf viewers: epspdf tests for several popular viewers, but - the configuration screen also lets you specify viewers manually. - - Mac OS X - - Note. Version 0.5.x has not been tested with Tiger. - - Ruby and Tcl/Tk are already part of the operating system. Ghostscript is - included in MacTeX, but is also available via e.g. MacPorts. You can get - pdftops from MacPorts as part of either Poppler or xpdf. Another source is - [9]http://users.phg-online.de/tk/MOSXS/. - - If you want to compile xpdf yourself, which is not hard, you can ignore - warnings about X, Motif or FreeType not being found since these missing - libraries won't affect the compilation of pdftops. - - Windows (Windows 2000 and later) - - By itself, Windows lacks any of the prerequisites of epspdf. However, a - TeX installation may fill some of the gaps, and there is a special Windows - installer which takes care of the Ruby- and Tcl/Tk requirements. See the - table below: - - TeX distribution Installer Zipfile - (1) MikTeX and TeX Live ≥ 2008 include a hidden Ghostscript which is - always installed, and which epspdf knows how to find. Caveat: although - older versions of TeX Live include a Ghostscript installer, it is not - impossible to install an older TeX Live without Ghostscript, in which case - you have to provide a Ghostscript yourself. - (2) With TeX Live ≥ 2008, you are better off installing the TeX Live - package, which also gives you wrappers for epspdf and epspdftk for use on - the command-line and for on-the-fly conversions. You still need to install - Ruby and Tcl/Tk. - TeX Live[10](1) No additional Ruby, Tcl/Tk[11](2) - requirements - MiKTeX Pdftops (optional) Pdftops (optional); Ruby, - Tcl/Tk(optional) - Ghostscript, pdftops Ghostscript; - Other/None (optional) pdftops(optional), Ruby, - Tcl/Tk (optional) - - URLs for the prerequisites - - Ghostscript and GSview ([12]http://pages.cs.wisc.edu/~ghost/) - Contains sources and Windows binaries. The Windows binaries come - with standard GUI Windows setup programs. - - XPDF ([13]http://www.foolabs.com/xpdf/) - Sources and Windows binaries. The Windows binaries are packaged - into a zipfile, which has to be manually unpacked. The Configure - screen of epspdftk lets you browse for the chosen location. You - have to do this only once. - - XPDF, Mac OS X binaries ([14]http://users.phg-online.de/tk/MOSXS/) - These are universal binaries. - - TeX Live ([15]http://www.tug.org/texlive/) - TeX Live ≥ 2008 includes pdftops, Ghostscript and optionally - epspdf. - - MacTeX ([16]http://www.tug.org/mactex/) - MacTeX is based on TeX Live. Its set of add-ons includes - Ghostscript, and can be downloaded separately. - - The MacPorts Project ([17]http://www.macports.org/) - MacTeX has Poppler- and xpdf packages either of which include - pdftops. - - Ruby one-click installer for Windows ( - [18]http://rubyforge.org/projects/rubyinstaller/) + On Windows, both MikTeX and TeX Live already include a copy of + Ghostscript. TeX Live for Windows also includes pdftops. - Ruby source code ([19]http://www.ruby-lang.org/en/downloads/) - For those people who prefer to roll their own... - - Tcl Developer Xchange ([20]http://www.tcl.tk/) - - ActiveTcl from ActiveState ( - [21]http://activestate.com/Products/ActiveTcl/ + If you have MiKTeX and a copy of pdftops.exe, then you can point epspdf to + this file from within the GUI. You need to do this only once. Installation - First make sure that the prerequisites are met. Then: + If you have a sufficiently recent standalone TeX Live, just install the + package. Otherwise: - TeX Live ≥ 2008 + Unix/Linux - Use TeX Live's package manager tlmgr for installation. + Unpack the archive somewhere and create symlinks to epspdf.tlu and + epspdftk.tcl in a directory on your searchpath. Windows setup program - Download the [22]epspdftk setup program. 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. + This is a conventional Windows installer. If it does not find texlua.exe + on the searchpath then it gives a warning and a chance to abort. It + creates a shortcut to the epspdftk GUI and it also creates an uninstaller. - The setup program has been created with [23]NSIS. + It installs epspdftk in the form of a so-called starpack, which consists + of the epspdftk script and a Tcl/Tk runtime, wrapped into a single file. + The command-line script epspdf.tlu remains a separate file. + + This installer has been created with [18]NSIS. Windows zipfile - Download the [24]epspdf zip file, unpack it somewhere and create a - batchfile epspdf.bat such as + Download the epspdf zip file, unpack it somewhere and create a batchfile + epspdf.bat such as - ruby "<path_to_epspdf.rb>" %* + texlua "<path_to_epspdf.tlu>" %* - for epspdf.rb, and a batchfile epspdftk.bat + for epspdf.tlu, and a batchfile epspdftk.bat wish85 "<path_to_epspdftk.tcl>" %1 for epspdftk.tcl. The wish executable might also be named wish[.exe] or wish84[.exe]. The first command-line parameter will be interpreted as - startup directory for the file browser. Make sure that wish85, ruby and - these batchfiles are on your searchpath. - - Epspdf[tk] has been tested with Windows 2000, Windows XP and Windows 7. - - Unix/Linux - - Download the [25]tar.gz archive and unpack it in some directory. If you - plan to use epspdf.rb from the command-line, create a symlink to epspdf.rb - somewhere on your searchpath. - - You can do the same for epspdftk. The first command-line parameter will be - interpreted as startup directory for the file browser. - - Mac OS X - - Although you can install as for Unix/Linux, 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. - -Preview programs - - Windows - - Epspdftk will use the default Windows programs for PostScript and pdf. - - Unix/Linux - - Supported PostScript viewers include evince, gv and okular. These are also - listed as pdf viewers. Additional pdf viewers are xpdf, kpdf, epdfview and - acroread/Adobe Reader. You can also specify a previewer manually in the - configuration screen; see the [26]user manual.. - - Mac OS X + startup directory for the file browser. Make sure that wish85 and these + batchfiles are on your searchpath. - Epspdftk uses the default pdf viewer under OS X, usually Preview or Adobe - Reader. + Epspdf[tk] has been tested with Windows XP, Windows 7 and Windows 8. Files - * [27]epspdf.0.5.3.tgz preferred for Unix and Mac OS X - * [28]epspdf.0.5.3.zip preferred for Windows if you don't want to use + * [19]epspdf.0.6.0.tgz preferred for Unix and Mac OS X + * [20]epspdf.0.6.0.zip preferred for Windows if you don't want to use the installer below - * [29]epspdf.0.5.3.exe Windows setup program, including Ruby subset. The - epspdftk script has been packaged with a basic Tcl/Tk into a single - exe file (starpack). - * [30]epspdftk.0.5.3.dmg.gz compressed disk image with epspdftk wrapped - into a Mac OS X "app" - - Older releases - - * [31]epspdftk.0.4.3.dmg.gz; GUI doesn't work on Snow Leopard - * [32]epspdf.0.4.3.tgz for Unix and Mac OS X - * [33]epspdf.0.4.3.zip for Windows - * [34]epspdf.0.4.3.exe Windows setup program - * [35]epspdftk.0.4.2.dmg.gz; tested on Tiger and Leopard - * [36]epspdf.0.3.0.tgz for Unix and Mac OS X - * [37]epspdf.0.3.0.zip for Windows - * [38]epspdf.0.3.0.exe Windows setup program - * [39]epspdf.0.2.12.tgz for Unix, including Mac OS X - * [40]epspdf.0.2.12.zip for Windows - * [41]epspdf.0.2.12.exe Windows setup program - * [42]epspdf.0.2.01.tgz for Unix and Mac OS X - * [43]epspdf.0.2.01.zip for Windows - * [44]epspdf.0.2.exe, Windows setup program - * [45]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb + * [21]epspdf.0.6.0.exe Windows setup program which installs epspdf with + a buit-in Tcl/Tk runtime. Releases - 0.5.3 - Current version. Minor initialization fix for Windows. The - AppleScript wrapper for Mac OS X no longer starts a terminal. For - users of Linux/Unix, there is no reason to upgrade. - - 0.5.2 - Under Unix, wrapper scripts can now be replaced with simple - symlinks. - - 0.5.1 - Bug fix for boundingbox atend. - - 0.5 - Ruby/Tk GUI replaced with Tcl/Tk GUI. Starpack wrapper for Windows - setup version. - - 0.4.3 - Fixes for compatibility with Ruby 1.9 and, under Windows, for - newer Ghostscript versions. Documentation updates. - - 0.4.2 - More liberal documentation license. Slight documentation updates. - - 0.4.1 - 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 - 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 - 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. - - 0.2.12 - 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. - - 0.2.11 - Minor fixes. Changes in documentation. - - 0.2.10 - 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. - The File Open dialog remembers the last directory visited (between - calls, not between program sessions). - Changes in documentation. - - 0.2.01 - 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. - - 0.2 - Original release + * 0.6.0 Current version. Command-line component rewritten in texlua. + * [22]Legacy Ruby-based versions -------------------------------------------------------------------------- - Last revised: February 27, 2011 + Last revised: February 7, 2013 References Visible links 1. http://tex.aanhet.net/epspdf/ - 2. http://tex.aanhet.net/epspdf/index.html#features - 3. http://tex.aanhet.net/epspdf/index.html#prerequisites - 4. http://tex.aanhet.net/epspdf/index.html#install - 5. http://tex.aanhet.net/epspdf/index.html#preview + 2. http://tex.aanhet.net/epspdf/legacy.html + 3. http://tex.aanhet.net/epspdf/index.html#features + 4. http://tex.aanhet.net/epspdf/index.html#prerequisites + 5. http://tex.aanhet.net/epspdf/index.html#install 6. http://tex.aanhet.net/epspdf/index.html#files 7. http://tex.aanhet.net/epspdf/index.html#releases - 8. http://tex.aanhet.net/epspdf/epspdf.pdf - 9. http://users.phg-online.de/tk/MOSXS/ - 10. http://tex.aanhet.net/epspdf/index.html#tlnote - 11. http://tex.aanhet.net/epspdf/index.html#tlzipnote - 12. http://pages.cs.wisc.edu/~ghost/ + 8. http://tex.aanhet.net/epspdf/legacy.html + 9. http://www.tug.org/texlive/ + 10. http://miktex.org/ + 11. http://tex.aanhet.net/epspdf/legacy.html + 12. http://ghostscript.com/ 13. http://www.foolabs.com/xpdf/ - 14. http://users.phg-online.de/tk/MOSXS/ - 15. http://www.tug.org/texlive/ - 16. http://www.tug.org/mactex/ - 17. http://www.macports.org/ - 18. http://rubyforge.org/projects/rubyinstaller/ - 19. http://www.ruby-lang.org/en/downloads/ - 20. http://www.tcl.tk/ - 21. http://activestate.com/Products/ActiveTcl/ - 22. http://tex.aanhet.net/epspdf/epspdf.0.5.3.exe - 23. http://nsis.sourceforge.net/ - 24. http://tex.aanhet.net/epspdf/epspdf.0.5.3.zip - 25. http://tex.aanhet.net/epspdf/epspdf.0.5.3.tgz - 26. http://tex.aanhet.net/epspdf/epspdf.pdf - 27. http://tex.aanhet.net/epspdf/epspdf.0.5.3.tgz - 28. http://tex.aanhet.net/epspdf/epspdf.0.5.3.zip - 29. http://tex.aanhet.net/epspdf/epspdf.0.5.3.exe - 30. http://tex.aanhet.net/epspdf/epspdftk.0.5.3.dmg.gz - 31. http://tex.aanhet.net/epspdf/epspdftk.0.4.3.dmg.gz - 32. http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz - 33. http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip - 34. http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe - 35. http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz - 36. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz - 37. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip - 38. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe - 39. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz - 40. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip - 41. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe - 42. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz - 43. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip - 44. http://tex.aanhet.net/epspdf/epspdf.0.2.exe - 45. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip + 14. http://poppler.freedesktop.org/ + 15. http://www.tcl.tk/ + 16. http://wiki.tcl.tk/52 + 17. http://www.patthoyts.tk/tclkit/win32-ix86/ + 18. http://nsis.sourceforge.net/ + 19. http://tex.aanhet.net/epspdf/epspdf.0.6.03.tgz + 20. http://tex.aanhet.net/epspdf/epspdf.0.6.0.zip + 21. http://tex.aanhet.net/epspdf/epspdf.0.6.0.exe + 22. http://tex.aanhet.net/epspdf/legacy.html diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf Binary files differindex 9f40a14f8dc..0fcf41d73e1 100644 --- a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf +++ b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.texi b/Master/texmf-dist/doc/support/epspdf/epspdf.texi index 3564ea97765..d1150537efc 100644 --- a/Master/texmf-dist/doc/support/epspdf/epspdf.texi +++ b/Master/texmf-dist/doc/support/epspdf/epspdf.texi @@ -1,7 +1,13 @@ \input texinfo @c -*-texinfo -*- @c %**start of header @setfilename epspdf.info -@settitle Epspdf and epspdftk User Guide 0.5 +@settitle Epspdf and epspdftk User Guide 0.6 + +@dircategory TeX +@direntry +* EpsPDF: (epspdf). Portable GUI- and command-line EPS/PS/PDF conversion +@end direntry + @afourpaper @c %**end of header @@ -22,7 +28,7 @@ @hyphenation{epspdf-tk epspdf} @end iftex -@set version 0.5.3 +@set version 0.6.0 @set homepage http://tex.aanhet.net/epspdf/ @setchapternewpage off @@ -31,7 +37,7 @@ @copying This manual is for epspdf, version @value{version}. -Copyright @copyright{} 2006, 2008, 2009, 2010, 2011 Siep Kroonenberg. +Copyright @copyright{} 2006, 2008, 2009, 2010, 2011, 2013 Siep Kroonenberg. @quotation Copying and distribution of this file, with or without modification, @@ -47,7 +53,7 @@ without any warranty. @sp 2 @center @titlefont {Epspdf and epspdftk User Manual} @sp 1 -@center A multiplatform GUI- and command-line converter for [e]ps and pdf +@center A cross-platform GUI- and command-line converter for [e]ps and pdf @sp 2 @center Siep Kroonenberg (@email{n dot s dot kroonenberg at rug dot nl}) @vskip 0pt plus 1filll @@ -57,78 +63,96 @@ without any warranty. @contents @ifnottex -@node Top, Usage, (dir), (dir) +@node Top, What has changed?, (dir), (dir) @top Epspdf and epsdftk @insertcopying @end ifnottex @menu -* Usage:: -* Command-line usage:: -* Notes on PostScript and pdf:: -* Bitmapped graphics for @LaTeX{} and pdflatex:: -* Troubleshooting:: -* Change history:: +* What has changed?:: +* 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 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:: - -Windows - -* GUI use of sam2p and bmeps:: +* Linux:: +* Mac OS X:: +* Windows:: Troubleshooting -* Grayscaling fails:: -* Part of the graphic gets cut off:: -* Fonts look ugly:: -* Resources for troubleshooting:: +* Part of the graphic gets cut off:: +* Fonts look ugly:: +* The page has been converted to a bitmap:: +* Resources for troubleshooting:: Change history -* Version 0.5:: -* Version 0.4:: +* Version 0.6:: +* Version 0.5:: +* Version 0.4:: @end detailmenu @end menu -@node Usage, Command-line usage, Top, Top +@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 @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 @@ -142,16 +166,16 @@ 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. -@noindent @image{images/main_w32,,3in} +@noindent @image{images/main_w8,,3in} @iftex @hfill @end iftex -@image{images/cnv_osx,,3in} +@image{images/cnv_linux,,3in} @node Viewing, Conversion options, Overview, Usage @section Viewing -The View button at the bottom of the screen calls an appropriate +The View button at the bottom of the screen calls an external viewer. @i{Windows and OS X:} Epspdftk simply tries to use the default Open @@ -166,18 +190,15 @@ previewer for the current file. @node Conversion options, Converting, Viewing, Usage @section Conversion options -@anchor{gray}@i{Grayscaling:} Simple color figures can be converted to -grayscale. Bitmapped data won't be converted. If grayscaling doesn't -work even on non-bitmapped data, select the ``Try harder to -grayscale'' option. This may cause an extra pdf-PostScript roundtrip, -but grayscaling may still fail. +@anchor{gray}@i{Grayscaling:} Grayscaling is now done by Ghostscript +itself and should ``just work''. @i{Compute tight boundingbox:} This option is only available if a single page is converted. -@i{Page selection:} The only possibilities are selecting a -single page or selecting all pages. When converting to eps you are -restricted to a single page. +@i{Page selection:} The only possibilities are selecting a single page +or selecting all pages. Converting to eps implies selecting a single +page. For general PostScript files, there is no quick way to determine the number of pages, so the program may not check beforehand whether you @@ -185,7 +206,7 @@ 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. +a multistep conversion. @node Converting, The configuration screen, Conversion options, Usage @section Converting @@ -215,60 +236,48 @@ configured outside epspdf. @subsection Options for converting to pdf Double-check the setting ``Target use'' under ``Conversion to -pdf''. Choose ``prepress'' for pdfs which are target for commercial -printing. This option will try to embed all fonts, among other -things. Often, printshops insist on this. With luck, Ghostscript fonts -and system fonts will be used for fonts which were not originally -embedded. +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. On the other hand, you may prefer ``screen'' if file size is a concern. See also the Ghostscript documentation, in particular Use.htm and Ps2pdf.htm. +Specifying anything other than ``default'' may cause an additional +conversion step and possibly also loss of high-level structure. + +As to pdf versions: this is a trade-off between more features for higher +versions and better compatibility for lower versions -- although even +version 1.4 is far from bleeding-edge. Converting to a +lower version may lead to rasterization of vector data and (much) larger +file sizes. For prepress use, the printshop or publisher may require a +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. -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 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 -boundingbox for page dimensions -@item -When computing a boundingbox, it adds a small safety margin of 1pt to -the standard boundingbox, except where it would make any boundingbox -coordinate negative. -@end itemize +Under Windows and 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 @chapter Command-line usage -epspdf.rb is the backend of epspdftk, but it can also be used +epspdf.tlu is the backend of epspdftk, but it can also be used standalone. It shares configuration settings with epspdftk.tcl. -Under Windows, is strongly recommended to invoke epspdf.rb via a wrapper script -epspdf.bat on the search path, e.g. -@example -"@var{path_to_ruby.exe}" "@var{path_to_epspdf.rb}" %* -@end example - -The TeX Live package for epspdf already includes wrappers for Windows, -both for epspdf and for epspdftk. +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. -From version 0.5.2 on, there is no longer need for a wrapper script under -Unix/Linux/Mac OS X; a symlink on the searchpath to the actual script -suffices. - Basic usage: @example @@ -276,7 +285,7 @@ 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 @@ -285,53 +294,43 @@ epspdf [@var{options}] @var{infile} @var{outfile} Typing @kbd{epspdf --help} gives you the following summary: @example $ epspdf --help -Epspdf version 0.5.3 -Copyright (C) 2006, 2008, 2009, 2010, 2011 Siep Kroonenberg -Convert between [e]ps and pdf formats -Usage: epspdf.rb [options] infile [outfile] +Epspdf version 0.6.0 +Copyright (c) 2006, 2008, 2009, 2010, 2011, 2013 Siep Kroonenberg +Convert between [e]ps and pdf formats +Usage: epspdf[.tlu] [options] infile [outfile] Default for outfile is file.pdf if infile is file.eps or file.ps Default for outfile is file.eps if infile is file.pdf - -g, --gray, --grey Convert to grayscale; - success not guaranteed - -G, --GRAY, --GREY Try harder to convert to grayscale - -p, --pagenumber=PAGENUMBER Page to be converted or selected - -b, --bbox, --BoundingBox Compute tight boundingbox - -n, --no-hires Don't use hires boundingbox - -r, --hires Use hires boundingbox - -T, --target=TARGET Target use of pdf; one of - default, printer, prepress, screen, ebook - -N, --pdfversion=PDFVERSION Pdf version to be generated - -I Ignore pdftops even if available - (default: use if available) - -U Use pdftops if available - (overrides previous -I setting) - -C, --custom=CUSTOMOPTIONS Custom options for conversion to pdf, - view Use.htm and ps2pdf.htm from - the Ghostscript documentation set - -P, --psoptions=PSOPTIONS Options for pdftops; default -level3, - don't include -eps or page number options; - these will be generated by the program - -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, --version Prints version info - -h, --help Show this message +-p, --page, --pagenumber PNUM + Page number; must be a positive integer +-g, --grey, --gray, -G, --GREY, --GRAY + Convert to grayscale +-b, --bbox, --BoundingBox + Compute tight boundingbox +-T, --target TARGET + One of screen, ebook, printer, prepress or default +-N, --pdfversion VERSION + One of 1.2, 1.3, 1.4 or default +-U Use pdftops if available +-I Reverses the above +-s, --save Save some settings to configuration file +-d Debug: do not remove temp files +-v, --version + Display version info and exit +-h, --help Display this help message and exit @end example @node Notes on PostScript and pdf, Bitmapped graphics for @LaTeX{} and pdflatex, Command-line usage, Top @chapter Notes on PostScript and pdf @menu -* Bitmapped and vector:: -* Font embedding:: -* Eps preview headers:: -* Bounding- and other boxes:: -* Orientation:: -* Exporting PostScript 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 @@ -365,17 +364,10 @@ resolution. @section Font embedding When converting to pdf, Ghostscript handles font embedding differently -depending on the ``Target use'' option. For prepress, it embeds even -the standard fonts, including Times etc. Ghostscript has copies of these -fonts in case the PostScript file doesn't have them. For screen, it -doesn't embed standard fonts. - -You can embed fonts after the fact by converting pdf to eps or ps, and -back to pdf, with target use set to ``prepress''. However, don't try this -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. +depending on the ``Target use'' option. According to the Ghostscript +documentation, it embeds all fonts without exception for prepress- and +printer settings. Epspdf enforces this also for default settings. For +screen- and ebook settings, standard fonts such as Times may be omitted. @node Eps preview headers, Bounding- and other boxes, Font embedding, Notes on PostScript and pdf @section Eps preview headers @@ -394,43 +386,36 @@ file may have a mediabox, a trimbox and various other boxes. Ghostscript by itself normally converts the PostScript page -- which is anchored at (0,0) -- to the pdf mediabox. -When epspdf or a similar program converts eps to pdf, it adds code to -move the bottom left corner of the graphic to (0,0) and to set the page -to the size of the graphic. Anything outside the boundingbox should be -cut off. +Conversion from eps to pdf usually translates the bottom-left corner to +the (0,0) origin and sets the page to the size of the graphic. Anything +outside the boundingbox should be cut off. -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''. +I have seen Illustrator-generated pdf files with negative coordinates +for the lower-left corner. However, this does not seem to cause +problems. -@node Orientation, Exporting PostScript from Windows programs, Bounding- and other boxes, Notes on PostScript and pdf +@node Orientation, Exporting PostScript or pdf 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- and pdf files. This may result part of a graphic being cut off after conversion or even everything falling outside the page / mediabox / -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, , Orientation, Notes on PostScript and pdf -@section Exporting PostScript from Windows programs +boundingbox. -Often, the only way to get EPS or PostScript from a Windows program is -by ``printing'' 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 printer properties: choose -``Outline'' for font downloading and avoid the ``Optimize for speed'' -setting for PostScript Output Option. Try e.g. ``Archive'' -instead. These options can be found under the Advanced button. +@node Exporting PostScript or pdf from Windows programs, , Orientation, Notes on PostScript and pdf +@section Exporting PostScript or pdf from Windows programs -@image{images/ps_settings,2.5in} +Microsoft Office 2010 can now export to pdf, either the entire document +or a selection. This removes a major headache for Windows users. -Other possibilities are the TpX and wmf2eps programs, which both -have options to write clipboard contents to an emf file. Wmf2eps -uses a printer driver in the background. For faithful conversion, -pick wmf2eps; for subsequent editing, choose TpX. Both programs are -available from @url{http://mirror.ctan.org/}. +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 +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 +either. Try e.g. ``Archive'' instead. These options can be found under +the Advanced button. @node Bitmapped graphics for @LaTeX{} and pdflatex, Troubleshooting, Notes on PostScript and pdf, Top @chapter Bitmapped graphics for @LaTeX{} and pdflatex @@ -440,9 +425,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 @@ -460,14 +445,15 @@ 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. +GIMP can save in eps- and pdf format. @end table @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. +and save them as pdf or PostScript. In fact, in many cases it is an +excellent alternative to epspdf. @node Windows, , Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex @section Windows @@ -485,69 +471,45 @@ sam2p is distributed with TeX Live (Windows only), 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, , Windows, Windows -@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}. +With TeX Live, you can convert to eps by right-clicking an image in +Windows Explorer and ``open'' with @emph{bitmap2eps}, which uses sam2p +or bmeps in the background. @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:: -* Resources for troubleshooting:: +* Part of the graphic gets cut off:: +* Fonts look ugly:: +* The page has been converted to a bitmap:: +* Resources for troubleshooting:: @end menu -@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, Fonts look ugly, Grayscaling fails, Troubleshooting +@node Part of the graphic gets cut off, Fonts look ugly, Troubleshooting, Troubleshooting @section Part of the graphic gets cut off -Things to try: -@itemize @bullet -@item If the PostScript file was generated with the Windows PostScript driver, experiment with the PostScript Output option. Don't choose Optimize for Speed. -@item -Replace the extension with ``.ps'' and let epspdf generate a -boundingbox. -@item -Boundingbox calculations may be slightly inaccurate where text is -involved. If just a sliver is cut off, let epspdf ignore the -high-resolutuion boundingbox. Command-line option: ``-n'' or -``--no-hires''. -@end itemize -@node Fonts look ugly, Resources for troubleshooting, Part of the graphic gets cut off, Troubleshooting +@node Fonts look ugly, The page has been converted to a bitmap, 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. +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. + +@node The page has been converted to a bitmap, Resources for troubleshooting, 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 +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, , Fonts look ugly, Troubleshooting +@node Resources for troubleshooting, , The page has been converted to a bitmap, Troubleshooting @section Resources for troubleshooting @i{Logfile.} The GUI has a button for viewing log output. This same @@ -560,9 +522,7 @@ name}\AppData\Roaming}. Otherwise, open a command prompt and type @kbd{echo %APPDATA%}, which will produce this information. 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. +calls plus error information. @i{Temporary files.} The temporary files may give clues as well. Uncheck the button ``Remove temp files'', or for the @@ -579,11 +539,33 @@ for Windows there is a file pdftops.txt in the distribution zip. @chapter Change history @menu -* Version 0.5:: -* Version 0.4:: +* Version 0.6:: +* Version 0.5:: +* Version 0.4:: @end menu -@node Version 0.5, Version 0.4, Change history, Change history +@node Version 0.6, Version 0.5, Change history, Change history +@section Version 0.6 + +The command-line backend component has been rewritten in texlua and +therefore no longer needs an external scripting language. + +Grayscaling is now done by Ghostscript's color options for pdf +output. This also works for bitmaps. + +Croppping of pdfs is now accomplished by running luatex on a suitable +wrapper file (same method as Heiko Oberdiek's pdfcrop). Such a +conversion preserves advanced features which might otherwise get lost +during a PostScript round-trip. + +I no longer own a Mac, and therefore no longer try to provide an +AppleScript wrapper. + +The current version has no provisions for custom Ghostscript- or pdftops +parameters. I may of may not re-add those in a future update. The +corresponding command-line options are accepted but have no effect. + +@node Version 0.5, Version 0.4, Version 0.6, Change history @section Version 0.5 The GUI has been rewritten in Tcl/Tk, removing the dependence on the diff --git a/Master/texmf-dist/doc/support/epspdf/images/cnv_linux.png b/Master/texmf-dist/doc/support/epspdf/images/cnv_linux.png Binary files differnew file mode 100644 index 00000000000..4ed7a91a282 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/images/cnv_linux.png diff --git a/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png b/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png Binary files differdeleted file mode 100644 index aed566aea2e..00000000000 --- a/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png +++ /dev/null diff --git a/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png b/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png Binary files differindex 8f6036867f5..38269c84036 100644 --- a/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png +++ b/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png diff --git a/Master/texmf-dist/doc/support/epspdf/images/main_w32.png b/Master/texmf-dist/doc/support/epspdf/images/main_w32.png Binary files differdeleted file mode 100644 index 946a80e477f..00000000000 --- a/Master/texmf-dist/doc/support/epspdf/images/main_w32.png +++ /dev/null diff --git a/Master/texmf-dist/doc/support/epspdf/images/main_w8.png b/Master/texmf-dist/doc/support/epspdf/images/main_w8.png Binary files differnew file mode 100644 index 00000000000..89ca3dc04ee --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/images/main_w8.png diff --git a/Master/texmf-dist/doc/support/epspdf/images/ps_settings.png b/Master/texmf-dist/doc/support/epspdf/images/ps_settings.png Binary files differdeleted file mode 100644 index 4648a855386..00000000000 --- a/Master/texmf-dist/doc/support/epspdf/images/ps_settings.png +++ /dev/null diff --git a/Master/texmf-dist/doc/support/epspdf/index.html b/Master/texmf-dist/doc/support/epspdf/index.html index 5e8cd48eb9e..7c6d18d0d15 100644 --- a/Master/texmf-dist/doc/support/epspdf/index.html +++ b/Master/texmf-dist/doc/support/epspdf/index.html @@ -31,16 +31,17 @@ dot nl</tt></i></p> <p><a href="http://tex.aanhet.net/epspdf/">Current online version of this page</a></p> +<p><a href="http://tex.aanhet.net/epspdf/legacy.html">Legacy +Ruby-based versions</a></p> + <h2>Table of Contents</h2> <ul> <li><a href="#features">Features</a></li> <li><a href="#prerequisites">Prerequisites</a></li> <li><a href="#install">Installation</a></li> -<li><a href="#preview">Preview programs</a></li> <li><a href="#files">Files</a></li> <li><a href="#releases">Releases</a></li> -<li><a href="epspdf.pdf">User Manual</a></li> </ul> <h2><a name="features"/>Features</h2> @@ -52,11 +53,10 @@ this page</a></p> <li>Also converts from pdf back to PostScript and eps</li> <li>Removal of preview headers from eps files</li> <li>Cropping extra whitespace</li> -<li>Grayscaling (sometimes)</li> +<li>Grayscaling</li> <li>GUI- and command-line version</li> <li>GUI-configurable preferences</li> -<li>Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS -X</li> +<li>Multiplatform: works unchanged on Windows and Unix/Linux</li> <li>Support for TeX Live and MiKTeX</li> </ul> @@ -72,23 +72,24 @@ GUI.</p> <p>Epspdftk adds a GUI, with buttons to select options and with dialogs for opening and saving files.</p> -<p>A lot more can be done if you can round-trip between PostScript -and pdf. Although Ghostscript can go from pdf to PostScript, pdftops -does a much better job converting text back to PostScript. This -opens several new possibilities: grayscaling and computing a better -boundingbox for either eps- or pdf graphics, and page selection from -multipage PostScript- and pdf documents. Epspdf will use pdftops if -it can find it, and silently does whatever back-and-forth -conversions are necessary.</p> +<p>A lot more can be done with multistep conversions: grayscaling, +page selection, computing a tight boundingbox. People who depend on +PSTricks will appreciate the option to go from pdf to +PostScript.</p> + +<p>Where it makes sense, epspdf uses additional software for a +better outcome.</p> -<p>The command-line program epspdf is written in Ruby. Epspdftk, its -GUI companion, in Tcl/Tk. Versions prior to 0.5 were written in -Ruby/Tk.</p> +<p>The command-line program epspdf is written in texlua, which is +already part of recent versions of MikTeX and TeX Live. Versions <a +href="http://tex.aanhet.net/epspdf/legacy.html">prior to 0.6</a> +were written in Ruby. Epspdftk, its GUI companion, is written in in +Tcl/Tk.</p> -<p>Starting with the 2008 edition, TeX Live includes epspdf as -an optional package, complete with wrapper scripts epspdf and -epspdftk which can be called from the command-line without further -ado.</p> +<p>Starting with the 2008 edition, TeX Live includes epspdf in some +form as an optional package, complete with wrapper scripts epspdf +and epspdftk which can be called from the command-line without +further ado.</p> <p>There is also a third-party LaTeX package epspdfconversion which uses epspdf for on-the-fly conversion of eps graphics to pdf, with @@ -100,159 +101,75 @@ ado.</p> <p>These are the required and optional prerequisites, which will be checked for when epspdf starts:</p> <ul> -<li>Ghostscript</li> -<li>pdftops from the xpdf suite, strongly recommended for better - pdf to PostScript conversions</li> -<li>Ruby 1.8.<i>x</i> or 1.9.<i>x</i></li> -<li>Tcl/Tk is only required for the GUI interface. Versions 8.4 - and 8.5 have been tested.</li> -<li>Optional: viewers for PostScript and pdf</li> -</ul> - -<p>You may not have to install all of these yourself.</p> - -<h3>Linux</h3> - -<p>On a current Linux distribution you can almost certainly install -everything from your distribution's package repositories. As to -PostScript- and pdf viewers: epspdf tests for several popular -viewers, but the configuration screen also lets you specify viewers -manually.</p> - -<h3>Mac OS X</h3> - -<p><b>Note.</b> Version 0.5.x has not been tested with Tiger.</p> - -<p>Ruby and Tcl/Tk are already part of the operating -system. Ghostscript is included in MacTeX, but is also available via -e.g. MacPorts. You can get pdftops from MacPorts as part of either -Poppler or xpdf. Another source is <a -href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/</a>.</p> - -<p>If you want to compile xpdf yourself, which is not hard, you -can ignore warnings about X, Motif or FreeType not being found since -these missing libraries won't affect the compilation of pdftops.</p> - -<h3>Windows (Windows 2000 and later)</h3> - -<p>By itself, Windows lacks any of the prerequisites of -epspdf. However, a TeX installation may fill some of the gaps, and -there is a special Windows installer which takes care of the Ruby- -and Tcl/Tk requirements. See the table below:</p> - -<table id="prereq"> - - <thead><tr><th class="fcol">TeX - distribution</th><th>Installer</th><th>Zipfile</th></tr></thead> - - <tfoot> - <tr><td colspan="3"><b><a name="tlnote" - class="fineprint"> (1)</a></b> MikTeX and TeX Live ≥ 2008 include a - hidden Ghostscript which is always installed, and which epspdf - knows how to find. Caveat: although older versions of TeX Live - include a Ghostscript installer, it is not impossible to install an - older TeX Live without Ghostscript, in which case you have to - provide a Ghostscript yourself.</td></tr> - - <tr><td colspan="3"><b><a name="tlzipnote" - class="fineprint"> (2)</a></b> With TeX Live ≥ 2008, you are - better off installing the TeX Live package, which also gives you - wrappers for epspdf and epspdftk for use on the command-line and - for on-the-fly conversions. You still need to - install Ruby and Tcl/Tk.</td></tr> - </tfoot> - - <tr><th class="fcol">TeX Live<a href="#tlnote">(1)</a></th><td>No additional - requirements</td> <td>Ruby, Tcl/Tk<a href="#tlzipnote">(2)</a></td></tr> - - <tr><th class="fcol">MiKTeX</th><td>Pdftops (optional)</td> <td>Pdftops - (optional); Ruby, Tcl/Tk(optional)</td></tr> - - <tr><th class="fcol">Other/None</th><td>Ghostscript, pdftops (optional)</td> - <td>Ghostscript; pdftops(optional), Ruby, Tcl/Tk - (optional)</td></tr> - -</table> - -<h3>URLs for the prerequisites</h3> - -<dl> - -<dt>Ghostscript and GSview (<a - href="http://pages.cs.wisc.edu/~ghost/">http://pages.cs.wisc.edu/~ghost/</a>)</dt> - <dd>Contains sources and Windows binaries. The Windows binaries - come with standard GUI Windows setup programs.</dd> - -<dt>XPDF (<a - href="http://www.foolabs.com/xpdf/">http://www.foolabs.com/xpdf/</a>)</dt> - <dd> Sources and Windows binaries. The Windows binaries are - packaged into a zipfile, which has to be manually unpacked. The - Configure screen of epspdftk lets you browse for the chosen - location. You have to do this only once. </dd> - -<dt>XPDF, Mac OS X binaries (<a - href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/</a>)</dt> - <dd>These are universal binaries.</dd> -<dt>TeX Live (<a - href="http://www.tug.org/texlive/">http://www.tug.org/texlive/</a>)</dt> - <dd>TeX Live ≥ 2008 includes pdftops, Ghostscript and - optionally epspdf.</dd> +<li>A recent TeX installation, either <a + href="http://www.tug.org/texlive/">TeX Live</a> or <a + href="http://miktex.org/">MikTeX</a>. If this is not an option, + get a <a href="http://tex.aanhet.net/epspdf/legacy.html">legacy + version</a> of epspdf instead.</li> -<dt>MacTeX (<a - href="http://www.tug.org/mactex/">http://www.tug.org/mactex/</a>)</dt> - <dd>MacTeX is based on TeX Live. Its set of add-ons includes - Ghostscript, and can be downloaded separately.</dd> +<li><a href="http://ghostscript.com">Ghostscript</a></li> -<dt>The MacPorts Project (<a - href="http://www.macports.org/">http://www.macports.org/</a>)</dt> - <dd>MacTeX has Poppler- and xpdf packages either of which include - pdftops.</dd> +<li>Optional: pdftops from the <a + href="http://www.foolabs.com/xpdf/">xpdf suite</a> or from the <a + href="http://poppler.freedesktop.org/">Poppler + utilities</a>. Pdftops may do a better job of preserving scalable + fonts when converting from pdf to ps.</li> -<dt>Ruby one-click installer for Windows (<a - href="http://rubyforge.org/projects/rubyinstaller/"> - http://rubyforge.org/projects/rubyinstaller/</a>)</dt> +<li><a href="http://www.tcl.tk/">Tcl/Tk</a> for the GUI + interface. Versions 8.4 and 8.5 have been tested. A single-file <a + href="http://wiki.tcl.tk/52">TclKit</a> runtime is + sufficient. Recent <a + href="http://www.patthoyts.tk/tclkit/win32-ix86/">Windows + precompiled tclkit binaries</a> are available.</li> -<dt>Ruby source code (<a - href="http://www.ruby-lang.org/en/downloads/">http://www.ruby-lang.org/en/downloads/</a>)</dt><dd>For - those people who prefer to roll their own...</dd> +<li>Optional: viewers for PostScript and pdf</li> -<dt>Tcl Developer Xchange (<a href="http://www.tcl.tk/">http://www.tcl.tk/</a>)</dt> +</ul> -<dt>ActiveTcl from ActiveState (<a - href="http://activestate.com/Products/ActiveTcl/"> - http://activestate.com/Products/ActiveTcl/</a></dt> -</dl> +<p>On Windows, both MikTeX and TeX Live already include a copy of +Ghostscript. TeX Live for Windows also includes pdftops.</p> +<p>If you have MiKTeX and a copy of pdftops.exe, then you can point +epspdf to this file from within the GUI. You need to do this only +once.</p> <h2><a name="install"/>Installation</h2> -<p>First make sure that the prerequisites are met. Then:</p> +<p>If you have a sufficiently recent standalone TeX Live, just + install the package. Otherwise:</p> -<h3>TeX Live ≥ 2008</h3> +<h3>Unix/Linux</h3> -<p>Use TeX Live's package manager tlmgr for installation.</p> +<p>Unpack the archive somewhere and create symlinks to epspdf.tlu + and epspdftk.tcl in a directory on your searchpath.</p> <h3>Windows setup program</h3> -<p>Download the <a href="epspdf.0.5.3.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> +<p>This is a conventional Windows installer. If it does not find +texlua.exe on the searchpath then it gives a warning and a chance to +abort. It creates a shortcut to the epspdftk GUI and it also creates +an uninstaller.</p> + +<p>It installs epspdftk in the form of a so-called +<em>starpack</em>, which +consists of the epspdftk script and a Tcl/Tk runtime, wrapped into +a single file. The command-line script epspdf.tlu remains a separate +file.</p> -<p>The setup program has been created -with <a href="http://nsis.sourceforge.net/">NSIS</a>.</p> +<p>This installer has been created with <a +href="http://nsis.sourceforge.net/">NSIS</a>.</p> <h3>Windows zipfile</h3> -<p>Download the <a href="epspdf.0.5.3.zip">epspdf zip file</a>, -unpack it somewhere and create a batchfile epspdf.bat such as</p> +<p>Download the epspdf zip file, unpack it somewhere and create a +batchfile epspdf.bat such as</p> <pre> -ruby "<path_to_epspdf.rb>" %* +texlua "<path_to_epspdf.tlu>" %* </pre> -<p>for epspdf.rb, and a batchfile epspdftk.bat</p> +<p>for epspdf.tlu, and a batchfile epspdftk.bat</p> <pre> wish85 "<path_to_epspdftk.tcl>" %1 @@ -261,176 +178,39 @@ wish85 "<path_to_epspdftk.tcl>" %1 <p>for epspdftk.tcl. The wish executable might also be named wish[.exe] or wish84[.exe]. The first command-line parameter will be interpreted as startup directory for the file browser. Make - sure that wish85, ruby and these batchfiles are on your - searchpath.</p> - -<p>Epspdf[tk] has been tested with Windows 2000, Windows XP and -Windows 7.</p> - -<h3>Unix/Linux</h3> - -<p>Download the <a href="epspdf.0.5.3.tgz">tar.gz archive</a> and -unpack it in some directory. If you plan to use epspdf.rb from the -command-line, create a symlink to <tt>epspdf.rb</tt> somewhere on -your searchpath.</p> - -<p>You can do the same for epspdftk. The first command-line -parameter will be interpreted as startup directory for the file -browser.</p> - -<h3>Mac OS X</h3> - -<p>Although you can install as for Unix/Linux, 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 -problem files.</p> - -<h2><a name="preview"/>Preview programs</h2> + sure that wish85 and these batchfiles are on your searchpath.</p> -<h3>Windows</h3> - -<p>Epspdftk will use the default Windows programs for PostScript and -pdf.</p> - -<h3>Unix/Linux</h3> - -<p>Supported PostScript viewers include evince, gv and -okular. These are also listed as pdf viewers. Additional pdf viewers -are xpdf, kpdf, epdfview and acroread/Adobe Reader. You can also -specify a previewer manually in the configuration screen; see the <a -href="epspdf.pdf"> user manual.</a>.</p> - -<h3>Mac OS X</h3> - -<p>Epspdftk uses the default pdf viewer under OS X, usually Preview -or Adobe Reader.</p> +<p>Epspdf[tk] has been tested with Windows XP, Windows 7 and +Windows 8.</p> <h2><a name="files"/>Files</h2> <ul> -<li><a href="epspdf.0.5.3.tgz">epspdf.0.5.3.tgz</a> preferred for Unix + + <li><a href="epspdf.0.6.03.tgz">epspdf.0.6.0.tgz</a> preferred for Unix and Mac OS X</li> -<li><a href="epspdf.0.5.3.zip">epspdf.0.5.3.zip</a> preferred for +<li><a href="epspdf.0.6.0.zip">epspdf.0.6.0.zip</a> preferred for Windows if you don't want to use the installer below</li> -<li><a href="epspdf.0.5.3.exe">epspdf.0.5.3.exe</a> Windows setup - program, including Ruby subset. The epspdftk script has been - packaged with a basic Tcl/Tk into a single exe file (starpack).</li> +<li><a href="epspdf.0.6.0.exe">epspdf.0.6.0.exe</a> Windows setup + program which installs epspdf with a buit-in Tcl/Tk runtime.</li> -<li><a href="epspdftk.0.5.3.dmg.gz">epspdftk.0.5.3.dmg.gz</a> - compressed disk image with epspdftk wrapped into a Mac OS X <q>app</q></li> </ul> -<h3>Older releases</h3> +<h2><a name="releases"/>Releases</h2> + <ul> -<li><a href="http://tex.aanhet.net/epspdf/epspdftk.0.4.3.dmg.gz">epspdftk.0.4.3.dmg.gz</a>; - GUI doesn't work on Snow Leopard</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz">epspdf.0.4.3.tgz</a> -for Unix and Mac OS X</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip">epspdf.0.4.3.zip</a> -for Windows</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe">epspdf.0.4.3.exe</a> -Windows setup program</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz">epspdftk.0.4.2.dmg.gz</a>; - tested on Tiger and Leopard</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz">epspdf.0.3.0.tgz</a> -for Unix and Mac OS X</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip">epspdf.0.3.0.zip</a> -for Windows</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe">epspdf.0.3.0.exe</a> -Windows setup program</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a> -for Unix, including Mac OS X</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip">epspdf.0.2.12.zip</a> -for Windows</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe">epspdf.0.2.12.exe</a> -Windows setup program</li> -<li><a href="http:/tex.aanhet.net/epspdf/epspdf.0.2.01.tgz">epspdf.0.2.01.tgz</a> -for Unix - and Mac OS X</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip">epspdf.0.2.01.zip</a> -for Windows</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.exe">epspdf.0.2.exe</a>, -Windows setup program</li> -<li><a href="http://tex.aanhet.net/epspdf/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> +<li>0.6.0 Current version. Command-line component +rewritten in texlua.</li> + +<li><a href="http://tex.aanhet.net/epspdf/legacy.html">Legacy +Ruby-based versions</a></li> -<dl><dt>0.5.3</dt><dd>Current version. Minor initialization fix for - Windows. The AppleScript wrapper for Mac OS X no longer starts a - terminal. For users of Linux/Unix, there is no reason to - upgrade.</dd> - -<dt>0.5.2</dt><dd>Under Unix, wrapper scripts can now be replaced - with simple symlinks.</dd> - -<dt>0.5.1</dt><dd>Bug fix for boundingbox atend.</dd> - -<dt>0.5</dt><dd>Ruby/Tk GUI replaced with Tcl/Tk GUI. Starpack - wrapper for Windows setup version.</dd> - -<dt>0.4.3</dt><dd>Fixes for compatibility with Ruby 1.9 and, under - Windows, for newer Ghostscript versions. Documentation - updates.</dd> - -<dt>0.4.2</dt><dd>More liberal documentation - license. Slight documentation updates.</dd> - -<dt>0.4.1</dt><dd>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> - -<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> - -<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> - -<dt>0.2</dt><dd>Original release</dd> -</dl> +</ul> <hr/> -<p class="fineprint">Last revised: February 27, 2011</p> +<p class="fineprint">Last revised: February 7, 2013</p> </body></html> |
