diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex | 55 |
1 files changed, 22 insertions, 33 deletions
diff --git a/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex b/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex index 238bf937673..a89995f74b8 100644 --- a/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex +++ b/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex @@ -16,7 +16,7 @@ \begin{document} \title{\texttt{pst2pdf}} -\subtitle{Running a PSTricks document with pdflatex;\\ \small v. 0.14} +\subtitle{Running a PSTricks document with pdflatex;\\ \small v. 0.15} \author{Herbert Vo\ss \\ Pablo Gonz\'{a}lez Luengo} \docauthor{} \date{\today} @@ -26,20 +26,6 @@ \clearpage -%\begin{abstract} -%\noindent -%\Lprog{pst2pdf} is a \Lprog{perl} \emph{script} for running a PSTricks document in a last run -%with pdflatex. - -%\vfill\noindent -%Thanks to: -%Rolf Niepraschk - -%\end{abstract} - -%\clearpage - - \section{Introduction} \PST\ as \PS\ related package uses the programming language \PS\ for internal calculations. This is an important advantage, because floating point arithmetic is no @@ -58,7 +44,8 @@ main document is replaced by the created images. \section{Requirements} \subsection{Programs needed} -\nxLprog{pst2pdf} needs \Lprog{pdftk}, \Lprog{ImageMagick} and \Lprog{poppler-utils} (or \Lprog{xpdf-utils}) for the process file in usual way. If you need a create .pdf image files (whitout related software) use single mode (see \ref{single}). +\nxLprog{pst2pdf} needs \Lprog{pdftk}, \Lprog{ImageMagick}, \Lprog{pdftoppm} and \Lprog{pdftops} +(from \Lprog{poppler-utils} or \Lprog{xpdf-utils}) for the process file. If you need a create .pdf image files (whitout \Lprog{pdftk}) use single mode (see \ref{single}). \subsection{Preparating file} The script scan the file for \Lenv{pspicture} and \Lenv{postscript} environments, @@ -120,16 +107,17 @@ For \TeX Live users: \nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{--options} \end{BDef} +In this way \nxLprog{pst2pdf} creates a new file called \Larg{file-pst.tex} and copy all \Lenv{pspicture} +and \Lenv{postscript} environments, then processed and create file-pdf.pdf and file-fig-1.pdf, file-fig-2.pdf, file-fig-\dots.pdf and file-fig-1.tex, file-fig-2.tex, file-fig-\dots.tex for all \Lenv{pspicture} and \Lenv{postscript} using \nxLprog{pdftk}. \subsection{Single mode} \label{single} -If \nxLprog{pst2pdf} can not process a file, used the option \Loption{--single} this process will create the file, whiout pdftk -(take a more time to create images files) by default create PDF files. For exampple: +If you do not have \nxLprog{pdftk} use the option \Loption{--single} in this mode the files are processed separately (take a more time to create images files) by default create PDF files. For example: \begin{BDef} -\nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{--pdf} \OptArg*{--single} +\nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{--single} \end{BDef} -create file-pdf.pdf and file-pst-1.pdf, file-pst-2.pdf, file-pst-\dots.pdf for all \Lenv{pspicture} and \Lenv{postscript} environments in the directory for the created images (see \ref{options}). +create file-pdf.pdf and file-fig-1.pdf, file-fig-2.pdf, file-fig-\dots.pdf and file-fig-1.tex, file-fig-2.tex, file-fig-\dots.tex for all \Lenv{pspicture} and \Lenv{postscript} environments (see \ref{options}). \section{Options} \label{options} @@ -143,19 +131,18 @@ The options listed in Table~\ref{perloptions} refer only to the \emph{script} an \Loption{--Iext} & literal & .pdf & the extension for \Loption{PrependGraphicsExtensions}.\\ \Loption{--DPI} & integer & 75 & the dots per inch for a created \Lext{ppm} file.\\ \Loption{--Iscale} & real & 1 & the value for the option \Loption{scale} in \Lcs{includegraphics}.\\ -\Loption{--eps} & boolean & 0 & creates \Lext{eps} images files (need pdftops).\\ -\Loption{--ppm} & boolean & 0 & creates \Lext{ppm} images files (need pdftoppm).\\ -\Loption{--files} & boolean & 0 & creates \Lext{tex} for all images.\\ +\Loption{--eps} & boolean & 0 & creates \Lext{eps} images (need \Lprog{pdftops}).\\ +\Loption{--jpg} & boolean & 0 & creates \Lext{jpg} images (need \Lprog{pdftoppm} and \Lprog{ImageMagick}).\\ +\Loption{--png} & boolean & 0 & creates \Lext{png} images (need \Lprog{pdftoppm} and \Lprog{ImageMagick}).\\ \Loption{--verbose} & boolean & 1 & for a long \nxLprog{pst2pdf} log.\\ -\Loption{--norun} & boolean & 0 & create files, but no compile.\\ +\Loption{--PS2} & literal & empty & pass options to \nxLprog{ps2pdf}.\\ \Loption{--clear} & boolean & 0 & delete all temporary files.\\ \Loption{--help} & boolean & 1 & print help and exit.\\ \Loption{--single} & boolean & 0 & create images type (whitout pdftk).\\ -\Loption{--all} & boolean & 0 & generte all image type (.pdf, .eps, .tex).\\ -\Loption{--version} & boolean & 0 & print version and exit.\\ +\Loption{--all} & boolean & 0 & generte all image (.pdf, .eps, .jpg, .png, .tex) and clear.\\ \Loption{--license} & boolean & 0 & print license and exit.\\ \Loption{--xetex} & boolean & 0 & using \Lprog{xelatex} instead of \Lprog{latex} for the process.\\ -\Loption{--noImages} & boolean & 0 & generate files but no images (need \Loption{--norun}).\\ +\Loption{--noImages} & boolean & 0 & generate file-pdf.tex, but no images.\\ \Loption{--runBibTeX}& boolean & 0 & runs \Lprog{bibtex} \\ \Loption{--runBiber} & boolean & 0 & runs \Lprog{biber} if a file with extension \Lext{bcf} exists \\\bottomrule \end{tabularx} @@ -167,17 +154,19 @@ For Help in command line use: \nxLprog{pst2pdf} \OptArg*{--help} \end{BDef} -\section{Other image format} -If your need \Lext{png}, \Lext{jpg} or other image type use \nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{--ppm} , than move to images dir and use \nxLprog{mogrify} command (from \Lprog{ImageMagick}), for examples:\\ +\section{Image format} +\nxLprog{pst2pdf} can create image files in the formats: \Lext{pdf}, \Lext{eps}, \Lext{jpg} and \Lext{png}. If you need to create other image formats use \nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{-png} without the option +\OptArg*{-clear} , than move to images dir and use \nxLprog{mogrify} command (from \Lprog{ImageMagick}), for examples:\\ \begin{BDef} -\nxLprog{mogrify} -format \OptArg*{png *.ppm} +\nxLprog{mogrify} -format gif \OptArg*{*.ppm} \end{BDef} -generate PNG images files and \\ +generate \Lext{gif} images files and \\ \begin{BDef} -\nxLprog{mogrify} -format \OptArg*{jpg *.ppm} +\nxLprog{mogrify} -format tiff \OptArg*{*.ppm} \end{BDef} -generate JPG images files. +generate \Lext{tiff} images files. +\enlargethispage{1cm} \bgroup \raggedright \nocite{*} |