3 mpictures \- picture inclusion macros
12 macros insert PostScript pictures into
17 .BI .BP " source height width position offset flags label
18 Define a frame and place a picture in it.
19 Null arguments, represented by \f5""\fR,
20 are interpreted as defaults.
25 Name of a PostScript picture file, optionally
30 from the file (first page by default).
34 Vertical size of the frame, default
38 Horizontal size of the frame, current line length by default.
46 to left-justify, center, or right-justify the frame.
49 Move the frame horizontally from the original
51 by this amount, default
60 Rotate the picture clockwise
66 Outline the picture with a box.
69 Freely scale both picture dimensions.
72 White out the area to be occupied by the picture.
75 Attach the picture to the left right, top, or bottom of the frame.
88 fills text around the frame.
89 Everything destined for either side of the frame
90 goes into a diversion to be retrieved when the accumulated
91 text sweeps past the trap set by
93 or when the diversion is explicitly closed
98 .BI .PI " source height" , width , "yoffset\fB,\fPxoffset flags.
99 This low-level macro, used by
101 can help do more complex things.
102 The two arguments not already described are:
106 Offset the frame from the left margin by this amount, default
111 Offset the frame from the current baseline,
112 measuring positive downward, default
118 End a picture started by
121 is usually called implicitly by a trap
124 If a PostScript file lacks page-delimiting comments,
125 the entire file is included.
128 comment is present, the picture is
129 assumed to fill an 8.5\(mu11-inch page.
130 Nothing prevents the picture from being placed off the page.
134 A picture file that can't be read by the PostScript
135 postprocessor is replaced by white space.
137 A picture and associated text silently disappear if
138 a diversion trap set by
143 at the end of the document to retrieve it.
145 Macros in other packages may break the adjustments
146 made to the line length and indent when text is being placed
149 A missing or improper
151 comment may cause the frame to be filled incorrectly.