summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelfig.html
blob: c92beebbda0bc31f8bd025438b510af02c901a5c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<head>
<title>UK TeX FAQ -- question label labelfig</title>
</head><body>
<h3>Labelling graphics</h3>
<p/>&#8220;Technical&#8221; graphics (such as graphs and diagrams) are often
labelled with quite complex mathematical expressions: there are few
drawing or graphing tools that can do such things (the honourable
exception being MetaPost, which allows you to program the labels, in
(La)TeX, in the middle of specifying your graphic).
<p/>Labels on graphics produced by all those <em>other</em> tools is where
the <i>psfrag</i> package can help.  Place an unique
text in your graphic, using the normal text features of your tool, and
you can ask <i>psfrag</i> to replace the text with arbitrary
(La)TeX material.  <i>Psfrag</i>&#8217;s &#8220;operative&#8221; command is
<code>\</code><code>psfrag{<em>PS text</em>}{<em>Repl text</em>}</code>, which instructs
the system to replace the original (&#8220;<code>PS</code>&#8221;) text with the
TeX-typeset replacement text.  Optional
arguments permit adjustment of position, scale and rotation; full
details may be found in <i>pfgguide</i> in the distribution.
<p/>Since <i>psfrag</i> works in terms of (encapsulated) PostScript files,
it needs extra work for use with PDFLaTeX.  The 
<a href="FAQ-pdftexgraphics.html"><i>pst-pdf</i> package</a> can support such
usage.  In fact, the <i>pst-pdf</i> support package
<i>auto-pst-pdf</i> offers a configuration setting precisely for
use with <i>psfrag</i>.
<p/>On the other hand,

  <a href="FAQ-commercial.html">VTeX</a>&#8217;s GeX processor
explicitly deals with <i>psfrag</i>, both in its free and
commercial instances.
<p/>The <i>psfragx</i> package goes one step further than
<i>psfrag</i>: it provides a means whereby you can put the
<i>psfrag</i> commands into the preamble of your EPS file
itself.  <i>Psfrag</i> has such a command itself, but deprecates
it; <i>psfragx</i> has cleaned up the facility, and provides a
script <i>laprint</i> for use with <i>Matlab</i> to produce
appropriately tagged output.  (In principle, other graphics
applications could provide a similar facility, but apparently none does.)
<p/><i>Emacs</i> users may find the embedded editor <i>iTe</i> a
useful tool for placing labels: it&#8217;s a (La)TeX-oriented graphical
editor written in <i>Emacs Lisp</i>.  You create
<code>iteblock</code> environments containing graphics and text, and
may then invoke <i>iTe</i> to arrange the elements relative to one
another.
<p/>Another useful approach is <i>overpic</i>, which overlays a
<code>picture</code> environment on a graphic included by use of
<code>\</code><code>includegraphics</code>.  This treatment lends itself to ready placement
of texts and the like on top of a graphic.  The package can draw a
grid for planning your &#8220;attack&#8221;; the distribution comes with simple
examples.
<p/><i>Pstricks</i> can of course do everything that <i>overpic</i>
can, with all the flexibility of PostScript programming that it offers
The <i>pstricks</i> web site has a page with several 
<a href="http://pstricks.tug.org/main.cgi?file=Examples/overlay">examples of labelling</a>
which will get you started; if <i>pstricks</i> is 
<a href="FAQ-drawing.html">an option for you</a>, this route is worth a try.
<p/>The confident user may, of course, do the whole job in a picture
environment which itself includes the graphic.  I would recommend
<i>overpic</i> or the <i>pstricks</i> approach, but such things
are plainly little more than a convenience over what is achievable
with the do-it-yourself approach.
<dl>
<dt><tt><i>auto-pst-pdf.sty</i></tt><dd><a href="http://mirror.ctan.org/macros/latex/contrib/auto-pst-pdf.zip">macros/latex/contrib/auto-pst-pdf</a> (or <a href="http://mirror.ctan.org/macros/latex/contrib/auto-pst-pdf/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/auto-pst-pdf.html">catalogue entry</a>
<dt><tt><i>iTe</i></tt><dd><a href="http://mirror.ctan.org/support/ite.zip">support/ite</a> (or <a href="http://mirror.ctan.org/support/ite/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/ite.html">catalogue entry</a>
<dt><tt><i>laprint</i></tt><dd>Distributed with <a href="http://mirror.ctan.org/macros/latex/contrib/psfragx.zip">macros/latex/contrib/psfragx</a> (or <a href="http://mirror.ctan.org/macros/latex/contrib/psfragx/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/psfragx.html">catalogue entry</a>
<dt><tt><i>overpic.sty</i></tt><dd><a href="http://mirror.ctan.org/macros/latex/contrib/overpic.zip">macros/latex/contrib/overpic</a> (or <a href="http://mirror.ctan.org/macros/latex/contrib/overpic/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/overpic.html">catalogue entry</a>
<dt><tt><i>psfrag.sty</i></tt><dd><a href="http://mirror.ctan.org/macros/latex/contrib/psfrag.zip">macros/latex/contrib/psfrag</a> (or <a href="http://mirror.ctan.org/macros/latex/contrib/psfrag/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/psfrag.html">catalogue entry</a>
<dt><tt><i>psfragx.sty</i></tt><dd><a href="http://mirror.ctan.org/macros/latex/contrib/psfragx.zip">macros/latex/contrib/psfragx</a> (or <a href="http://mirror.ctan.org/macros/latex/contrib/psfragx/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/psfragx.html">catalogue entry</a>
<dt><tt><i>pstricks.sty</i></tt><dd><a href="http://mirror.ctan.org/graphics/pstricks.zip">graphics/pstricks</a> (or <a href="http://mirror.ctan.org/graphics/pstricks/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/pstricks.html">catalogue entry</a>
<dt><tt><i>pst-pdf.sty</i></tt><dd><a href="http://mirror.ctan.org/macros/latex/contrib/pst-pdf.zip">macros/latex/contrib/pst-pdf</a> (or <a href="http://mirror.ctan.org/macros/latex/contrib/pst-pdf/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/pst-pdf.html">catalogue entry</a>
</dl>
<p/>
<p/><p/><p/><p/><p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=labelfig">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=labelfig</a>
</body>