diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/epspdf/doc |
Initial commit
Diffstat (limited to 'support/epspdf/doc')
-rw-r--r-- | support/epspdf/doc/COPYING | 339 | ||||
-rw-r--r-- | support/epspdf/doc/Changelog | 189 | ||||
-rw-r--r-- | support/epspdf/doc/epspdf.pdf | bin | 0 -> 218565 bytes | |||
-rw-r--r-- | support/epspdf/doc/epspdf.texi | 680 | ||||
-rw-r--r-- | support/epspdf/doc/images/cnv_linux.png | bin | 0 -> 21912 bytes | |||
-rw-r--r-- | support/epspdf/doc/images/config_lnx.png | bin | 0 -> 18740 bytes | |||
-rw-r--r-- | support/epspdf/doc/images/epspdf.png | bin | 0 -> 4126 bytes | |||
-rw-r--r-- | support/epspdf/doc/images/logo.pdf | bin | 0 -> 5388 bytes | |||
-rw-r--r-- | support/epspdf/doc/images/logo.svg | 222 | ||||
-rw-r--r-- | support/epspdf/doc/images/main_wx.png | bin | 0 -> 12164 bytes | |||
-rw-r--r-- | support/epspdf/doc/pstexi.tex | 49 |
11 files changed, 1479 insertions, 0 deletions
diff --git a/support/epspdf/doc/COPYING b/support/epspdf/doc/COPYING new file mode 100644 index 0000000000..1bf1526387 --- /dev/null +++ b/support/epspdf/doc/COPYING @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + Appendix: How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + <one line to give the program's name and a brief idea of what it does.> + Copyright (C) 19yy <name of author> + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) 19yy name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + <signature of Ty Coon>, 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. diff --git a/support/epspdf/doc/Changelog b/support/epspdf/doc/Changelog new file mode 100644 index 0000000000..cf31923aec --- /dev/null +++ b/support/epspdf/doc/Changelog @@ -0,0 +1,189 @@ +2019-02-01 0.6.4 + + pdf_crop: epdf replaced by pdfe if available (LuaTeX >= 1.9) + + Better handling of pdfs with negative coordinates in MediaBox and + some corner cases + + Ghostscript: support for later versions of pdf format + + Eps files with large boundingbox coordinates: added a -r300 + resolution parameter when asking Ghostscript to calculate their + boundingbox. Hopefully, this prevents grossly inaccurate results. + + Pdftops on Windows: always use pdftops from searchpath + + Some refactoring + + epspdftk: no more black console windows under windows + + epspdftk: use of ttk widgets; no more support for Tk versions + prior to 8.5. + + epspdftk: updated selection of viewers under `plain unix' + + Updates to the manual + +2016-05-06 0.6.3 + + Pdf page selection and cropping: simplified and updated the + generated TeX file to be compiled by LuaTeX. Now compatible with + both LuaTeX 0.95 and older versions. + + Windows: test whether pdftops is in TeX binary directory. If so, + do not offer a configuration option for the location of pdftops. + + Minor tweaks to the manual + + Windows executable once more based on Tclkits from Patrick Thoyts + at http://www.patthoyts.tk/tclkit/ + +2015-10-28 0.6.2 + + Replace obsolete luatex primitives \pdfpagewidth and + \pdfpageheight with \pagewidth and \pageheight respectively + + Minor tweaks to the manual + +2014-11-30 0.6.1 + + Windows ececutable based on a newer tclkit, from the KitCreator + project (http://kitcreator.rkeene.org/fossil/index). This + necessitated a new test for being a starpack, viz. by checking the + name of the executable, instead of the previous test for + tclkitpath. + + Epspdf now modifies the process searchpath and calls luatex, + ghostscript and pdftops by basename to sidestep problems with + spaces in path names, especially on Windows. + + Removed use of cmd /c, which was a bug workaround for some old + version of LuaTeX. + + Some code cleanup(?): fewer globals, all non-trivial + initialization in one block following the function definitions. + + The temporary directory has been placed under %TEMP% under + Windows, and under either $TEMPDIR or /tmp on other systems. + + To give Windows >= Vista a better chance to remove temporary + files, epspdf first waits one second. + + Check for epswrite/eps2write ghostscript output devices. + + epspdftk.tcl: updated list of Unix PostScript- and pdf viewers. + +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. + + AppData is once more read from the environment, because texlua + does not provide access to the registry. + + 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 + always be available as environment variable + + AppleScript wrapper now uses `do shell script' with some + heuristic path additions, instead of `tell application Terminal + do script' + +2010-12-25 0.5.2 + + Eliminate need for wrappers under Unix, as suggested by + Peter Breitenlohner; update manual + +2010-05-09 0.5.1 + + Bug fix: test for i_hrbb >= 0 instead of true + +2010-02-28 0.5 + + GUI module replaced with separate Tcl/Tk frontend. To this end, + epspdf.rb now has options for reading/writing settings over + stdin/stdout. + + Epspdf.rb now also aborts on Unix if Ghostscript is missing. + + Both logs and config moved to subdirectory: %APPDATA%/epspdf + under Windows, $HOME/.epspdf otherwise. On-demand log window. + + Logo/icon added + + Documentation updates + + Manual in info format is now part of the distribution + +2009-09-11 0.4.3 + + Patch for Ruby 1.9 compatibility (Ruben Stein). Patch for + compatibility with newer Ghostscript under Windows. Fix for option + gRAY with ps => pdf. `epspdf --version' now prints + version. Documentation updates. + +2009-09-11 0.4.2 + + More liberal documentation license. Slight documentation updates. + +2009-03-12 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. + +2009-03-02 0.4 + + Handles hires boundingbox. Can use MikTeX Ghostscript. Updated, + streamlined Ruby subset. Simpler testing of prerequisites. In + particular, no pdftops version testing. More tolerant boundingbox + parsing. Windows: View with... button. OS X: use open command for + viewing. Converting... text in main window. + +2008-07-28 0.3 + + TeX Live integration. Packaging for CTAN. Bug fixes: more tolerant + pdftops version testing; no inappropriate warning about missing + viewers under Mac OS X. + +2006-11-20 0.2.12 + + Bug fixes: log rotation now works. Solved quoting problems under + w2k by using short names. Minor updates to documentation. + +2006-11-03 0.2.11 + + Minor fixes. Changes in documentation. + +2006-10-29 0.2.10 + + Computed boundingbox padded by 1pt, to prevent some + cropping. Amount bb_spread is manually configurable. The File Open + dialog remembers the last directory visited (between function + calls, not between program sessions). Changes in documentation. + +2006-08-14 0.2.01 + + epspdf.app now packaged separately. Bug fix to Applescript applet + epspdf.app for starting up epspdftk under Mac OS X. + +2006-07-30 0.2 + + Original release diff --git a/support/epspdf/doc/epspdf.pdf b/support/epspdf/doc/epspdf.pdf Binary files differnew file mode 100644 index 0000000000..92ff2e1311 --- /dev/null +++ b/support/epspdf/doc/epspdf.pdf diff --git a/support/epspdf/doc/epspdf.texi b/support/epspdf/doc/epspdf.texi new file mode 100644 index 0000000000..1c87952cae --- /dev/null +++ b/support/epspdf/doc/epspdf.texi @@ -0,0 +1,680 @@ +\input texinfo @c -*-texinfo -*- +@c %**start of header +@setfilename epspdf.info +@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 + +@c Actually, we do not produce html anymore +@ifhtml +@alias chapter = unnumbered +@alias section = unnumberedsec +@alias subsection = unnumberedsubsec +@end ifhtml + +@tex +\input pstexi +@end tex + +@iftex +@textfonts +@rm +@raggedbottom +@hyphenation{epspdf-tk epspdf} +@end iftex + +@set version 0.6.4 + +@setchapternewpage off +@paragraphindent none + +@copying +This manual is for epspdf and epspdftk, version @value{version}. + +Copyright @copyright{} 2006-2019 Siep Kroonenberg. + +@quotation +Copying and distribution of this file, with or without modification, +are permitted in any medium without royalty provided the copyright +notice and this notice are preserved. This file is offered as-is, +without any warranty. +@end quotation +@end copying + +@titlepage +@sp 1 +@ifnotinfo +@center @image{images/logo,,.4in} +@end ifnotinfo +@sp 2 +@center @titlefont {Epspdf and epspdftk User Manual} +@sp 1 +@center A cross-platform GUI- and command-line converter for [e]ps and pdf +@sp 2 +@center Siep Kroonenberg (@email{siepo at bitmuis dot nl}) +@vskip 0pt plus 1filll +@insertcopying +@end titlepage + +@contents + +@ifnottex +@node Top, Usage, (dir), (dir) +@top Epspdf and epspdftk + +@insertcopying +@end ifnottex + +@menu +* Usage:: +* Command-line usage:: +* Notes on PostScript and pdf:: +* Bitmapped graphics for @LaTeX{} and pdflatex:: +* Troubleshooting:: +* Requirements:: +* Change history:: + +@detailmenu + --- The Detailed Node Listing --- + +Usage + +* Overview:: +* Viewing:: +* Conversion options:: +* Converting:: +* The configuration screen:: + +Command-line usage + +* Option summary:: + +Notes on PostScript and pdf + +* Bitmapped and vector:: +* Font embedding:: +* Eps preview headers:: +* Bounding- and other boxes:: +* Orientation:: +* Exporting PostScript or pdf from Windows programs:: + +Bitmapped graphics for @LaTeX{} and pdflatex + +* Linux:: +* Mac OS:: +* Windows:: + +Troubleshooting + +* No options for output format visible:: +* Ghostscript stackunderflow error:: +* Part of the graphic gets cut off:: +* Fonts look ugly:: +* The page has been converted to a bitmap:: +* Temporary files are not removed:: +* Resources for troubleshooting:: + +Change history + +* Version 6.4:: +* Version 0.6:: +* Version 0.5:: +* Version 0.4:: + +@end detailmenu +@end menu + +@node Usage, Command-line usage, Top, Top +@chapter Usage + +@menu +* Overview:: +* Viewing:: +* Conversion options:: +* Converting:: +* The configuration screen:: +@end menu + +@node Overview, Viewing, Usage, Usage +@section Overview + +Epspdftk is a GUI program that converts files between eps, pdf and +general PostScript in any direction. + +It lets you interactively select a file, set conversion options, and +save in the same of another format. A configuration screen offers +some additional conversion options. + +@ifnotinfo +@noindent @image{images/main_wx,,2.9in} +@iftex +@hfill +@end iftex +@image{images/cnv_linux,,2.9in} +@end ifnotinfo + +@node Viewing, Conversion options, Overview, Usage +@section Viewing + +The View button at the bottom of the screen invokes an +external viewer. + +@i{Windows and Mac OS:} Epspdftk simply tries to use the default Open +command. + +Under Linux the PostScript- and pdf viewers are +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, Converting, Viewing, Usage +@section Conversion options + +@itemize +@item +@anchor{gray}Grayscaling + +@item +Compute tight boundingbox. This option is only available +if a single page is converted. + +@item +Page selection. The only possibilities are selecting a single page +or selecting all pages. Converting to eps implies selecting a single +page. +@end itemize + +@i{Note.} 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 +anyway. + +Specifying options such as grayscaling or page selection may require +a multistep conversion. + +@node Converting, The configuration screen, Conversion options, Usage +@section Converting + +The Convert and save@dots{} 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 -- if epspdftk +thinks that there is a suitable viewer. + +@node The configuration screen, , Converting, Usage +@section The configuration screen + +@ifnotinfo +@image{images/config_lnx,3in} +@end ifnotinfo + +Epspdftk also has a configuration screen. The settings here are +preserved between sessions. + +@subsection Configuring viewers + +Under Unix, the preferred PostScript- and pdf viewers can be configured +in this screen. Epspdf looks for a number of PostScript- and pdf +viewers, from which you can select one, but you can also enter one +manually. + +For Windows and Mac OS there is no such configuration option. Epspdf +will use the program associated with the file type, which can be +configured outside epspdf. + +@subsection Options for converting to pdf +Double-check the setting ``Target use'' under ``Conversion to +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. + +On the other hand, you may prefer ``screen'' if file size is a +concern. See also the Ghostscript documentation, in particular Use.htm +and VectorDevices.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. Versions below 1.4 +do not support transparency. Converting a page or graphic with +transparencies to version 1.3 will probably result in the whole page or +graphic getting rasterized. For prepress use, consult your printshop or +publisher. Otherwise leave the pdf version at ``default''. + +@subsection Options for converting to PostScript +For conversion to plain or Encapsulated PostScript, pdftops sometimes +does a better job of preserving fonts than Ghostscript. Under Windows, +current versions of both MiKTeX and TeX Live include pdftops. Still, you +may opt @i{not} to use pdftops even if it is available, in which case +Ghostscript will be used instead. + +@node Command-line usage, Notes on PostScript and pdf, Usage, Top +@chapter Command-line usage + +epspdf.tlu is the backend of epspdftk, but it can also be used +standalone. It shares configuration settings with epspdftk.tcl. + +The first parameter of the epspdftk GUI program is interpreted as +startup directory for the file browser. Epspdf itself has a more +elaborate command-line interface. + +Below, we assume that there is a suitable wrapper or symlink for epspdf +on your searchpath. This is the case if you installed epspdf as a TeX +Live package. + +Basic usage of epspdf itself: + +@example +epspdf [@var{options}] @var{infile} [@var{outfile}] +@end example + +@menu +* Option summary:: +@end menu + +@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.6.4 +Copyright (c) 2006-2019 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 + +-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, 1.5, 1.6, 1.7 or default +-U Use pdftops if available +-I Reverses the above +-s, --save Save some settings to configuration file +-i, --info Info: display detected filetype and exit +-d Debug: do not remove temp files +-v, --version + Display version info and exit +-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 or pdf from Windows programs:: +@end menu + +@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, +in terms of geometric shapes, fonts and text. + +Bitmapped or pixel-based graphics are appropriate for photographs and +screenshots, but less so for diagrams and spreadsheet-generated +graphics. + +A file in PostScript- or pdf format can contain both types of graphic +data. + +Vector graphics can be freely scaled without losing sharpness or +becoming pixellated. If bitmapped graphics are enlarged too much, +individual pixels become apparent. With low-resolution bitmaps this +happens sooner than with high-resolution bitmaps, but high-resolution +bitmaps have (much) larger file sizes, and take longer to process. + +So avoid converting vector to bitmap. However, converting from bitmap to +vector is also best avoided, since it is very hard to do well. + +Epspdf usually avoids conversion from vector to bitmap and never +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, Eps preview headers, Bitmapped and vector, Notes on PostScript and pdf +@section Font embedding + +When converting to pdf, Ghostscript handles font embedding differently +depending on the ``Target use'' option. According to the Ghostscript +documentation, it embeds all fonts without exception for all targets +except ``screen'', for which 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 + +Preview headers are quietly stripped from eps files. These preview +headers are used by e.g. desktop-publishing software to represent eps +files on screen without having to interpret the PostScript code +itself. Epspdf has no option to preserve or add them. + +@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 +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. + +Conversion to pdf usually translates the bottom-left corner to the (0,0) +origin and sets the @dots{}box to the size of the +graphic. Anything outside the @dots{}box should be cut off. + +@node Orientation, Exporting PostScript or pdf from Windows programs, Bounding- and other boxes, Notes on PostScript and pdf +@section Orientation + +Ghostscript may not be able to determine the right orientation of a +PostScript- or pdf file. This may result in part of a graphic being cut +off after conversion or even everything falling outside the page / +mediabox / boundingbox. + +@node Exporting PostScript or pdf from Windows programs, , Orientation, Notes on PostScript and pdf +@section Exporting PostScript or pdf from Windows programs + +Microsoft Office 2010 can now export to pdf, either the entire document +or a selection. This removes a major headache for Windows users. Windows +10 also includes a pdf printer. + +As a last resort on earlier Windows versions, 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 Color +Printer. Pay attention to the printer properties: choose ``Outline'' for +font downloading and avoid the ``Optimize for speed'' setting for +PostScript Output Option. In my tests, ``Encapsulated PostScript'' did +not look very promising 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 + +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:: +* Windows:: +@end menu + +@node Linux, Mac OS, Bitmapped graphics for @LaTeX{} and pdflatex, Bitmapped graphics for @LaTeX{} and pdflatex +@section Linux + +@table @emph +@item sam2p +This command-line bitmap-to-PostScript/pdf conversion utility is +available from @url{http://code.google.com/p/sam2p/} and may already be +packaged for your distribution. It produces very small files: +@samp{sam2p image.png image.eps} +@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- and pdf format. +@end table + +@node Mac OS, Windows, Linux, Bitmapped graphics for @LaTeX{} and pdflatex +@section Mac OS + +Mac OS's built-in Preview application can read most bitmapped formats +and save them as pdf or PostScript. In fact, in many cases it is an +excellent alternative to epspdf. + +@node Windows, , Mac OS, Bitmapped graphics for @LaTeX{} and pdflatex +@section Windows + +I know of no built-in facility for converting bitmaps to eps or pdf, +apart from ``printing'' to PostScript or pdf. However, many image +editors can convert to eps or pdf. A couple of command-line utilities: +@example +sam2p image.png image.eps +@end example +or +@example +bmeps -c image.png image.eps +@end example +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. + +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 +* No options for output format visible:: +* Ghostscript stackunderflow error:: +* Part of the graphic gets cut off:: +* Fonts look ugly:: +* The page has been converted to a bitmap:: +* Temporary files are not removed:: +* Resources for troubleshooting:: +@end menu + +@node No options for output format visible, Ghostscript stackunderflow error, Troubleshooting, Troubleshooting +@section No options for output format visible + +Widen the window, to make the output format radio buttons visible. + +@node Ghostscript stackunderflow error, Part of the graphic gets cut off, No options for output format visible, Troubleshooting +@section Ghostscript stackunderflow error + +Some Ghostscript versions, @emph{e.g.} 9.10, have an error in color +handling when converting to pdf: selecting ``printer'' as target may +lead to an error @code{stackunderflow in .setdistillerparams}. If you +run into this, use the ``default'' or ``prepress'' target instead. + +@node Part of the graphic gets cut off, Fonts look ugly, Ghostscript stackunderflow error, Troubleshooting +@section Part of the graphic gets cut off + +If the PostScript file was generated with the Windows PostScript driver, +experiment with the PostScript Output option. Don't choose Optimize for +Speed. + +@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 may not +remain text, but may be replaced by bitmaps. Newer Ghostscript versions +tend to do better in this respect than older ones, but as to preserving +fonts, the pdftops utility may still handle more cases. It is part of the +xpdf suite and of the Poppler utilities. + +@node The page has been converted to a bitmap, Temporary files are not removed, Fonts look ugly, Troubleshooting +@section The page has been converted to a bitmap + +The usual cause is that the page contains features such as transparency which +are not supported by the target format. + +Otherwise, set pdf target use and target version both to ``default'' to +avoid unnecessary conversions: @code{-T default -N default} + +@node Temporary files are not removed, Resources for troubleshooting, The page has been converted to a bitmap, Troubleshooting +@section Temporary files are not removed + +@itemize +@item +Command-line: make sure that you did not specify the option @code{-d}. +@item +Epspdftk GUI: make sure that `Remove temp files' is checked. +@item +Windows: this platform is notorious for excessive file locking. I +already inserted a Windows-specific delay before attempting to delete +the temporary files, but this is not always enough. However, you should +have no trouble removing temporary files manually. +@end itemize + +@node Resources for troubleshooting, , Temporary files are not removed, Troubleshooting +@section Resources for troubleshooting + +@i{Logfile.} The GUI has a button for viewing log output. This same +output is also written to a file @file{epspdf.log}. For Linux/Unix/Mac +Mac OS 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:\Users\@var{your user +name}\AppData\Roaming}. Type +@example +echo %APPDATA% +@end example +in a Command Prompt window to find out which. + +The logfile lists all epspdf calls and all Ghostscript- and pdftops +calls plus error information. + +@i{Temporary files.} The temporary files may give clues as +well. Uncheck the button ``Remove temp files'', or for the +command-line version, give a -d parameter to keep the temporary +files. Check the log(file) as to which temporary files have been +created. + +@anchor{Documentation}@i{Ghostscript- and pdftops documentation.} For +Ghostscript, the most important files are VectorDevices.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. TeX +Live includes the man page in pdf format: pdftops.pdf. + +@node Requirements +@appendix Requirements + +Epspdftk consists of a GUI front end and a command-line back end. + +The command-line component, which can be used separately from the front +end, requires ghostscript and a not too old @TeX{} installation with +luatex. It may further benefit from the presence of pdftops. MiKTeX and +TeX Live for Windows meet these requirements out of the box. + +The front end requires a Tcl/Tk installation, or at least a tclkit +runtime. TeX Live for Windows contains such a tclkit since late 2018, +and epspdftk as a TeX Live package will make use of it. The minimum +version is 8.5. + +For Windows there is an alternate epspdf-setup package on CTAN with an +embedded Tcl/Tk runtime and a regular Windows installer, which also +creates a menu shortcut and an uninstaller. + +@node Change history, , Troubleshooting, Top +@appendix Change history + +@menu +* Version 6.4:: +* Version 0.6:: +* Version 0.5:: +* Version 0.4:: +@end menu + +@node Version 6.4 +@section Version 6.4 + +Compatibility changes for luatex 1.9 and later. + +The location of pdftops is no longer configurable; it is only searched +for on the searchpath. + +Some corner cases should be handled more successfully. + +The GUI now requires Tcl/Tk version 8.5 or higher. On Windows, +epspdf.tlu is now invoked via a batchfile. This should prevent black +console windows popping up. + +@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. + +I no longer try to provide an AppleScript wrapper. + +The current version has no provisions for custom Ghostscript- or pdftops +parameters. 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 +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 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@dots{}'' 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 +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 +use its private Ghostscript if it cannot find a separately installed +Ghostscript. @TeX{} Live's pdftops, being on the searchpath, will be +used unless epspdf finds another copy first. + +There is now a ``-v'' (lowercase) option to print the version string. + +@ifhtml +@section @url{index.html,Main page} +@end ifhtml + +@bye diff --git a/support/epspdf/doc/images/cnv_linux.png b/support/epspdf/doc/images/cnv_linux.png Binary files differnew file mode 100644 index 0000000000..d452692afc --- /dev/null +++ b/support/epspdf/doc/images/cnv_linux.png diff --git a/support/epspdf/doc/images/config_lnx.png b/support/epspdf/doc/images/config_lnx.png Binary files differnew file mode 100644 index 0000000000..a80400c209 --- /dev/null +++ b/support/epspdf/doc/images/config_lnx.png diff --git a/support/epspdf/doc/images/epspdf.png b/support/epspdf/doc/images/epspdf.png Binary files differnew file mode 100644 index 0000000000..db0f09c6ac --- /dev/null +++ b/support/epspdf/doc/images/epspdf.png diff --git a/support/epspdf/doc/images/logo.pdf b/support/epspdf/doc/images/logo.pdf Binary files differnew file mode 100644 index 0000000000..153b771fb2 --- /dev/null +++ b/support/epspdf/doc/images/logo.pdf diff --git a/support/epspdf/doc/images/logo.svg b/support/epspdf/doc/images/logo.svg new file mode 100644 index 0000000000..fa54577adc --- /dev/null +++ b/support/epspdf/doc/images/logo.svg @@ -0,0 +1,222 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<!-- Created with Inkscape (http://www.inkscape.org/) --> + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="1052.3622" + height="744.09448" + id="svg2" + version="1.1" + inkscape:version="0.47pre4 r22446" + sodipodi:docname="epspdf.svg" + style="display:inline"> + <defs + id="defs4"> + <inkscape:perspective + sodipodi:type="inkscape:persp3d" + inkscape:vp_x="0 : 526.18109 : 1" + inkscape:vp_y="0 : 1000 : 0" + inkscape:vp_z="744.09448 : 526.18109 : 1" + inkscape:persp3d-origin="372.04724 : 350.78739 : 1" + id="perspective10" /> + <inkscape:perspective + id="perspective2921" + inkscape:persp3d-origin="0.5 : 0.33333333 : 1" + inkscape:vp_z="1 : 0.5 : 1" + inkscape:vp_y="0 : 1000 : 0" + inkscape:vp_x="0 : 0.5 : 1" + sodipodi:type="inkscape:persp3d" /> + <inkscape:perspective + id="perspective2984" + inkscape:persp3d-origin="0.5 : 0.33333333 : 1" + inkscape:vp_z="1 : 0.5 : 1" + inkscape:vp_y="0 : 1000 : 0" + inkscape:vp_x="0 : 0.5 : 1" + sodipodi:type="inkscape:persp3d" /> + <inkscape:perspective + id="perspective3898" + inkscape:persp3d-origin="0.5 : 0.33333333 : 1" + inkscape:vp_z="1 : 0.5 : 1" + inkscape:vp_y="0 : 1000 : 0" + inkscape:vp_x="0 : 0.5 : 1" + sodipodi:type="inkscape:persp3d" /> + <clipPath + clipPathUnits="userSpaceOnUse" + id="clipPath2886"> + <path + id="path2888" + style="fill:none;stroke:#000000;stroke-width:1.15759587;display:inline" + d="m 662.69592,363.42152 c 0,148.23849 -120.17108,268.40953 -268.40958,268.40953 -148.2385,0 -268.40954,-120.17104 -268.40954,-268.40953 0,-148.23851 120.17104,-268.40955 268.40954,-268.40955 148.2385,0 268.40958,120.17104 268.40958,268.40955 z m -123.7647,-10e-6 c 0,-79.88516 -64.75972,-144.64488 -144.64488,-144.64488 -79.88517,0 -144.64489,64.75972 -144.64489,144.64488 0,79.88517 64.75972,144.64489 144.64489,144.64489 79.88516,0 144.64488,-64.75972 144.64488,-144.64489 z" /> + </clipPath> + </defs> + <sodipodi:namedview + id="base" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageopacity="0.0" + inkscape:pageshadow="2" + inkscape:zoom="1.1295785" + inkscape:cx="404.62267" + inkscape:cy="380.57534" + inkscape:document-units="px" + inkscape:current-layer="layer2" + showgrid="false" + showguides="true" + inkscape:guide-bbox="true" + inkscape:window-width="1272" + inkscape:window-height="911" + inkscape:window-x="402" + inkscape:window-y="117" + inkscape:window-maximized="0" + inkscape:snap-global="false" + inkscape:object-paths="true" + inkscape:snap-intersection-paths="false" + inkscape:snap-page="true" /> + <metadata + id="metadata7"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title></dc:title> + </cc:Work> + </rdf:RDF> + </metadata> + <g + inkscape:groupmode="layer" + id="layer2" + inkscape:label="Layer" + style="display:inline"> + <g + id="g3853" + clip-path="url(#clipPath2886)"> + <path + id="path3822" + d="m 423.25,469.15625 c -10.09348,1.24175 -20.18906,2.46673 -30.28125,3.71875 -18.4916,31.25922 -36.9755,62.52301 -55.46875,93.78125 18.55393,33.75824 37.05144,67.54777 55.59375,101.3125 27.78142,-3.72777 55.55723,-7.49833 83.34375,-11.1875 -26.58572,-27.90445 -53.14375,-55.83532 -79.71875,-83.75 9.84306,-34.73978 19.69161,-69.478 29.53125,-104.21875 -1,0.11458 -2,0.22917 -3,0.34375 z" + style="fill:#0b2817;stroke:none" /> + <path + style="fill:#d40000;stroke:none" + d="m 316.05617,71.823338 78.15822,81.661702 -28.70783,102.88966 -27.3834,11.06187 1.51539,-106.43282 -96.3054,-58.82396 72.72302,-30.356452 z" + id="path3830" + sodipodi:nodetypes="ccccccc" /> + <path + sodipodi:nodetypes="ccccccc" + id="path3832" + d="m 472.3726,655.52027 -78.15822,-81.66169 28.70783,-102.88968 27.3834,-11.06187 -1.51539,106.43283 96.3054,58.82396 -72.72302,30.35645 z" + style="fill:#0b2817;stroke:none" /> + <path + id="path3836" + d="m 241.96875,100.40625 c -21.83042,16.85792 -43.68483,33.68489 -65.5,50.5625 36.97454,10.86566 73.93656,21.77405 110.90625,32.65625 8.85895,34.99878 17.67974,70.00731 26.5625,105 8.90627,-6.74614 17.84062,-13.45586 26.78125,-20.15625 0.3408,-36.31262 0.75616,-72.62486 1.09375,-108.9375 -32.91375,-19.9839 -65.82147,-39.97811 -98.75,-59.9375 l -0.80274,0.59632 -0.29101,0.21618 z" + style="fill:#800000;stroke:none" /> + <path + id="path3838" + d="m 472.125,440.53125 c -8.13836,6.11062 -16.25394,12.25194 -24.40625,18.34375 -0.3408,36.31262 -0.75616,72.62486 -1.09375,108.9375 32.90907,20.00202 65.8493,39.95316 98.75,59.96875 22.18542,-17.1381 44.39191,-34.24901 66.5625,-51.40625 -36.97454,-10.86566 -73.93656,-21.77405 -110.90625,-32.65625 -8.84881,-34.99871 -17.65722,-70.00773 -26.53125,-105 -0.79167,0.60417 -1.58333,1.20833 -2.375,1.8125 z" + style="fill:none;stroke:none" /> + <path + style="fill:#800000;stroke:none" + d="m 180.60315,150.00273 108.51786,31.642 26.58312,103.45898 -18.18379,23.27156 -51.90404,-92.93123 -112.8149,-2.79034 47.80175,-62.65097 z" + id="path3842" + sodipodi:nodetypes="ccccccc" /> + <path + sodipodi:nodetypes="ccccccc" + id="path3844" + d="m 607.82562,577.34089 -108.51785,-31.642 -26.58313,-103.45898 18.18379,-23.27156 51.90405,92.93123 112.8149,2.79034 -47.80176,62.65097 z" + style="fill:#0055d4;stroke:none" /> + <path + id="path3848" + d="m 130.75,211.8125 c -10.49227,25.50931 -20.9624,51.02775 -31.46875,76.53125 37.45067,-9.08351 74.91791,-18.09905 112.375,-27.15625 25.1662,25.88587 50.33612,51.76813 75.5,77.65625 4.37516,-10.28715 8.74305,-20.57753 13.09375,-30.875 -17.81224,-31.63098 -35.64932,-63.24804 -53.46875,-94.875 -38.49971,-0.86603 -77.00012,-1.70338 -115.5,-2.5625 l -0.38302,0.92374 -0.14823,0.35751 z" + style="fill:#550000;stroke:none" /> + <path + id="path3850" + d="m 500.09375,391.28125 c -3.97605,9.36589 -7.97624,18.72165 -11.9375,28.09375 17.82214,31.63127 35.67073,63.24772 53.5,94.875 38.49971,0.86603 77.00012,1.70338 115.5,2.5625 10.6772,-25.93315 21.31525,-51.88246 32,-77.8125 -37.45067,9.08351 -74.91791,18.09905 -112.375,27.15625 -25.1662,-25.88587 -50.33612,-51.76813 -75.5,-77.65625 -0.39583,0.92708 -0.79167,1.85417 -1.1875,2.78125 z" + style="fill:#0044aa;stroke:none" /> + <path + style="fill:#550000;stroke:none" + d="m 102.38709,285.43458 109.80022,-26.85616 74.75114,76.30654 -4.11184,29.24566 -91.41583,-54.52878 -99.095738,53.99095 10.072048,-78.15821 z" + id="path3854" + sodipodi:nodetypes="ccccccc" /> + <path + sodipodi:nodetypes="ccccccc" + id="path3856" + d="m 686.04168,441.90904 -109.80022,26.85616 -74.75115,-76.30655 4.11184,-29.24566 91.41584,54.52879 99.09574,-53.99094 -10.07205,78.1582 z" + style="fill:#0044aa;stroke:none" /> + <path + id="path3860" + d="m 190.21875,307.53125 c -33.42637,18.33463 -66.85842,36.65894 -100.28125,55 3.727767,27.78142 7.498332,55.55723 11.1875,83.34375 27.89398,-26.57536 55.8145,-53.12291 83.71875,-79.6875 34.75009,9.833 69.49943,19.66867 104.25,29.5 -1.30917,-11.09907 -2.70355,-22.18816 -4.0625,-33.28125 -31.26916,-18.482 -62.54438,-36.95375 -93.8125,-55.4375 l -0.87158,0.49026 -0.12842,0.0722 z" + style="fill:none;stroke:none" /> + <path + id="path3862" + d="M 684.46875,284.1875 C 657.5,309.84375 630.53125,335.5 603.5625,361.15625 c -34.7397,-9.83292 -69.47847,-19.66913 -104.21875,-29.5 1.30917,11.09907 2.70355,22.18816 4.0625,33.28125 31.26916,18.482 62.54438,36.95375 93.8125,55.4375 33.74768,-18.54378 67.5271,-37.03031 101.28125,-55.5625 -3.72777,-27.78142 -7.49833,-55.55723 -11.1875,-83.34375 -0.94792,0.90625 -1.89583,1.8125 -2.84375,2.71875 z" + style="fill:#003380;stroke:none" /> + <path + style="fill:#2ca05a;stroke:none" + d="m 102.36592,441.83003 81.6617,-78.15822 102.88966,28.70783 11.06187,27.3834 -106.43282,-1.51539 -58.82396,96.3054 -30.35645,-72.72302 z" + id="path3866" + sodipodi:nodetypes="ccccccc" /> + <path + sodipodi:nodetypes="ccccccc" + id="path3868" + d="m 686.06285,285.5136 -81.66169,78.15822 -102.88968,-28.70783 -11.06187,-27.3834 106.43283,1.51539 58.82396,-96.3054 30.35645,72.72302 z" + style="fill:#003380;stroke:none" /> + <path + id="path3872" + d="m 189.46875,417.03125 c -19.77769,32.59589 -39.58367,65.17478 -59.34375,97.78125 17.08893,22.22516 34.23322,44.40895 51.375,66.59375 10.86566,-36.97454 21.77405,-73.93656 32.65625,-110.90625 35.00918,-8.85901 70.02824,-17.67932 105.03125,-26.5625 -6.7258,-8.9192 -13.45366,-17.83687 -20.1875,-26.75 -36.31263,-0.35053 -72.62485,-0.77776 -108.9375,-1.125 l -0.52256,0.8526 -0.0712,0.11615 z" + style="fill:#217844;stroke:none" /> + <path + id="path3874" + d="m 605.84375,149.6875 c -10.53125,35.71875 -21.0625,71.4375 -31.59375,107.15625 -34.99878,8.85895 -70.00731,17.67974 -105,26.5625 6.7258,8.9192 13.45366,17.83687 20.1875,26.75 36.31263,0.35053 72.62485,0.77776 108.9375,1.125 19.97403,-32.91341 39.95665,-65.82184 59.90625,-98.75 -17.07951,-22.22439 -34.21034,-44.41053 -51.34375,-66.59375 -0.36458,1.25 -0.72917,2.5 -1.09375,3.75 z" + style="fill:#002255;stroke:none" /> + <path + style="fill:#217844;stroke:none" + d="m 180.54531,577.28305 31.642,-108.51786 103.45898,-26.58312 23.27156,18.18379 -92.93123,51.90404 -2.79034,112.8149 -62.65097,-47.80175 z" + id="path3878" + sodipodi:nodetypes="ccccccc" /> + <path + sodipodi:nodetypes="ccccccc" + id="path3880" + d="m 607.88347,150.06058 -31.642,108.51785 -103.45898,26.58313 -23.27156,-18.18379 92.93123,-51.90405 2.79034,-112.8149 62.65097,47.80176 z" + style="fill:#002255;stroke:none" /> + <path + id="path3884" + d="m 337.6875,458.09375 c -31.3543,17.66642 -62.70751,35.3348 -94.0625,53 -0.85617,38.52053 -1.68305,77.04177 -2.53125,115.5625 25.94402,10.60347 51.85869,21.28092 77.78125,31.9375 -9.08351,-37.45067 -18.09905,-74.91791 -27.15625,-112.375 25.89614,-25.16635 51.78983,-50.33522 77.6875,-75.5 -10.28715,-4.37516 -20.57753,-8.74305 -30.875,-13.09375 l -0.84375,0.46875 z" + style="fill:#16502d;stroke:none" /> + <path + id="path3886" + d="m 470.5,72.5625 c 8.73958,36.1875 17.47917,72.375 26.21875,108.5625 -25.89614,25.16635 -51.78983,50.33522 -77.6875,75.5 10.28715,4.37516 20.57753,8.74305 30.875,13.09375 31.64123,-17.81253 63.26906,-35.64899 94.90625,-53.46875 0.85617,-38.52053 1.68305,-77.04177 2.53125,-115.5625 C 521.39973,90.084032 495.48506,79.406582 469.5625,68.75 c 0.3125,1.270833 0.625,2.541667 0.9375,3.8125 z" + style="fill:none;stroke:none" /> + <path + style="fill:#16502d;stroke:none" + d="M 315.97716,655.49911 289.121,545.69889 l 76.30654,-74.75115 29.24566,4.11184 -54.52878,91.41583 53.99095,99.09574 -78.15821,-10.07204 z" + id="path3890" + sodipodi:nodetypes="ccccccc" /> + <path + sodipodi:nodetypes="ccccccc" + id="path3892" + d="m 472.45162,71.844518 26.85616,109.800212 -76.30655,74.75116 -29.24566,-4.11184 54.52879,-91.41584 -53.99094,-99.095741 78.1582,10.072049 z" + style="fill:#ff0000;stroke:none" /> + <path + id="path3820" + d="m 393.96875,59.5625 c -27.32378,3.660109 -54.64045,7.374185 -81.96875,11 26.57646,27.903358 53.12273,55.8355 79.6875,83.75 -9.83292,34.7397 -19.66913,69.47847 -29.5,104.21875 11.09907,-1.30917 22.18816,-2.70355 33.28125,-4.0625 18.4916,-31.25922 36.9755,-62.52301 55.46875,-93.78125 C 432.38357,126.92926 413.88606,93.139727 395.34375,59.375 l -0.99083,0.135113 -0.38417,0.05239 z" + style="fill:#d40000;stroke:none" /> + </g> + <path + sodipodi:type="arc" + style="fill:none;stroke:none" + id="path2985" + sodipodi:cx="408.40744" + sodipodi:cy="364.15735" + sodipodi:rx="205.37555" + sodipodi:ry="205.37555" + d="m 613.78299,364.15735 a 205.37555,205.37555 0 1 1 -410.7511,0 205.37555,205.37555 0 1 1 410.7511,0 z" + transform="matrix(1.0258634,0,0,1.0258634,-23.842106,-8.5330716)" /> + </g> +</svg> diff --git a/support/epspdf/doc/images/main_wx.png b/support/epspdf/doc/images/main_wx.png Binary files differnew file mode 100644 index 0000000000..068dd2d8fa --- /dev/null +++ b/support/epspdf/doc/images/main_wx.png diff --git a/support/epspdf/doc/pstexi.tex b/support/epspdf/doc/pstexi.tex new file mode 100644 index 0000000000..63e86cb3e3 --- /dev/null +++ b/support/epspdf/doc/pstexi.tex @@ -0,0 +1,49 @@ +% change texinfo fonts +% usage: put the following code early in your file, +% but after \input texinfo + +%%%%%%%%%%%%%%%% +% @tex +% \input pstexi +% @end tex +% +% @textfonts +% @rm +%%%%%%%%%%%%%%%% + +% Set the font macro #1 to the font named #2, adding on the +% specified font prefix (normally `cm'). +% #3 is the font's design size, #4 is a scale factor +% \def\setfont#1#2#3#4{\font#1=\fontprefix#2#3 scaled #4} +% UPDATE: a new implementation uses a fifth encoding(?) parameter, +% which we simply ignore. +\newcount\atsize +\def\setfont#1#2#3#4#5{% + \def\mag{#4} + \global\atsize=\mag + \global\multiply\atsize #3 + \global\divide\atsize 1000 + \global\font#1=#2 at \atsize pt} + +% \fontprefix not usable outside cm/lm/ec +\gdef\fontprefix{} + +\gdef\rmshape{pplr7t} +\gdef\rmbshape{pplb7t} %where the normal face is bold +\gdef\bfshape{pplb7t} +\gdef\bxshape{pplb7t} +\gdef\ttshape{texnansi-lmtt10} +\gdef\ttbshape{texnansi-lmtk10} +\gdef\ttslshape{texnansi-lmtto10} +\gdef\itshape{pplri7t} +\gdef\itbshape{pplbi7t} +\gdef\slshape{pplri7t} +\gdef\slbshape{pplbi7t} +\gdef\sfshape{texnansi-lmss10} +\gdef\sfbshape{texnansi-lmssbx10} +\gdef\scshape{pplrc7t} +\gdef\scbshape{pplbc7t} + +\definetextfontsizexi + +\global\let\subtitlerm=\tenrm |