| 1 |
.so /usr/lib/tmac/tmac.pictures |
| 2 |
.nr PS 11 |
| 3 |
.nr VS 13 |
| 4 |
.TL |
| 5 |
MetaPost with troff |
| 6 |
.LP |
| 7 |
Since MetaPost is a picture-drawing language that outputs PostScript, it is |
| 8 |
necessary to use the |
| 9 |
.ft CW |
| 10 |
-mpictures |
| 11 |
.ft |
| 12 |
macro package. Suppose you have written some figures in MetaPost and placed |
| 13 |
the input in a file \f(CWfigures.mp\fR. |
| 14 |
Running |
| 15 |
.nf |
| 16 |
.ft CW |
| 17 |
mp -T figures |
| 18 |
.ft |
| 19 |
.fi |
| 20 |
to invoke the MetaPost interpreter produces output files |
| 21 |
\f(CWfigures.1\fR, \f(CWfigures.2\fR, .\|.\|. |
| 22 |
via macro calls such as |
| 23 |
.nf |
| 24 |
.ft CW |
| 25 |
.BP figures.1 height width |
| 26 |
.ft |
| 27 |
.fi |
| 28 |
as explained in the |
| 29 |
.ft CW |
| 30 |
-mpictures |
| 31 |
.ft |
| 32 |
documentation. Note that the picture gets rescaled if the height and width |
| 33 |
in the \f(CW.BP\fR command don't match \fImp\fR's idea of the picture dimensions. |
| 34 |
.PP |
| 35 |
For instance, |
| 36 |
.BP figs.1 1.08i 1.5i |
| 37 |
this figure was derived from a file |
| 38 |
.ft CW |
| 39 |
figs.mp |
| 40 |
.ft |
| 41 |
and included at this point by invoking the \f(CW.BP\fR |
| 42 |
macro with height 1.08 inches and width 1.5 inches. The macro tries to run text |
| 43 |
around the picture, but this can be stopped |
| 44 |
by using the \f(CW.EP\fR macro as was done here. |
| 45 |
.EP |
| 46 |
The file |
| 47 |
.ft CW |
| 48 |
figs.mp |
| 49 |
.ft |
| 50 |
looks like this: |
| 51 |
.nf |
| 52 |
.ft CW |
| 53 |
.nr PS 9 |
| 54 |
.nr VS 11 |
| 55 |
prologues:=1; |
| 56 |
input boxes |
| 57 |
beginfig(1); |
| 58 |
pair shadowshift; shadowshift=(1,-1)*bp; |
| 59 |
|
| 60 |
def drawshadowed(text t) = |
| 61 |
forsuffixes $=t: |
| 62 |
fill bpath$ shifted shadowshift; |
| 63 |
unfill bpath$; |
| 64 |
drawboxed($); |
| 65 |
endfor |
| 66 |
enddef; |
| 67 |
|
| 68 |
boxit.a(btex \\s8A\\s+2 \\(lh a etex); |
| 69 |
circleit.b(btex $e sup {i omega t}$ etex rotated 20); |
| 70 |
b.w - a.e = (10bp,0); |
| 71 |
drawshadowed(a,b); |
| 72 |
draw a.e..b.w; |
| 73 |
|
| 74 |
draw bbox currentpicture dashed evenly; |
| 75 |
endfig; |
| 76 |
.nr PS 11 |
| 77 |
.nr VS 13 |
| 78 |
.ft |
| 79 |
.fi |
| 80 |
.PP |
| 81 |
Note that the typesetting commands in the |
| 82 |
\f(CWbtex\fR.\|.\|.\f(CWetex\fR blocks in the above example are processed by |
| 83 |
.nf |
| 84 |
.ft CW |
| 85 |
eqn -d\\$\\$ | troff; |
| 86 |
.ft |
| 87 |
.fi |
| 88 |
If a different \fItroff\fR pipeline is desired, it can be specified via the |
| 89 |
.ft CW |
| 90 |
TROFF |
| 91 |
.ft |
| 92 |
environment variable. For example, |
| 93 |
.nf |
| 94 |
.ft CW |
| 95 |
TROFF='tbl | eqn -d\\$\\$ | troff -Tpost' |
| 96 |
.ft |
| 97 |
.fi |
| 98 |
adds \fItbl\fR to the pipeline. |
| 99 |
.PP |
| 100 |
Macro definitions and such can be added via the standard |
| 101 |
\f(CWverbatimtex\fR.\|.\|.\f(CWetex\fR mechanism that adds the given material |
| 102 |
to the \fItroff\fR input. Such material should not generate any output since |
| 103 |
this would get mixed up with the next \f(CWbtex\fR.\|.\|.\f(CWetex\fR block. |
| 104 |
Thus, newlines between \f(CWverbatimtex\fR and \f(CWetex\fR must be |
| 105 |
protected with \f(CW\\\fR. |