summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/faq-graphics.tex
diff options
context:
space:
mode:
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.tex129
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{}}