diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/faq-graphics.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/FAQ-en/faq-graphics.tex | 129 |
1 files changed, 84 insertions, 45 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faq-graphics.tex b/Master/texmf-dist/doc/generic/FAQ-en/faq-graphics.tex index ded17f9673c..ae795e5e529 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/faq-graphics.tex +++ b/Master/texmf-dist/doc/generic/FAQ-en/faq-graphics.tex @@ -1,4 +1,4 @@ -% $Id: faq-graphics.tex,v 1.10 2011/02/14 20:53:28 rf10 Exp $ +% $Id: faq-graphics.tex,v 1.17 2011/04/13 09:45:46 rf10 Exp $ \section{Graphics} @@ -186,7 +186,7 @@ files ``on the fly''; this is convenient, but requires that you suppress one of \TeX{}'s security checks: don't allow its use in files from sources you don't entirely trust. -A similar package, \Package{pst-pdf}, permits other things than `mere' +The package \Package{pst-pdf} permits other things than `mere' graphics files in its argument. \Package{Pst-pdf} operates (the authors suggest) ``like \BibTeX{}''~--- you process your file using \PDFLaTeX{}, then use \LaTeX{}, \ProgName{dvips} and \ProgName{ps2pdf} @@ -194,12 +194,25 @@ in succession, to produce a secondary file to input to your next \PDFLaTeX{} run. (Scripts are provided to ease the production of the secondary file.) +A further extension is \Package{auto-pst-pdf}, which generates +\acro{PDF} (essentially) transparently, by spawning a job to process +output such as \Package{pst-pdf} uses. If your \pdflatex{} +installation doesn't automatically allow it~--- see % ! line break +\Qref*{spawning a process}{Q-spawnprog}~--- then you need to start +\pdflatex{} with: +\begin{quote} +\begin{verbatim} +pdflatex -shell-escape <file> +\end{verbatim} +\end{quote} +for complete `automation'. + An alternative solution is to use \ProgName{purifyeps}, a \ProgName{Perl} script which uses the good offices of \ProgName{pstoedit} and of \MP{} to convert your Encapsulated \PS{} to -``Encapsulated \PS{} that comes out of \MP{}'', and can therefore be -included directly. Sadly, \ProgName{purifyeps} doesn't work for all -\extension{eps} files. +``Something that looks like the encapsulated \PS{} that comes out of +\MP{}'', and can therefore be included directly. Sadly, +\ProgName{purifyeps} doesn't work for all \extension{eps} files. Good coverage of the problem is to be found in Herbert Vo\ss {}'s \href{http://pstricks.tug.org/main.cgi?file=pdf/pdfoutput}{\acro{PDF} support page}, @@ -207,6 +220,7 @@ which is targeted at the use of \Package{pstricks} in \PDFLaTeX{}, and also covers the \Package{pstricks}-specific package \Package{pdftricks}. \begin{ctanrefs} +\item[auto-pst-pdf.sty]\CTANref{auto-pst-pdf} \item[epstopdf]Browse \CTANref{epstopdf} \item[epstopdf.sty]Distributed with Heiko Oberdiek's packages \CTANref{oberdiek} @@ -215,6 +229,7 @@ which is targeted at the use of \Package{pstricks} in \item[pstoedit]\CTANref{pstoedit} \item[purifyeps]\CTANref{purifyeps} \end{ctanrefs} +\LastEdit{2011-03-24} \Question[Q-dvipdfmgraphics]{Imported graphics in \ProgName{dvipdfm}} @@ -673,9 +688,10 @@ A script application, \ProgName{mptopdf}, is available in recent the question\dots{} \begin{ctanrefs} \item[mps2eps]\CTANref{mps2eps} -\item[mpsproof.tex]\CTANref{mpsproof} +\item[mpsproof.tex]Distributed as part of the \MP{} distribution \CTANref{metapost} \item[mptopdf]Part of \CTANref{pdftex-graphics} \end{ctanrefs} +\LastEdit{2010-03-16} \Question[Q-drawing]{Drawing with \TeX{}} @@ -715,9 +731,10 @@ of drawing, and setup, here are a few systems you may consider: diagrams, is available). \Package{Pstricks}' \csx{special}s are by default specific to \ProgName{dvips}, but V\TeX{} (both in its - commercial and in its free versions) understands them. \PDFTeX{} - users may use \Package{pst-pdf}, which (like - \Package{epstopdf}~--- see % ! line break + commercial and in its free versions) understands them, and there is + a \Package{Pstricks} `driver' that allow \Package{Pstricks} to + operate under \xetex{}. \PDFTeX{} users may use \Package{pst-pdf}, + which (like \Package{epstopdf}~--- see % ! line break \Qref[question]{\PDFLaTeX{} graphics}{Q-pdftexgraphics}) generates \acro{PDF} files using an auxiliary program, from \Package{PSTricks} commands (\Package{pst-pdf} also requires a recent installation of @@ -742,9 +759,9 @@ of drawing, and setup, here are a few systems you may consider: is nowadays part of most serious \AllTeX{} distributions. Knuth uses it for all his work\dots{} - Note that you can ``embed'' \MP{} source in your document (i.e., - keep it in-line with your \latex{} code), using the \Package{emp} - package. + Note that you can % ! line break + \Qref*{``embed'' \MP{} source in your document}{Q-inlgrphapp} (i.e., + keep it in-line with your \latex{} code). \item \ProgName{Mfpic}; you liked \MF{}, but can't understand the language? The package makes up \MF{} or \MP{} code for you within using familiar-looking \TeX{} macros. Not \emph{quite} the @@ -752,28 +769,48 @@ of drawing, and setup, here are a few systems you may consider: \MP{} output, the results can be used equally well in either \LaTeX{} or \PDFLaTeX{}. \item You liked \PiCTeX{} but don't have enough memory or time? Look - at Eitan Gurari's \Package{dratex}, which is as powerful as most - other \TeX{} drawing packages, but is an entirely new - implementation, which is not as hard on memory, is much more - readable (and is fully documented). -\item You fancy the idea of embedding the source of drawings (as with - \Package{emp}, but you like another drawing tool? In principle, - it's possible to do the same with other tools; for example - \Package{asyfig} allows you to embed % ! line break - \ProgName{asymptote} code in your document. + at Eitan Gurari's \Package{dratex}: it is just as powerful, but is + an entirely new implementation which is not as hard on memory, is + much more readable (and is fully documented). \end{itemize} +In addition, there are several means of generating code for your +graphics application (\ProgName{asymptote}, \ProgName{gnuplot} and +\MP{}, at least) in-line in your document, and then have them +processed in a command spawned from your \AllTeX{} run. For details, +see \Qref{question}{Q-inlgrphapp}. +\begin{ctanrefs} +\item[dratex.sty]\CTANref{dratex} +\item[epic.sty]\CTANref{epic} +\item[eepic.sty]\CTANref{eepic} +\item[eepicemu.sty]\CTANref{eepic} +\item[mfpic]\CTANref{mfpic} +\item[preview.sty]\CTANref{preview} +\item[pspicture.sty]\CTANref{pspicture} +\item[pst-pdf.sty]\CTANref{pst-pdf} +\item[pgf.sty]\CTANref{pgf} +\item[pict2e.sty]\CTANref{pict2e} +\item[pictex.sty]\CTANref{pictex} +\item[pstricks]\CTANref{pstricks} +\item[tikz.sty]Distributed with \CTANref{pgf} +\end{ctanrefs} +\LastEdit{2011-04-08} + +\Question[Q-inlgrphapp]{In-line source for graphics applications} + Some of the free-standing graphics applications may also be used (effectively) in-line in \latex{} documents; examples are \begin{booklist} -\item[asymptote]A package, \Package{asymptote}, defines an environment - \environment{asy} which arranges that its contents are included - (after ``enough'' runs, in the \latex{} way). +\item[asymptote]The package \Package{asymptote} (provided in the + \ProgName{asymptote} distribution) defines an environment + \environment{asy} which arranges that its contents are available for + processing, and will therefore be typeset (after ``enough'' runs, in + the `usual' \latex{} way). Basically, you write \begin{quote} - \cmdinvoke{begin}{asy} - \texttt{\meta{asymptote code}} + \cmdinvoke{begin}{asy}\\ + \latexhtml{\hspace*{1em}}{~~}\texttt{\meta{asymptote code}}\\ \cmdinvoke{end}{asy} \end{quote} and then execute @@ -784,30 +821,32 @@ asy document-*.asy latex document \end{verbatim} \end{quote} -\item[egplot]Allows you to incorporate \ProgName{\acro{GNU}plot} - code in your document, again for processing outside of \latex{}; the - design of this package was strongly influenced by that of \Package{emp} -\item[emp]Another of the same, this time for \MP{} graphics. +\item[egplot]Allows you to incorporate \ProgName{GNUplot} + instructions in your document, for processing outside of \latex{}. + The package provides commands that enable the user to do calculation + in \ProgName{GNUplot}, feeding the results into the diagram + to be drawn. +\item[gmp]Allows you to include the source of MetaPost diagrams, with + parameters of the diagram passed from the environment call. +\item[emp]An earlier package providing facilities similar to those of + \Package{gmp} (\Package{gmp}'s author hopes that his package will + support the facilities \Package{emp}, which he believes is in need + of update.) +\item[mpgraphics]Again, allows you to program parameters of \MP{} + diagrams from your \latex{} document, including the preamble details + of the \latex{} code in any recursive call from \MP{}. \end{booklist} +In all cases (other than \Package{asymptote}), these packages require +that you can % ! line break +\Qref*{run external programs from within your document}{Q-spawnprog}. \begin{ctanrefs} \item[asymptote.sty]\CTANref{asymptote} -\item[dratex.sty]\CTANref{dratex} -\item[egplot]\CTANref{egplot} -\item[emp]\CTANref{emp} -\item[epic.sty]\CTANref{epic} -\item[eepic.sty]\CTANref{eepic} -\item[eepicemu.sty]\CTANref{eepic} +\item[egplot.sty]\CTANref{egplot} \item[emp.sty]\CTANref{emp} -\item[mfpic]\CTANref{mfpic} -\item[preview.sty]\CTANref{preview} -\item[pspicture.sty]\CTANref{pspicture} -\item[pst-pdf.sty]\CTANref{pst-pdf} -\item[pgf.sty]\CTANref{pgf} -\item[pict2e.sty]\CTANref{pict2e} -\item[pictex.sty]\CTANref{pictex} -\item[pstricks]\CTANref{pstricks} -\item[tikz.sty]Distributed with \CTANref{pgf} +\item[gmp.sty]\CTANref{gmp} +\item[mpgraphics.sty]\CTANref{mpgraphics} \end{ctanrefs} +\LastEdit*{2011-03-16} \Question[Q-drawFeyn]{Drawing Feynman diagrams in \LaTeX{}} |