| MPICTURES(7) | MPICTURES(7)
| NAME
| mpictures – picture inclusion macros
SYNOPSIS
| `troff −mpictures` [ options ] file ...
DESCRIPTION
| 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: sourceName of a PostScript picture file, optionally suffixed with (n) to select page number n from the file (first page by default). heightVertical size of the frame, default `3.0i`. width Horizontal size of the frame, current line length by default. position
| `l` (default), `c`, or `r` to left-justify, center, or right-justify the frame.
offsetMove the frame horizontally from the original position by this amount, default `0i`. flags One or more of:
| `a` d Rotate the picture clockwise d degrees, default d=90. `o` Outline the picture with a box. `s` Freely scale both picture dimensions. `w` White out the area to be occupied by the picture. `l`,`r`,`t`,`b`Attach the picture to the left right, top, or bottom of the frame.
label 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 height`,`width`,`yoffset,xoffset flags.
| This low-level macro, used by `.BP`, can help do more complex things. The two arguments not already described are: xoffsetOffset the frame from the left margin by this amount, default `0i`. yoffsetOffset the frame from the current baseline, measuring positive downward, default `0i`.
`.EP` 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.
SEE ALSO
| troff(1)
DIAGNOSTICS
| A picture file that can’t be read by the PostScript postprocessor is replaced by white space.
BUGS
| 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 retrieve it.
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.