mpictures - picture inclusion macros
troff -mpictures [ options ] file ...
Mpictures macros insert PostScript pictures into troff(1)
documents. The macros are:
- .BP source height width position offset flags label
- Define a frame and place a picture in it. Null arguments, represented by
"", are interpreted as defaults. The arguments are:
- Name of a PostScript picture file, optionally suffixed with (n) to
select page number n from the file (first page by default).
- Vertical size of the frame, default 3.0i. This argument is
interpreted as a value in inches unless it ends with a `u' scale
- Horizontal size of the frame, current line length by default. This
argument is interpreted as a value in inches unless it ends with a `u'
- l (default), c, or r to left-justify, center, or
right-justify the frame.
- Move the frame horizontally from the original position by this
amount, default 0i.
- One or more of:
- Rotate the picture clockwise d degrees, default d=90.
- Outline the picture with a box.
- Freely scale both picture dimensions.
- White out the area to be occupied by the picture.
- Attach the picture to the left right, top, or bottom of the frame.
- Place label at distance 1.5v below the frame.
If there's room, .BP fills text around the frame.
Everything destined for either side of the frame goes into a diversion to be
retrieved when the accumulated text sweeps past the trap set by .BP
or when the diversion is explicitly closed by .EP.
- .PI source
- This low-level macro, used by .BP, can help do more complex things.
The two arguments not already described are:
- Offset the frame from the left margin by this amount, default 0i.
This argument is interpreted as a value in inches unless it ends with a
`u' scale indicator.
- Offset the frame from the current baseline, measuring positive downward,
default 0i. This argument is interpreted as a value in inches
unless it ends with a `u' scale indicator.
- End a picture started by .BP; .EP is usually called
implicitly by a trap at frame bottom.
If a PostScript file lacks page-delimiting comments, the entire
file is included. If no %%BoundingBox comment is present, the picture
is assumed to fill an 8.5×11-inch page. Nothing prevents the picture
from being placed off the page.
The `.psbb' troff request can be used to read the
%%BoundingBox comment for further processing, as in
A picture file that can't be read by the PostScript postprocessor is replaced by
A picture and associated text silently disappear if a diversion trap set by
.BP isn't reached. Call .EP at the end of the document to
.nr scale 4
.nr y (\n[ury]p-\n[lly]p)/\n[scale]
.nr x (\n[urx]p-\n[llx]p)/\n[scale]
.PI picture.eps "\nyu,\nxu"
Macros in other packages may break the adjustments made to the
line length and indent when text is being placed around a picture.
A missing or improper %%BoundingBox comment may cause the
frame to be filled incorrectly.