summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/epspdfconversion
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/epspdfconversion
Initial commit
Diffstat (limited to 'macros/latex/contrib/epspdfconversion')
-rw-r--r--macros/latex/contrib/epspdfconversion/README25
-rw-r--r--macros/latex/contrib/epspdfconversion/epspdfconversion.pdfbin0 -> 430019 bytes
-rw-r--r--macros/latex/contrib/epspdfconversion/epspdfconversion.sty375
-rw-r--r--macros/latex/contrib/epspdfconversion/example/epspdfconversion_docu.tex380
-rw-r--r--macros/latex/contrib/epspdfconversion/example/image.eps496
-rw-r--r--macros/latex/contrib/epspdfconversion/example/image2.eps496
-rw-r--r--macros/latex/contrib/epspdfconversion/example/optionstable.tex97
7 files changed, 1869 insertions, 0 deletions
diff --git a/macros/latex/contrib/epspdfconversion/README b/macros/latex/contrib/epspdfconversion/README
new file mode 100644
index 0000000000..28f09af687
--- /dev/null
+++ b/macros/latex/contrib/epspdfconversion/README
@@ -0,0 +1,25 @@
+epspdfconversion.sty facilitates the use of the epspdf tools (on CTAN in
+pub/tex/support) from within PDFLaTeX. EPS graphic files are converted
+"on the fly". It is similar to and based on the epstopdf package and
+allows to pass several options such as grayscale, prepress, pdfversion
+etc. to the epspdf conversion-command. Can also be used to trigger a
+conversion of PDF- and PS-files.
+
+New in version 0.61:
+
+* new options pdftopdf and pstopdf. Uses epspdf to do pdf-to-pdf and
+ ps-to-pdf conversions. Allows grayscaling, calculation of bounding boxes
+ etc for pdf's that already exist an for .ps-files. Disabled by default.
+
+* bugfix for the outdir-option (converted files in subdirectories are
+ again saved in those subdirectories) (Thanks to Stefan Pofahl for the
+ feedback.)
+
+* small improvement of the documentation (on the windows
+ epspdf.bat file, on epstopdf's option 'outdir')
+
+* now uses epstopdf's \epstopdfDeclareGraphicsRule
+
+
+This material is subject to the LaTeX Project Public License in its most
+recent version. \ No newline at end of file
diff --git a/macros/latex/contrib/epspdfconversion/epspdfconversion.pdf b/macros/latex/contrib/epspdfconversion/epspdfconversion.pdf
new file mode 100644
index 0000000000..faac057bf9
--- /dev/null
+++ b/macros/latex/contrib/epspdfconversion/epspdfconversion.pdf
Binary files differ
diff --git a/macros/latex/contrib/epspdfconversion/epspdfconversion.sty b/macros/latex/contrib/epspdfconversion/epspdfconversion.sty
new file mode 100644
index 0000000000..ed6816a6f0
--- /dev/null
+++ b/macros/latex/contrib/epspdfconversion/epspdfconversion.sty
@@ -0,0 +1,375 @@
+%%
+%% This is file `epspdfconversion.sty',
+%%
+%%
+%% It is based on epstopdf.sty by Heiko Oberdiek and is a tool to use Siep
+%% Kroonenberg's Epspdf-tools (http://tex.aanhet.net/epspdf/)
+%% "on the fly" in LaTeX
+%%
+%% Please send suggestions to d.becker@jpberlin.de
+%%
+%%
+%% version history:
+%% 0.61 * new options pdftopdf and pstopdf. Uses epspdf to do pdf-to-pdf and ps-to-pdf conversions. Allows grayscaling, calculation of
+%% bounding boxes etc for pdf's that already exist an for .ps-files. Disabled by default.
+%% * bugfix for the outdir-option (converted files in subdirectories are again saved in those subdirectories)
+%% (Thanks to Stefan Pofahl for the feedback.)
+%% * small improvement of the documentation (on the windows epspdf.bat file, on epstopdf's option 'outdir')
+%% * now uses epstopdf's \epstopdfDeclareGraphicsRule
+%% 0.6 * pdfversion now uses epspdf's --pdfversion. --version in epspdf is to print the
+%% version number of epspdf (currently, epspdf is at 0.5)
+%% * new author email
+%% 0.5 this update makes use of changes in the epstopdf-package v2.2
+%% * new options
+%% update,verbose,prefersuffix,suffix,outdir
+%% (they are really epstopdf options, but can be set
+%% as options for this package)
+%% * default is that converted files have a suffix
+%% * info in logfile about the setup that is used for epstopdf
+%% * new options hires, no-hires
+%% 0.4: the epstopdf-package is now loaded with options [update,prepend]
+%% (works only when epstopdf version 1.5 is used) An update of epstopd.sty
+%% (part of the oberdiek-bundle) is recommended. Added options nogrey,nogray
+%% 0.3: Heiko Oberdiek substantially improved the code.
+%% The kvoptions-package is now used for the implemention of options.
+%% See the documentation for effects and additional features.
+%% 0.2: the package is now simply based on epstopdf. This package essentially
+%% defines \@namedef{Gin@rule@.eps}#1{{pdf}{.pdf}{`\conversioncommand #1}}
+%% differently than epstopdf. The code has been cleaned up. Improvements of
+%% documentation and additional warning about pdfminorversion....
+%% 0.1: first try
+%%
+
+
+
+
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{epspdfconversion}%
+ [2010/06/01 v0.61 Conversion eps->pdf with epspdf-tools on the fly]
+
+
+%% this loads the graphics, epstopdf and the kvoptions packages.
+\RequirePackage{graphics}
+\RequirePackage{epstopdf-base}[2009/07/16]% version 2.2 is necessary
+\RequirePackage{kvoptions}[2006/08/22]% because of \DeclareBoolOption
+
+
+\SetupKeyvalOptions{
+ family=EPC,
+ prefix=EPC@
+}
+
+
+%% this is the basic command necessary for the conversion with epspdf
+\DeclareStringOption[epspdf]{cmd}
+
+% Gray
+% \EPC@gray stores the whole option
+\DeclareVoidOption{gray}{%this is for the \usepackage[gray]{...
+ \def\EPC@optgray{--gray }%this is the effect in the command line
+}
+\DeclareVoidOption{GRAY}{%
+ \def\EPC@optgray{--GRAY }%
+}
+\DeclareVoidOption{grey}{%
+ \def\EPC@optgray{--grey }%
+}
+\DeclareVoidOption{GREY}{%
+ \def\EPC@optgray{--GREY }%
+}
+\DeclareVoidOption{nogrey}{%
+ \def\EPC@optgray{ }%
+}
+\DeclareVoidOption{nogray}{%
+ \def\EPC@optgray{ }%
+}
+
+
+
+% Target
+% \EPC@target stores the target only
+% target ==> --target=default
+% target=printer ==> --target=printer
+% screen ==> --target=screen
+\DeclareStringOption{target}[default]
+\DeclareVoidOption{default}{%
+ \def\EPC@target{default}%
+}
+\DeclareVoidOption{printer}{%
+ \def\EPC@target{printer}%
+}
+\DeclareVoidOption{prepress}{%
+ \def\EPC@target{prepress}%
+}
+\DeclareVoidOption{screen}{%
+ \def\EPC@target{screen}%
+}
+\DeclareVoidOption{ebook}{%
+ \def\EPC@target{ebook}%
+}
+
+
+
+
+% Version
+% \EPC@pdfversion stores the version only
+% pdfversion=1.2 ==> --pdfversion=1.2
+% the warning with pdfminorversion does not work?
+
+\define@key{EPC}{pdfversion}[default]{%
+ \@ifundefined{EPC@pdfversion@#1}{%
+ \PackageError{epspdfconversion}{%
+ Ignoring unknown value for `pdfversion'. Known values are: 1.2,1.3, 1.4, default%
+ }\@ehc
+ }{%
+ \def\EPC@pdfversion{#1}%
+ \begingroup
+ \let\MinorVersion\relax
+ \@ifundefined{pdfminorversion}{%
+ \@ifundefined{pdfoptionpdfminorversion}{}{%
+ \def\MinorVersion{\pdfoptionpdfminorversion}%
+ }%
+ }{%
+ \def\MinorVersion{\pdfminorversion}%
+ }%
+ \ifx\MinorVersion\relax
+ \else
+ \ifnum\@nameuse{EPC@pdfversion@#1}>\MinorVersion
+ \PackageWarning{epspdfconversion}{%
+ You have chosen pdfversion=#1,\MessageBreak
+ but you generate PDF-1.\number\MinorVersion.%
+ \MessageBreak
+ This can be changed by\MessageBreak
+ \expandafter\string\MinorVersion=%
+ \@nameuse{EPC@pdfversion@#1}%
+ \MessageBreak
+ (at the very beginning of your .tex file).\MessageBreak Or try `pdfversion=1.\number\MinorVersion'%
+ }%
+ \fi
+ \fi
+ \endgroup
+ }%
+}
+
+\@namedef{EPC@pdfversion@1.2}{2}
+\@namedef{EPC@pdfversion@1.3}{3}
+\@namedef{EPC@pdfversion@1.4}{4}
+\@namedef{EPC@pdfversion@default}{0}% disable version check
+
+% bbox ==> --bbox
+% bbox=true ==> --bbox
+% bbox=false ==> option disabled
+\DeclareBoolOption{bbox}
+
+%support for pdftopdf-conversion
+\DeclareBoolOption{pdftopdf}
+
+%support for pstopdf-conversion
+\DeclareBoolOption{pstopdf}
+
+\DeclareVoidOption{pdftops}{%
+ \def\EPC@optpdftops{-U }%
+}
+\DeclareVoidOption{nopdftops}{%
+ \def\EPC@optpdftops{-I }%
+}
+
+\DeclareVoidOption{hires}{%
+ \def\EPC@opthires{--hires }%
+}
+\DeclareVoidOption{no-hires}{%
+ \def\EPC@opthires{--no-hires }%
+}
+
+\DeclareStringOption{custom}
+\DeclareStringOption{psoptions}
+\DeclareStringOption{pagenumber}
+
+\DeclareVoidOption{simple}{%
+ % disable other options
+ \let\EPC@optgray\@empty
+ \let\EPC@optpdftops\@empty
+ \let\EPC@opthires\@empty
+ \let\EPC@target\@empty
+ \let\EPC@pdfversion\@empty
+ \let\EPC@custom\@empty
+ \let\EPC@psoptions\@empty
+ \let\EPC@pagenumber\@empty
+ \EPC@bboxfalse
+}
+
+% default setting: all options cleared
+\EPC@simple
+
+% Options help works immediately, if shell escape feature is enabled.
+\DeclareVoidOption{help}{%
+ \immediate\write18{\EPC@cmd\space--help}%
+}
+
+\def\EPC@addopt#1{%
+ \expandafter\ifx\csname EPC@#1\endcsname\@empty
+ \else
+ --#1=\@nameuse{EPC@#1} %
+ \fi
+}
+
+%% this is the setup of the command line....
+\newcommand*{\epspdfconversioncmdline}[1]{%
+ \EPC@cmd\space
+ \EPC@optpdftops
+ \EPC@opthires
+ \EPC@addopt{target}%
+ \ifx\EPC@pdfversion\@empty
+ \else
+ --pdfversion=\EPC@pdfversion\space
+ \fi
+ \EPC@addopt{custom}%
+ \EPC@addopt{psoptions}%
+ \EPC@addopt{pagenumber}%
+ \ifEPC@bbox
+ --bbox %
+ \else
+ \fi
+ \EPC@optgray
+ #1%
+}
+
+%% message in the log-file:
+\def\EPC@printlog{\PackageInfo{epspdfconversion}{\MessageBreak%
+\epspdfconversioncmdline{<file>} is used to convert eps->pdf \MessageBreak(not epstopdf (script))\MessageBreak
+ }%
+}
+
+
+%% this allows to change the options on the fly
+% Use example: \epspdfconversionsetup{target=prepress,bbox}
+\newcommand*{\epspdfconversionsetup}[1]{%
+ \setkeys{EPC}{#1}%
+ \EPC@printlog
+}
+%%%%% epstopdf-options .....
+
+% update, default is true, can be set as update=false
+\DeclareBoolOption[true]{update}
+% verbose, default is true, can be set as verbose=false
+\DeclareBoolOption[true]{verbose}
+% if there is original.pdf and original-suffix.pdf, prefer original-suffix.pdf
+% (the one that has been generated by epspdf), can be set as prefersuffix=false
+\DeclareBoolOption[true]{prefersuffix}
+% suffix. Avoids accidental overwriting of files.
+% usage: suffix={bla}
+\DeclareStringOption[-epspdf-to]{suffix}
+% specifies an outdir, default is current directory ...
+\DeclareStringOption{outdir}
+
+\DeclareBoolOption[false]{prepend}
+
+
+
+
+% Important: !!!
+\ProcessKeyvalOptions*
+
+\typeout{%
+^^Jepspdfconversion.sty is using epstopdf.sty with the following setup:}
+
+% use them to set epstopdf up
+% update
+\ifEPC@update
+\epstopdfsetup{update=true}%
+\typeout{\space\space\space\space update=true,}%
+\else
+\epstopdfsetup{update=false}%
+\typeout{\space\space\space\space update=false,}%
+\fi
+% verbose
+\ifEPC@verbose
+\epstopdfsetup{verbose=true}%
+\typeout{\space\space\space\space verbose=true,}%
+\else
+\epstopdfsetup{verbose=false}%
+\typeout{\space\space\space\space verbose=false,}%
+\fi
+% prefersuffix
+\ifEPC@prefersuffix
+\epstopdfsetup{prefersuffix=true}%
+\typeout{\space\space\space\space prefersuffix=true,}%
+\else
+\epstopdfsetup{prefersuffix=false}%
+\typeout{\space\space\space\space prefersuffix=false,}%
+\fi
+% suffix
+\epstopdfsetup{suffix=\EPC@suffix}%
+\typeout{\space\space\space\space suffix=\EPC@suffix,}%
+
+% outdir
+\let\CheckOutdir\EPC@outdir
+ \ifx\CheckOutdir\@empty
+ \typeout{\space\space\space\space option outdir not set. Default: same directory as the .eps-source-file}%
+ \else
+ \epstopdfsetup{outdir={\EPC@outdir}}%
+ \typeout{\space\space\space\space outdir=\EPC@outdir}%
+ \fi
+
+% prepend
+\ifEPC@prepend
+\epstopdfsetup{prepend}%
+\typeout{\space\space\space\space prepend,}%
+\else
+\epstopdfsetup{append}%
+\typeout{\space\space\space\space append,}%
+\fi
+% enable
+\epstopdfsetup{enable}%
+\typeout{\space\space\space\space enable}%
+
+
+% another message...
+\typeout{epspdf is used with the following command:}
+\typeout{\space\space\space\space \epspdfconversioncmdline{<file>} }
+
+
+
+
+\EPC@printlog
+
+
+%%% the main functionality of this package:
+%%% this changes the definition provided by epstopdf:
+
+% previously, I used:
+%\@namedef{Gin@rule@.eps}#1{{pdf}{.pdf}{`\epspdfconversioncmdline{#1} \OutputFile}}
+
+% since version 0.61: use the mechanism provided by epstopdf to define the eps-pdf conversion rule:
+
+\epstopdfDeclareGraphicsRule{.eps}{pdf}{.pdf}{%
+\epspdfconversioncmdline #1 \OutputFile
+}
+
+% pdftopdf
+\ifEPC@pdftopdf
+\epstopdfDeclareGraphicsRule{.pdf}{pdf}{.pdf}{%
+\epspdfconversioncmdline #1 \OutputFile
+}
+\typeout{support for pdf-to-pdf is ENABLED}%
+\typeout{}
+\else
+\typeout{support for pdf-to-pdf is DISABLED}%
+\typeout{}
+\fi
+
+% pstopdf
+\ifEPC@pstopdf
+\epstopdfDeclareGraphicsRule{.ps}{pdf}{.pdf}{%
+\epspdfconversioncmdline #1 \OutputFile
+}
+\typeout{support for ps-to-pdf is ENABLED}%
+\typeout{}
+\else
+\typeout{support for ps-to-pdf is DISABLED}%
+\typeout{}
+\fi
+
+
+
+\endinput
diff --git a/macros/latex/contrib/epspdfconversion/example/epspdfconversion_docu.tex b/macros/latex/contrib/epspdfconversion/example/epspdfconversion_docu.tex
new file mode 100644
index 0000000000..d27d5a7f82
--- /dev/null
+++ b/macros/latex/contrib/epspdfconversion/example/epspdfconversion_docu.tex
@@ -0,0 +1,380 @@
+\documentclass[11pt]{scrartcl}
+\usepackage[T1]{fontenc}
+\usepackage[latin1]{inputenc}
+\usepackage{microtype}
+\usepackage[english]{babel}
+\usepackage{booktabs}
+\usepackage{tabularx}
+
+%\usepackage[a4paper,left=1.6cm,right=1.6cm,top=1.6cm,bottom=1.6cm]{geometry}% For setting page dimensions / another option: landscape ,,left=1in,right=1in,top=1in,bottom=1in
+\usepackage{fancyvrb}
+\VerbatimFootnotes
+
+%\usepackage{multitoc}
+ \usepackage{setspace}
+
+%DRAWING, IMAGES
+\usepackage[final]{graphicx}
+\usepackage{epic}%
+\usepackage{color}%
+
+\usepackage[pdfversion=1.3,bbox=true,GRAY]{epspdfconversion}
+
+\usepackage{amsmath}
+\usepackage{amssymb}
+
+%Anführungen mit \enquote{++++}
+\usepackage[babel,%
+english=american, %american,
+german=quotes %, guillemets, swiss
+]{csquotes}
+
+
+%DIMENSIONS
+\setlength{\parindent}{0mm}
+\addtolength{\parskip}{1mm}
+
+
+\definecolor{dunkelblau}{rgb}{0.063,0.030,0.670}
+
+
+\usepackage[bookmarks,bookmarksopen]{hyperref}%pdftex
+\hypersetup{
+colorlinks=true,
+linkcolor=dunkelblau,
+anchorcolor=black,
+citecolor=black,
+filecolor=black,
+menucolor=black,
+pagecolor=black,
+urlcolor=dunkelblau,
+pdftitle = {The package epspdfconversion v0.61},
+pdfsubject = {documentation of the package epspdfconversion.sty },
+pdfkeywords = {epspdf, epspdfconversion, LaTeX, eps, eps->pdf, images in pdflatex},
+pdfauthor = {d.becker@jpberlin.de}
+}
+
+\usepackage{ltxtable}
+
+
+%marginnotes:
+\newcommand{\query}[1]{\marginpar{%
+ \vskip-\baselineskip %raise the marginpar a bit
+ \raggedright\tiny \hrule\smallskip#1\par\smallskip\hrule}}
+
+\newcommand{\removequeries}{\renewcommand{\query}[1]{}}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%% END OF PREAMBLE, START OF TEXT %%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{document}
+
+
+
+\newcommand{\pack}{{{\texttt{epspdfconversion}}}}
+
+\hypersetup{pageanchor=false}
+
+\title{The package {\pack}}
+\author{Daniel Becker\\ \texttt{\href{mailto:d.becker@jpberlin.de}{d.becker@jpberlin.de}}
+\thanks{Many thanks to Siep Kroonenberg and Heiko Oberdiek for their help.}
+}
+\date{\today \\ version 0.61}
+
+
+\maketitle
+
+\begin{spacing}{0.8}
+\small
+\tableofcontents
+\end{spacing}
+
+
+
+
+\section{Purpose of \pack}
+
+This package enables the use of the epspdf tools (see \url{http://tex.aanhet.net/epspdf/}) from within (pdf)LaTeX \enquote{on the fly}. It is similar to and based on the epstopdf package that uses the script \verb"epstopdf" for the actual conversion while this packages uses \verb"epspdf" (Note the \verb"epsTOpdf" vs \verb"epspdf").\footnote{You might also want to read the documentation of epstopdf. See \url{http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/epstopdf.pdf}.} It is possible to pass several options to the \verb"epspdf" conversion-command.
+
+While this package can be used for the conversion of eps-files to pdf, the \verb"epspdf"-tools itself can do the conversion both ways. Version of the 0.61 adds support for pdf->pdf and ps->pdf conversion, too.
+
+I am using this package for the inclusion of eps-figures (or .pdf or .ps) that are produced en-masse by a software packages like Stata, Mathematica or Maple and that are often updated. The package makes sure that I can include the eps-figures easily and the updating of the corresponding pdf's is done ``on-the-fly''. Using the \verb"epspdf"-tools (and not \verb"epstopdf") helps a lot to prepare a final pdf that is, for example, accepted by your print shop (really grayscale, prepress-ready, ...).
+
+\section{Installation}
+
+If you are using a recent version of TeXLive ($\geqslant$ 2008), you can skip this section.
+
+\begin{enumerate}
+%%%%%%%%%%%%%%
+ \item Install \verb"epspdf": Go to \url{http://tex.aanhet.net/epspdf/} and follow the installation instructions there.
+%%%%%%%%%%%%%%
+% \item the package needs a recent version of the epstopf-package as a prerequisite, at least version 2.2.
+%%%%%%%%%%%%%%
+ \item Check your \verb"epspdf" installation: Make sure that you can use \verb"epspdf" from the command line. I am using Mac OS X. After the installation of epspdf (or with TeXLive / MacTeX $\geqslant$ 2008), the following command is working from the command line (assuming the file \verb"/Users/daniel/Desktop/testimage.eps" exists):
+\begin{verbatim}
+macbook-daniel:~ daniel$ which epspdf
+/usr/texbin/epspdf
+macbook-daniel:~ daniel$ epspdf /Users/daniel/Desktop/testimage.eps
+\end{verbatim}
+It results in a file \verb"/Users/daniel/Desktop/testimage.pdf".
+%%%%%%%%%%%%%%
+ \item The package requires that shell-escape are enabled such that TeX is allowed to execute the command epspdf if needed. You should get a warning in your .log-file if this is not the case. Be aware that allowing that is a security risk.
+
+Enabling shell-escape means that you have to call pdflatex with additional options. In my case -- I use TeXShop on Mac OS X with MacTeX/TeXLive as the TeX-installation in the background -- the command specified for pdflatex is\\ \verb"pdflatex --file-line-error --shell-escape --synctex=1". If you are using MikTeX on Windows as TeX-installation, use \verb"--enable-write18" instead of\linebreak \verb"--shell-escape". Look for \enquote{shell escape} and \enquote{write18} in the Help-Section of your preferred application for Typesetting on how to enable it (TeXShop, WinEdt, ....).
+\item \emph{Special Note for Windows-Users:} If you are using Windows and do not know how to install epspdf and use it from the command line: The trick is to create a batch-file \verb"epspdf.bat" and place it somewhere where windows can find it (in your path, similar to pdflatex.exe etc.). This file should contain the line\\
+\verb+ruby "C:\Programme\epspdf\epspdf\epspdf.rb" %*+ \\
+ where
+\verb"path\_to\_epspdf.rb"
+ needs to replaced the path to epspdf that is valid in your machine, for example by
+\verb"<C:\Programme\epspdf\epspdf\epspdf.rb>". If everything went ok, you should be able to execute the command epspdf from the command line in Windows (\enquote{Start > Programs > Accessories > Command Prompt}.
+
+Stefan Pofahl (thanks!) suggested the following \verb"epspdf.bat" batch file:
+\begin{verbatim}
+@ECHO OFF
+REM ---
+SET ruby= "C:\Programme\epspdf\rubysub\bin\ruby.exe"
+SET rb="C:\Programme\epspdf\epspdf\epspdf.rb"
+REM ---
+%ruby% %rb% %*
+\end{verbatim}
+
+Where, again, the path to \verb"ruby.exe" and \verb"\epspdf.rb" need to be adjusted to your local settings. The advantage is that epspdf.rb and ruby.exe not necessarily need to be in your path...
+
+\end{enumerate}
+
+
+
+\section{Usage}
+
+Put in the preamble of your .tex-file the line
+\begin{verbatim}
+\usepackage[OPTIONSHERE]{epspdfconversion}
+\end{verbatim}
+where ``OPTIONSHERE'' can be either empty or be filled with the options described below. {\pack} loads, among others, the \verb"graphics"-package and also \verb"epstopdf", so you don't need to do that. If you prefer \verb"graphicx" over \verb"graphics", load in before {\pack}, i.e.
+
+\begin{verbatim}
+\usepackage{graphicx}
+\usepackage{epspdfconversion}
+\end{verbatim}
+
+If you typeset your document, and (pdf)LaTeX detects that you want to use an eps-figure, the {\pack}-package makes sure that it is converted to a pdf that is then included.
+
+By default, if you include your eps-figure \emph{with} the \verb".eps" extension, as in
+\begin{verbatim}
+\includegraphics[width=0.5\textwidth]{image.eps}
+\end{verbatim}
+, there will be a conversion of your \verb"image.eps"-file to a pdf-file named \verb"image-epspdf-to.pdf" that is then used in your document. The next run will only call a conversion if the original .eps-file is newer (has been updated in the meanwhile). This is to save typesetting time. You can change this behaviour with the option \verb"update=false", see below.
+
+If you insist on using \verb"\includegraphics" without the extension, as in
+\begin{verbatim}
+\includegraphics[width=0.5\textwidth]{image}
+\end{verbatim}
+, the situation is more complicated. If you are using \verb"\includegraphics" without the extension, pdfLaTeX when used with epstopdf or {\pack} looks for files that can be used in the following order:
+\begin{verbatim}
+Package grfext Info: Graphics extension search list:
+(grfext) [.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,
+.JPG,.JPEG,.JBIG2,.JB2,.eps]
+\end{verbatim}
+If - for whatever reason, a file \verb"image.png" exists, this one will be used, not the .eps or the converted pdf. However, you can use the option prepend the \enquote{Graphics extension search list} will look like this:
+\begin{verbatim}
+Package grfext Info: Graphics extension search list:
+(grfext) [.eps,.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,
+.JPG,.JPEG,.JBIG2,.JB2]
+\end{verbatim}
+This implies that image.eps is found first and used if a conversion to pdf is necessary. Complicated? Consider to use \verb"\includegraphics" \emph{with} the extension. This avoids confusion which file actually makes it into your document. See options prepend, prefersuffix, update, suffix below and try to figure out how many different scenarios there are.
+
+
+
+\section{Options}
+
+{\pack} accepts several options. Table \ref{optiontable} below gives an overview. The explanations are more or less taken from the documentation of epspdf and epstopdf.
+
+%Put the following code in your main document. store the table in an extra-tex-file named LongTable.tex that might live in a subfolder Tables
+
+\LTXtable{\textwidth}{optionstable.tex}
+
+
+When there are several options in the first column, divided by |, this means that you should \emph{choose only one} of them. For example, it does not make sense have this in the preamble:
+\begin{verbatim}
+\usepackage[pdfversion=1.3,pdfversion=1.4]{epspdfconversion}
+\end{verbatim}
+
+\verb"\pdfminorversion": When you choose the options pdfversion=1.2 or pdfversion=1.3, you need to set \verb"\pdfminorversion" accordingly. The package checks if you have done that properly and shows a warning if not.
+
+
+Changing the options somewhere in the middle of your .tex document is supported. Writing
+\begin{verbatim}
+\epspdfconversionsetup{target=prepress,bbox}
+\end{verbatim}
+changes the options of {\pack} to \verb"target=prepress,bbox". Other options than \verb"target=..." remain in effect.
+
+
+\section{\textbackslash\texttt{epspdfconversioncmdline}}
+
+Many of the options described above change the command that is used to call epspdf for the conversion from .eps to .pdf. %
+
+Typing \verb"\epspdfconversioncmdline" somewhere in your source-.tex file will output the call that you have defined in your preamble. For example, this file has in the preamble
+
+\begin{verbatim}
+\usepackage[pdfversion=1.3,GRAY]{epspdfconversion}
+\end{verbatim}
+
+and the \verb"\epspdfconversioncmdline" then is: \verb"epspdf --GRAY --version=1.3".
+
+This means that you can use \verb"\renewcommand" to define you own \verb"\epspdfconversioncmdline".
+
+For example, to restore the behaviour of the epstopdf-package, you could write
+%
+\begin{verbatim}
+\renewcommand{\epspdfconversioncmdline}%
+{epstopdf }
+\end{verbatim}
+%
+This allows you to use whatever tool you want for your eps->pdf conversion.
+
+
+%\section{A test}
+%
+%What follows is the output of the \verb"\includegraphics"-command from page \pageref{bilderbefehle}.
+%
+%
+%\begin{center}
+%\includegraphics[width=0.5\textwidth]{image.eps}
+%\end{center}
+
+\section{Switching options temporarily}
+
+It is possible to switch the options only temporarily using curly braces. Consider you have set the options \verb"GRAY" such that all your figures appear in grayscale. Now you want color for a single figure. This can be done like this:
+%
+\small
+\begin{verbatim}
+{% <= New group started
+\epspdfconversionsetup{nogray,bbox=false}
+\fbox{\includegraphics[width=4cm]{image2.eps}}
+}% <= New group ended; grayscaling,bbox set to previous value.
+\includegraphics[width=4cm]{image2.eps}
+\end{verbatim}
+\normalsize
+
+The figure \verb"image2.eps" will be exceptionally in color, other figures in gray, according to the general rule for this document:
+
+{% <= New group started
+\epspdfconversionsetup{nogray,bbox=false}
+\fbox{\includegraphics[width=4cm]{image2.eps}}
+}% <= New group ended; grayscaling,bbox set to previous value.
+\includegraphics[width=4cm]{image.eps}
+
+\section{A note for users of latexmk}
+
+(pdf)latexmk is a perl script for running LaTeX, BibTex, Makeindex etc the correct number of times. See \url{http://www.phys.psu.edu/~collins/software/latexmk/}. It can be configured to run pdflatex if an eps-image has been updated (since version V. 3.21i) -- hence updating an eps-file is considered to be an update of the document. In your local configuration file, you should have something like this:
+
+\small
+\begin{verbatim}
+# FOR USERS OF epstopdf v1.5 and later only:
+add_cus_dep('eps', 'pdf', 0, 'cus_dep_require_primary_run');
+\end{verbatim}
+\normalsize
+
+This makes latexmk to pay attention for .eps-files. If they are updated, pdflatexmk triggers a run of pdflatex (uses the subroutine \verb+cus_dep_require_primary_run+) and {\pack} can do the necessary conversion of the file.\footnote{If you enable the options pdftopdf and pstopdf, you should add the corresponding configuration.}
+
+Note that both epstopdf and latexmk are under active development. If you have difficulties to use latexmk together with {\pack}, please let me know.
+
+%\section{--help of epstopdf}
+%
+%The help of epspdf (version 0.5) reads:
+%%
+%\small
+%\begin{verbatim}
+%Daniels-MacBook:~ danielb$ epspdf --help
+%Epspdf version 0.5
+%Copyright (C) 2006, 2008, 2009, 2010 Siep Kroonenberg
+%Convert between [e]ps and pdf formats
+%Usage: epspdf.rb [options] infile [outfile]
+%
+%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
+% -V, --version=PDFVERSION Deprecated; use `-N' or `--pdfversion'.
+% -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 Prints version info
+% -h, --help Show this message
+%\end{verbatim}
+%\normalsize
+
+
+
+%\vfill
+
+\small
+\section{Version-history, ToDo's}
+
+\begin{description}
+ \item[Possible ToDo's] add support for tif and others in pdflatex via convert / add support for pdf-inclusion in latex (not pdf-latex) / add support for more file-types (tif, jpeg,...) in latex (not pdf-latex) / add support for sam2p.
+
+ Please report errors, missing features and other suggestions.
+ \item[v.0.61, 2010-06-1:]
+ \begin{itemize}
+ \item new options pdftopdf and pstopdf. Uses epspdf to do pdf-to-pdf and ps-to-pdf conversions. Allows grayscaling, calculation of
+bounding boxes etc for pdf's that already exist an for .ps-files. Disabled by default.
+ \item bugfix for the outdir-option (converted files in subdirectories are again saved in those subdirectories)
+ (Thanks to Stefan Pofahl for the feedback.)
+ \item small improvement of the documentation (on the windows epspdf.bat file, on epstopdf's option 'outdir')
+ \item now uses epstopdf's \verb"\epstopdfDeclareGraphicsRule"
+\end{itemize}
+ \item[v.0.6, 2010-04-30:] small improvements and documentation updates
+ \begin{itemize}
+ \item pdfversion now uses epspdf's --pdfversion. --version in epspdf is to print the version number of epspdf (currently, epspdf is at 0.5)
+ \item new author email
+ \item documentation updates
+\end{itemize}
+ \item[v.0.5, 2009-09-02:] this update makes use of changes in the epstopdf-package v2.2\begin{itemize}
+ \item new options
+ update,verbose,prefersuffix,suffix,outdir
+ (they are really epstopdf options, but can be set
+ as options for this package)
+ \item default is that converted files have a suffix
+ \item info in logfile about the setup that is used for epstopdf
+ \item new options hires, no-hires
+\end{itemize}
+ \item[v.0.4, 2007-11-24:] the epstopdf-package is now loaded with options [update,prepend] (works only when epstopdf version 1.5 is used) An update of epstopd.sty (part of the oberdiek-bundle) is recommended. Added options nogrey,nogray
+ \item[v.0.3, 2007-10-02:] \begin{itemize}
+ \item check whether \verb"\pdfminorversion" has been set in accordance with option pdfversion=...
+ \item Use the kvoptions-package for the implemention of options. It uses key value syntax that can be used both as package options and a separate setup macro.
+ \item Almost all options of epstopdf are now available as an option of this package.
+ \item The command \verb"\epspdfconversionsetup" is new and allows a change of the options for this package anywhere in your document.
+ \item The command \verb"\epspdfconversioncmdline" has been renamed to\\ \verb"\epspdfconversioncmdline".
+ \item the documentation has been updated
+\end{itemize}
+ \item[v.0.2, 2007-09-21:] the package is now simply based on epstopdf. It essentially defines \\ \verb"\@namedef{Gin@rule@.eps}#1{{pdf}{.pdf}{`\epspdfconversioncmdline #1}}" differently than epstopdf. The code has been cleaned up. Improvements of documentation and additional warning about pdfminorversion....
+ \item[v.0.1, 2007-09-21:] first try
+\end{description}
+
+\end{document}
+ \ No newline at end of file
diff --git a/macros/latex/contrib/epspdfconversion/example/image.eps b/macros/latex/contrib/epspdfconversion/example/image.eps
new file mode 100644
index 0000000000..a0c4a4516f
--- /dev/null
+++ b/macros/latex/contrib/epspdfconversion/example/image.eps
@@ -0,0 +1,496 @@
+%!PS-Adobe-2.0 EPSF-2.0
+%% This is a Stata generated postscript file
+%%BoundingBox: 0 0 504 288
+%%HiResBoundingBox: 0.000 0.000 504.000 288.000
+%%DocumentNeededResources: font Helvetica
+/xratio 0.015750 def
+/yratio 0.015751 def
+/Sbgfill {
+ /y1 exch def
+ /x1 exch def
+ /y0 exch def
+ /x0 exch def
+ x0 y0 moveto
+ x0 y1 lineto x1 y1 lineto x1 y0 lineto x0 y0 lineto
+ fill
+} def
+/Spt {
+ yratio mul
+ /yp exch def
+ xratio mul
+ /xp exch def
+ Slrgb setrgbcolor
+ newpath
+ xp yp moveto
+ xp Slw add yp
+ lineto
+ currentlinecap
+ 1 setlinecap
+ stroke
+ setlinecap
+} def
+/Sln {
+ yratio mul
+ /y1p exch def
+ xratio mul
+ /x1p exch def
+ yratio mul
+ /y0p exch def
+ xratio mul
+ /x0p exch def
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x0p y0p M x1p y1p lineto S
+} def
+/Stxtl {
+ /sp exch def
+ yratio mul
+ /sizep exch def
+ dup
+ /anglep exch def
+ 0 exch sub
+ /angle2p exch def
+ yratio mul
+ /y0p exch def
+ xratio mul
+ /x0p exch def
+ Strgb setrgbcolor
+ x0p y0p M anglep rotate sizep fntsize sp show stroke angle2p rotate
+} def
+/Stxtc {
+ /sp exch def
+ yratio mul
+ /sizep exch def
+ dup
+ /anglep exch def
+ 0 exch sub
+ /angle2p exch def
+ yratio mul
+ /y0p exch def
+ xratio mul
+ /x0p exch def
+ Strgb setrgbcolor
+ x0p y0p M anglep rotate sizep fntsize sp stringwidth exch -2 div exch rm sp show stroke angle2p rotate
+} def
+/Stxtr {
+ /sp exch def
+ yratio mul
+ /sizep exch def
+ dup
+ /anglep exch def
+ 0 exch sub
+ /angle2p exch def
+ yratio mul
+ /y0p exch def
+ xratio mul
+ /x0p exch def
+ Strgb setrgbcolor
+ x0p y0p M anglep rotate sizep fntsize sp stringwidth 1 index -1 mul exch rm pop sp show stroke angle2p rotate
+} def
+/Srect {
+ /sfill exch def
+ yratio mul
+ /y1 exch def
+ xratio mul
+ /x1 exch def
+ yratio mul
+ /y0 exch def
+ xratio mul
+ /x0 exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ x0 y0 moveto
+ x0 y1 lineto x1 y1 lineto x1 y0 lineto x0 y0 lineto
+ fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x0 y0 moveto
+ x0 y1 lineto x1 y1 lineto x1 y0 lineto x0 y0 lineto
+ stroke
+} def
+/Stri {
+ /sfill exch def
+ xratio mul
+ /r exch def
+ yratio mul
+ /y0 exch def
+ xratio mul
+ /x0 exch def
+ /xcen x0 def
+ y0 r add
+ /ytop exch def
+ r 2 div
+ y0 exch sub
+ /ybot exch def
+ r 3 sqrt 2 div mul dup
+ xcen exch sub
+ /xleft exch def
+ xcen add
+ /xright exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ xcen ytop moveto xright ybot lineto xleft ybot lineto xcen ytop lineto fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ xcen ytop moveto xright ybot lineto xleft ybot lineto xcen ytop lineto stroke
+} def
+/Soldtri {
+ /sfill exch def
+ xratio mul
+ /r exch def
+ yratio mul
+ /y0 exch def
+ xratio mul
+ /x0 exch def
+ x0 r sub
+ /x1 exch def
+ y0 r sub
+ /y1 exch def
+ x0 r add
+ /x2 exch def
+ y0 r sub
+ /y2 exch def
+ /x3 x0 def
+ y0 r add
+ /y3 exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ x1 y1 moveto x2 y2 lineto x3 y3 lineto x1 y1 lineto fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x1 y1 moveto x2 y2 lineto x3 y3 lineto x1 y1 lineto stroke
+} def
+/Sdia {
+ /sfill exch def
+ xratio mul
+ /r exch def
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x r sub
+ /x0 exch def
+ /y0 y def
+ /x1 x def
+ y r sub
+ /y1 exch def
+ x r add
+ /x2 exch def
+ /y2 y def
+ /x3 x def
+ y r add
+ /y3 exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ x0 y0 moveto x1 y1 lineto x2 y2 lineto x3 y3 lineto x0 y0 lineto fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x0 y0 moveto x1 y1 lineto x2 y2 lineto x3 y3 lineto x0 y0 lineto stroke
+} def
+/Scc {
+ /sfill exch def
+ xratio mul
+ /r0 exch def
+ yratio mul
+ /y0 exch def
+ xratio mul
+ /x0 exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ x0 y0 r0 0 360 arc fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x0 y0 r0 0 360 arc stroke
+} def
+/Spie {
+ /sfill exch def
+ /a1 exch def
+ /a0 exch def
+ xratio mul
+ /r exch def
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ newpath x y moveto x y r a0 a1 arc closepath
+ fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ newpath x y moveto x y r a0 a1 arc closepath
+ stroke
+} def
+/Splu {
+ xratio mul
+ /r exch def
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x r sub
+ /x0 exch def
+ x r add
+ /x1 exch def
+ x0 y M x1 y L
+ y r sub
+ /y0 exch def
+ y r add
+ /y1 exch def
+ x y0 M x y1 L
+} def
+/Scro {
+ xratio mul
+ /r exch def
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x r sub
+ /x0 exch def
+ y r sub
+ /y0 exch def
+ x r add
+ /x1 exch def
+ y r add
+ /y1 exch def
+ x0 y0 M x1 y1 L
+ x r add
+ /x0 exch def
+ y r sub
+ /y0 exch def
+ x r sub
+ /x1 exch def
+ y r add
+ /y1 exch def
+ x0 y0 M x1 y1 L
+} def
+/Sm {
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x y M
+} def
+/Sl {
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x y L
+} def
+/SPl {
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x y PL
+} def
+/Lcs {
+ currentlinecap
+ 1 setlinecap
+} def
+/Lcr {
+ setlinecap
+} def
+/Sbp {
+ newpath
+} def
+/Sep {
+ /sfill exch def
+ closepath
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ gsave
+ fill
+ grestore
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ Lcs
+ stroke
+ Lcr
+} def
+/cp {currentpoint} def
+/M {moveto} def
+/rm {rmoveto} def
+/S {stroke} def
+/L {Slw setlinewidth Slrgb setrgbcolor lineto Lcs S Lcr} def
+/PL {Slw setlinewidth Slrgb setrgbcolor lineto} def
+/MF { % make new latin1 encoded font
+ /newfontname exch def
+ /fontname exch def
+ /fontdict fontname findfont def
+ /newfont fontdict maxlength dict def
+ fontdict {
+ exch dup /FID eq {pop pop} {exch newfont 3 1 roll put} ifelse
+ } forall
+ newfont /FontName newfontname put
+ newfont /Encoding ISOLatin1Encoding put
+ newfontname newfont definefont pop
+} def
+/Helvetica /Helvetica-Latin1 MF
+/reg {/Helvetica-Latin1 findfont 1 scalefont setfont } def
+/fntsize {/Helvetica-Latin1 findfont exch scalefont setfont } def
+/Slw 0.120 def
+1.000 1.000 1.000 setrgbcolor
+0 0 504.000 288.000 Sbgfill
+/Slrgb {1.000 1.000 1.000} def
+/Strgb {1.000 1.000 1.000} def
+/Ssrgb {1.000 1.000 1.000} def
+/Slw 0.576 def
+0 0 31999 18285 1 Srect
+9001 7024 31359 17645 1 Srect
+/Slrgb {0.000 0.000 0.000} def
+/Strgb {0.000 0.000 0.000} def
+/Slw 0.120 def
+9001 7024 9001 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+13344 7024 13344 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+17688 7024 17688 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+22031 7024 22031 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+26375 7024 26375 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+30719 7024 30719 17645 Sln
+/Slw 0.576 def
+/Ssrgb {0.102 0.278 0.435} def
+/Slw 0.720 def
+/Slrgb {0.102 0.278 0.435} def
+9001 7955 16816 9413 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+16816 7955 19514 9413 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+19514 7955 24286 9413 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+24286 7955 28367 9413 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+28367 7955 30719 9413 1 Srect
+/Ssrgb {0.102 0.278 0.435} def
+/Slrgb {0.102 0.278 0.435} def
+9001 10389 18822 11846 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+18822 10389 22583 11846 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+22583 10389 26894 11846 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+26894 10389 29357 11846 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+29357 10389 30719 11846 1 Srect
+/Ssrgb {0.102 0.278 0.435} def
+/Slrgb {0.102 0.278 0.435} def
+9001 12823 21136 14280 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+21136 12823 24821 14280 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+24821 12823 28280 14280 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+28280 12823 29415 14280 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+29415 12823 30719 14280 1 Srect
+/Ssrgb {0.102 0.278 0.435} def
+/Slrgb {0.102 0.278 0.435} def
+9001 15256 21888 16714 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+21888 15256 26852 16714 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+26852 15256 29382 16714 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+29382 15256 30385 16714 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+30385 15256 30719 16714 1 Srect
+12908 8506 0.000 508 (36) Stxtc
+18165 8506 0.000 508 (12) Stxtc
+21900 8506 0.000 508 (22) Stxtc
+26327 8506 0.000 508 (19) Stxtc
+29543 8506 0.000 508 (11) Stxtc
+13911 10940 0.000 508 (45) Stxtc
+20702 10940 0.000 508 (17) Stxtc
+24738 10940 0.000 508 (20) Stxtc
+28126 10940 0.000 508 (11) Stxtc
+30038 10940 0.000 508 (6) Stxtc
+15068 13373 0.000 508 (56) Stxtc
+22978 13373 0.000 508 (17) Stxtc
+26551 13373 0.000 508 (16) Stxtc
+28848 13373 0.000 508 (5) Stxtc
+30067 13373 0.000 508 (6) Stxtc
+15444 15807 0.000 508 (59) Stxtc
+24370 15807 0.000 508 (23) Stxtc
+28117 15807 0.000 508 (12) Stxtc
+29883 15807 0.000 508 (5) Stxtc
+30552 15807 0.000 508 (2) Stxtc
+/Slw 0.576 def
+/Slrgb {0.000 0.000 0.000} def
+9001 7024 31359 7024 Sln
+9001 7024 9001 6770 Sln
+9001 6199 0.000 635 (0) Stxtc
+13344 7024 13344 6770 Sln
+13344 6199 0.000 635 (20) Stxtc
+17688 7024 17688 6770 Sln
+17688 6199 0.000 635 (40) Stxtc
+22031 7024 22031 6770 Sln
+22031 6199 0.000 635 (60) Stxtc
+26375 7024 26375 6770 Sln
+26375 6199 0.000 635 (80) Stxtc
+30719 7024 30719 6770 Sln
+30719 6199 0.000 635 (100) Stxtc
+9001 7024 9001 17645 Sln
+8747 8462 0.000 635 (Studienabschlussphase >9) Stxtr
+8747 10896 0.000 635 (Hauptstudium 5-9) Stxtr
+8747 13329 0.000 635 (Vertiefungsphase 3-4) Stxtr
+8747 15763 0.000 635 (Studienanfangsphase 1-2) Stxtr
+/Ssrgb {1.000 1.000 1.000} def
+/Slrgb {1.000 1.000 1.000} def
+15389 859 24970 5598 1 Srect
+/Ssrgb {0.102 0.278 0.435} def
+/Slw 0.720 def
+/Slrgb {0.102 0.278 0.435} def
+15663 4689 16465 5324 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+15663 3800 16465 4435 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+15663 2911 16465 3546 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+15663 2023 16465 2657 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+15663 1134 16465 1769 1 Srect
+16674 4784 0.000 635 (Ich konnte bisher immer teilnehmen) Stxtl
+16674 3896 0.000 635 (1-mal) Stxtl
+16674 3007 0.000 635 (2-mal) Stxtl
+16674 2118 0.000 635 (3-mal) Stxtl
+16674 1229 0.000 635 (mehr als 3-mal) Stxtl
+S showpage
+%%EOF
diff --git a/macros/latex/contrib/epspdfconversion/example/image2.eps b/macros/latex/contrib/epspdfconversion/example/image2.eps
new file mode 100644
index 0000000000..a0c4a4516f
--- /dev/null
+++ b/macros/latex/contrib/epspdfconversion/example/image2.eps
@@ -0,0 +1,496 @@
+%!PS-Adobe-2.0 EPSF-2.0
+%% This is a Stata generated postscript file
+%%BoundingBox: 0 0 504 288
+%%HiResBoundingBox: 0.000 0.000 504.000 288.000
+%%DocumentNeededResources: font Helvetica
+/xratio 0.015750 def
+/yratio 0.015751 def
+/Sbgfill {
+ /y1 exch def
+ /x1 exch def
+ /y0 exch def
+ /x0 exch def
+ x0 y0 moveto
+ x0 y1 lineto x1 y1 lineto x1 y0 lineto x0 y0 lineto
+ fill
+} def
+/Spt {
+ yratio mul
+ /yp exch def
+ xratio mul
+ /xp exch def
+ Slrgb setrgbcolor
+ newpath
+ xp yp moveto
+ xp Slw add yp
+ lineto
+ currentlinecap
+ 1 setlinecap
+ stroke
+ setlinecap
+} def
+/Sln {
+ yratio mul
+ /y1p exch def
+ xratio mul
+ /x1p exch def
+ yratio mul
+ /y0p exch def
+ xratio mul
+ /x0p exch def
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x0p y0p M x1p y1p lineto S
+} def
+/Stxtl {
+ /sp exch def
+ yratio mul
+ /sizep exch def
+ dup
+ /anglep exch def
+ 0 exch sub
+ /angle2p exch def
+ yratio mul
+ /y0p exch def
+ xratio mul
+ /x0p exch def
+ Strgb setrgbcolor
+ x0p y0p M anglep rotate sizep fntsize sp show stroke angle2p rotate
+} def
+/Stxtc {
+ /sp exch def
+ yratio mul
+ /sizep exch def
+ dup
+ /anglep exch def
+ 0 exch sub
+ /angle2p exch def
+ yratio mul
+ /y0p exch def
+ xratio mul
+ /x0p exch def
+ Strgb setrgbcolor
+ x0p y0p M anglep rotate sizep fntsize sp stringwidth exch -2 div exch rm sp show stroke angle2p rotate
+} def
+/Stxtr {
+ /sp exch def
+ yratio mul
+ /sizep exch def
+ dup
+ /anglep exch def
+ 0 exch sub
+ /angle2p exch def
+ yratio mul
+ /y0p exch def
+ xratio mul
+ /x0p exch def
+ Strgb setrgbcolor
+ x0p y0p M anglep rotate sizep fntsize sp stringwidth 1 index -1 mul exch rm pop sp show stroke angle2p rotate
+} def
+/Srect {
+ /sfill exch def
+ yratio mul
+ /y1 exch def
+ xratio mul
+ /x1 exch def
+ yratio mul
+ /y0 exch def
+ xratio mul
+ /x0 exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ x0 y0 moveto
+ x0 y1 lineto x1 y1 lineto x1 y0 lineto x0 y0 lineto
+ fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x0 y0 moveto
+ x0 y1 lineto x1 y1 lineto x1 y0 lineto x0 y0 lineto
+ stroke
+} def
+/Stri {
+ /sfill exch def
+ xratio mul
+ /r exch def
+ yratio mul
+ /y0 exch def
+ xratio mul
+ /x0 exch def
+ /xcen x0 def
+ y0 r add
+ /ytop exch def
+ r 2 div
+ y0 exch sub
+ /ybot exch def
+ r 3 sqrt 2 div mul dup
+ xcen exch sub
+ /xleft exch def
+ xcen add
+ /xright exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ xcen ytop moveto xright ybot lineto xleft ybot lineto xcen ytop lineto fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ xcen ytop moveto xright ybot lineto xleft ybot lineto xcen ytop lineto stroke
+} def
+/Soldtri {
+ /sfill exch def
+ xratio mul
+ /r exch def
+ yratio mul
+ /y0 exch def
+ xratio mul
+ /x0 exch def
+ x0 r sub
+ /x1 exch def
+ y0 r sub
+ /y1 exch def
+ x0 r add
+ /x2 exch def
+ y0 r sub
+ /y2 exch def
+ /x3 x0 def
+ y0 r add
+ /y3 exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ x1 y1 moveto x2 y2 lineto x3 y3 lineto x1 y1 lineto fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x1 y1 moveto x2 y2 lineto x3 y3 lineto x1 y1 lineto stroke
+} def
+/Sdia {
+ /sfill exch def
+ xratio mul
+ /r exch def
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x r sub
+ /x0 exch def
+ /y0 y def
+ /x1 x def
+ y r sub
+ /y1 exch def
+ x r add
+ /x2 exch def
+ /y2 y def
+ /x3 x def
+ y r add
+ /y3 exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ x0 y0 moveto x1 y1 lineto x2 y2 lineto x3 y3 lineto x0 y0 lineto fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x0 y0 moveto x1 y1 lineto x2 y2 lineto x3 y3 lineto x0 y0 lineto stroke
+} def
+/Scc {
+ /sfill exch def
+ xratio mul
+ /r0 exch def
+ yratio mul
+ /y0 exch def
+ xratio mul
+ /x0 exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ x0 y0 r0 0 360 arc fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ x0 y0 r0 0 360 arc stroke
+} def
+/Spie {
+ /sfill exch def
+ /a1 exch def
+ /a0 exch def
+ xratio mul
+ /r exch def
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ newpath x y moveto x y r a0 a1 arc closepath
+ fill
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ newpath x y moveto x y r a0 a1 arc closepath
+ stroke
+} def
+/Splu {
+ xratio mul
+ /r exch def
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x r sub
+ /x0 exch def
+ x r add
+ /x1 exch def
+ x0 y M x1 y L
+ y r sub
+ /y0 exch def
+ y r add
+ /y1 exch def
+ x y0 M x y1 L
+} def
+/Scro {
+ xratio mul
+ /r exch def
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x r sub
+ /x0 exch def
+ y r sub
+ /y0 exch def
+ x r add
+ /x1 exch def
+ y r add
+ /y1 exch def
+ x0 y0 M x1 y1 L
+ x r add
+ /x0 exch def
+ y r sub
+ /y0 exch def
+ x r sub
+ /x1 exch def
+ y r add
+ /y1 exch def
+ x0 y0 M x1 y1 L
+} def
+/Sm {
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x y M
+} def
+/Sl {
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x y L
+} def
+/SPl {
+ yratio mul
+ /y exch def
+ xratio mul
+ /x exch def
+ x y PL
+} def
+/Lcs {
+ currentlinecap
+ 1 setlinecap
+} def
+/Lcr {
+ setlinecap
+} def
+/Sbp {
+ newpath
+} def
+/Sep {
+ /sfill exch def
+ closepath
+ sfill 1 eq {
+ Ssrgb setrgbcolor
+ gsave
+ fill
+ grestore
+ } if
+ Slw setlinewidth
+ Slrgb setrgbcolor
+ Lcs
+ stroke
+ Lcr
+} def
+/cp {currentpoint} def
+/M {moveto} def
+/rm {rmoveto} def
+/S {stroke} def
+/L {Slw setlinewidth Slrgb setrgbcolor lineto Lcs S Lcr} def
+/PL {Slw setlinewidth Slrgb setrgbcolor lineto} def
+/MF { % make new latin1 encoded font
+ /newfontname exch def
+ /fontname exch def
+ /fontdict fontname findfont def
+ /newfont fontdict maxlength dict def
+ fontdict {
+ exch dup /FID eq {pop pop} {exch newfont 3 1 roll put} ifelse
+ } forall
+ newfont /FontName newfontname put
+ newfont /Encoding ISOLatin1Encoding put
+ newfontname newfont definefont pop
+} def
+/Helvetica /Helvetica-Latin1 MF
+/reg {/Helvetica-Latin1 findfont 1 scalefont setfont } def
+/fntsize {/Helvetica-Latin1 findfont exch scalefont setfont } def
+/Slw 0.120 def
+1.000 1.000 1.000 setrgbcolor
+0 0 504.000 288.000 Sbgfill
+/Slrgb {1.000 1.000 1.000} def
+/Strgb {1.000 1.000 1.000} def
+/Ssrgb {1.000 1.000 1.000} def
+/Slw 0.576 def
+0 0 31999 18285 1 Srect
+9001 7024 31359 17645 1 Srect
+/Slrgb {0.000 0.000 0.000} def
+/Strgb {0.000 0.000 0.000} def
+/Slw 0.120 def
+9001 7024 9001 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+13344 7024 13344 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+17688 7024 17688 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+22031 7024 22031 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+26375 7024 26375 17645 Sln
+/Slw 0.576 def
+/Slw 0.120 def
+30719 7024 30719 17645 Sln
+/Slw 0.576 def
+/Ssrgb {0.102 0.278 0.435} def
+/Slw 0.720 def
+/Slrgb {0.102 0.278 0.435} def
+9001 7955 16816 9413 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+16816 7955 19514 9413 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+19514 7955 24286 9413 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+24286 7955 28367 9413 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+28367 7955 30719 9413 1 Srect
+/Ssrgb {0.102 0.278 0.435} def
+/Slrgb {0.102 0.278 0.435} def
+9001 10389 18822 11846 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+18822 10389 22583 11846 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+22583 10389 26894 11846 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+26894 10389 29357 11846 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+29357 10389 30719 11846 1 Srect
+/Ssrgb {0.102 0.278 0.435} def
+/Slrgb {0.102 0.278 0.435} def
+9001 12823 21136 14280 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+21136 12823 24821 14280 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+24821 12823 28280 14280 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+28280 12823 29415 14280 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+29415 12823 30719 14280 1 Srect
+/Ssrgb {0.102 0.278 0.435} def
+/Slrgb {0.102 0.278 0.435} def
+9001 15256 21888 16714 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+21888 15256 26852 16714 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+26852 15256 29382 16714 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+29382 15256 30385 16714 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+30385 15256 30719 16714 1 Srect
+12908 8506 0.000 508 (36) Stxtc
+18165 8506 0.000 508 (12) Stxtc
+21900 8506 0.000 508 (22) Stxtc
+26327 8506 0.000 508 (19) Stxtc
+29543 8506 0.000 508 (11) Stxtc
+13911 10940 0.000 508 (45) Stxtc
+20702 10940 0.000 508 (17) Stxtc
+24738 10940 0.000 508 (20) Stxtc
+28126 10940 0.000 508 (11) Stxtc
+30038 10940 0.000 508 (6) Stxtc
+15068 13373 0.000 508 (56) Stxtc
+22978 13373 0.000 508 (17) Stxtc
+26551 13373 0.000 508 (16) Stxtc
+28848 13373 0.000 508 (5) Stxtc
+30067 13373 0.000 508 (6) Stxtc
+15444 15807 0.000 508 (59) Stxtc
+24370 15807 0.000 508 (23) Stxtc
+28117 15807 0.000 508 (12) Stxtc
+29883 15807 0.000 508 (5) Stxtc
+30552 15807 0.000 508 (2) Stxtc
+/Slw 0.576 def
+/Slrgb {0.000 0.000 0.000} def
+9001 7024 31359 7024 Sln
+9001 7024 9001 6770 Sln
+9001 6199 0.000 635 (0) Stxtc
+13344 7024 13344 6770 Sln
+13344 6199 0.000 635 (20) Stxtc
+17688 7024 17688 6770 Sln
+17688 6199 0.000 635 (40) Stxtc
+22031 7024 22031 6770 Sln
+22031 6199 0.000 635 (60) Stxtc
+26375 7024 26375 6770 Sln
+26375 6199 0.000 635 (80) Stxtc
+30719 7024 30719 6770 Sln
+30719 6199 0.000 635 (100) Stxtc
+9001 7024 9001 17645 Sln
+8747 8462 0.000 635 (Studienabschlussphase >9) Stxtr
+8747 10896 0.000 635 (Hauptstudium 5-9) Stxtr
+8747 13329 0.000 635 (Vertiefungsphase 3-4) Stxtr
+8747 15763 0.000 635 (Studienanfangsphase 1-2) Stxtr
+/Ssrgb {1.000 1.000 1.000} def
+/Slrgb {1.000 1.000 1.000} def
+15389 859 24970 5598 1 Srect
+/Ssrgb {0.102 0.278 0.435} def
+/Slw 0.720 def
+/Slrgb {0.102 0.278 0.435} def
+15663 4689 16465 5324 1 Srect
+/Ssrgb {0.565 0.208 0.231} def
+/Slrgb {0.565 0.208 0.231} def
+15663 3800 16465 4435 1 Srect
+/Ssrgb {0.333 0.459 0.184} def
+/Slrgb {0.333 0.459 0.184} def
+15663 2911 16465 3546 1 Srect
+/Ssrgb {0.890 0.494 0.000} def
+/Slrgb {0.890 0.494 0.000} def
+15663 2023 16465 2657 1 Srect
+/Ssrgb {0.431 0.557 0.518} def
+/Slrgb {0.431 0.557 0.518} def
+15663 1134 16465 1769 1 Srect
+16674 4784 0.000 635 (Ich konnte bisher immer teilnehmen) Stxtl
+16674 3896 0.000 635 (1-mal) Stxtl
+16674 3007 0.000 635 (2-mal) Stxtl
+16674 2118 0.000 635 (3-mal) Stxtl
+16674 1229 0.000 635 (mehr als 3-mal) Stxtl
+S showpage
+%%EOF
diff --git a/macros/latex/contrib/epspdfconversion/example/optionstable.tex b/macros/latex/contrib/epspdfconversion/example/optionstable.tex
new file mode 100644
index 0000000000..f165d0fb9d
--- /dev/null
+++ b/macros/latex/contrib/epspdfconversion/example/optionstable.tex
@@ -0,0 +1,97 @@
+% !TEX root = epspdfconversion_docu.tex
+%START CODE FOR THE LONG TABLE
+\small
+\begin{longtable}{
+>{\hsize=.9\hsize}X
+>{\hsize=1.1\hsize}X
+}
+%Die Summe muss/sollte 2 sein. Man kontrolliert damit die Breite der Spalten, wobei Zeilenumbruch in der Spalte funktioniert!
+%
+% Definition of Headers and caption, these are shown where the table starts
+\caption{Options for the package {\pack}\label{optiontable}}
+\\
+\toprule
+option & explanation \\ \midrule
+\endfirsthead
+% % Definition of Headers and caption, these are shown after a page break
+\caption[]{Options for the package {\pack} -- continued}
+\\
+\toprule
+option & explanation \\ \midrule
+\endhead
+% before a page break you will see:
+\midrule
+\multicolumn{2}{r}{... continued on the next page ....} \\
+\endfoot
+% when the tabloe ends, you will see:
+\bottomrule
+\endlastfoot
+%%%%%
+%%%%% the content of the table comes after here
+%
+\multicolumn{2}{l}{\textbf{Options related to epspdf}} \\
+%
+\verb"help" & You will be shown the help of the epspdf command in your logfile. This option does not overrule all the others as previously.\\ & \\
+%
+\verb"simple" & the epspdf-conversion will be done with no option at all. Don't use it together with any of the options below.\\ & \\
+%
+\verb"gray | grey | GRAY | GREY" & gray | grey : convert eps-figures to grayscale (success not guaranteed); GRAY | GREY: Try harder to convert to grayscale (success still not guaranteed) \\
+%
+\verb"nogray | nogrey" & nogray | nogrey : do not try to convert eps-figures to grayscale \\ & \\
+%
+\verb"default | printer |" \verb"prepress | screen | ebook |" \verb"target=default |" \verb"target=printer | " \verb"target=prepess |" \verb"target=screen | " \verb"target=ebook" & target use of pdf \\ & \\
+%
+\verb"pdfversion=default |" \verb"pdfversion=1.2 |" \verb"pdfversion=1.3 |" \verb"pdfversion=1.4" & Pdf version to be generated. Setting another version than those on the left will result in an error. `default' means
+whatever Ghostscript's default is. \\ & \\
+%
+\verb"bbox |" \verb"bbox=true" | \verb"bbox=false" & If true: Compute tight boundingbox\\ & \\
+%
+\verb"nopdftops" & Ignore pdftops even if available (default: use if available)\\ & \\
+%
+\verb"pdftops" & use pdftops if available\\ & \\
+%
+\verb"hires" & compute hires-Boundingbox\\ & \\
+%
+\verb"no-hires" & don't compute hires-Boundingbox\\ & \\
+%
+\verb"custom={-dPDFX}" & This option allows you to pass a string to the ghostscript-commandline. On the left it would be Here you can set custom options for conversion to pdf,
+view \href{http://pages.cs.wisc.edu/~ghost/doc/cvs/Use.htm}{Use.htm} and \href{http://pages.cs.wisc.edu/~ghost/doc/cvs/Ps2pdf.htm}{ps2pdf.htm} from
+the Ghostscript documentation set. The example on the left adds \verb"-dPDFX" to the ghostscript-call by epstopdf \\ & \\
+%
+\verb"psoptions={-level2}" & This sets the options for pdftops; the default is -level2, don't include -eps or page number options; these will be generated by epstopdf itself \\ & \\
+%
+\verb"pagenumber={1}" & Page (in the source-file) to be converted\\ & \\
+%
+\multicolumn{2}{l}{\textbf{Options related to epstopdf.sty (the package)}} \\
+%
+ & These options are options that are passed over to epstopdf.sty that works in the background. You could also use
+\verb"\epstopdfsetup{OPTIONSforEPSTOPDF}",
+but you can also control the behaviour of epstopdf.sty by means of setting options of {\pack}. The explanation is borrowed from the \href{http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/epstopdf.pdf}{documentation of epstopdf}.\\ & \\
+%
+\verb"prepend" | \verb"prepend=true" | \verb"prepend=false" & Determines whether .eps is appended (if false) or prepended (if true) to the Graphics extension search list. (default: false). (Note that there is no option append. Use \verb"prepend=false" instead.)\\ & \\
+%
+\verb"update" | \verb"update=true" | \verb"update=false" & The conversion program is only called, if the target file does not exist or is older than the source image file. If false, the conversion is done with every run of pdflatex. \verb"update=false" makes sense when you are not yet sure which settings for the conversion to pdf you are going to use.\\ & \\
+%
+\verb"verbose" | \verb"verbose=true" | \verb"verbose=false" & prints some information about the image in the .log file (default: true).
+\\ & \\
+%
+\verb"suffix={-mysuffix}" & defines a string that is put between the file name base and the extension of the output file. This avoids that existing pdf-files are overwritten. See the \href{http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/epstopdf.pdf}{documentation of epstopdf} for a more detailed explanation. (default: suffix=-epspdf-to)\\ & \\
+%
+\verb"prefersuffix" | \verb"prefersuffix=true" | \verb"prefersuffix=false" & If a suffix is set by option suffix, then there can be two image file names that could be taken into account for inclusion: A image file name with the suffix string inside its name and a image file name without; e.g. for
+\verb"foo.eps" the names could be:
+\verb"foo-suffix.pdf", \verb"foo.pdf"
+If option prefersuffix is turned on, the file \verb"foo-suffix.pdf" and its generation
+is preferred over using \verb"foo.pdf". Otherwise \verb"foo.pdf" is included without generating \verb"foo-suffix.pdf". (default: true)\\ & \\
+%
+\verb"outdir=./" & The converted file may put in another output directory. The value of outdir must include the directory separator. Example for the current directory: \newline
+\verb"\epstopdfsetup{outdir=./}"\newline
+For other directories ensure that they can be found. See \verb"\graphicspath" or \verb"TEXINPUTS". You might need to set \verb"suffix=" to use another directory than the current. (default: outdir not set, converted images are saved in the same directory as the source-files.) \\
+%
+\verb"pdftopdf" | \verb"pdftopdf=true" | \verb"pdftopdf=false" & Enable conversion also for .pdf-files. Detects an .pdf-file, converts it to an pdf, applying the other options that are set (grayscaling, ... ) and used the converted .pdf-file. (default: \verb"pdftopdf =false") \\
+%
+\verb"pstopdf" | \verb"pstopdf=true" | \verb"pstopdf=false" & Enable conversion also for .ps-files. Detects an .ps-file, converts it to an pdf and used this. (default: \verb"pstopdf=false") \\ \end{longtable}
+%END CODE FOR THE LONG TABLE
+
+
+
+