![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mpictures.6 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / adm / man6|
Return to mpictures.6 CVS log | Up to [Research Unix] / researchv10dc / man / adm / man6 |
1.1 root 1: .TH MPICTURES 6
2: .CT 1 writing_troff
3: .SH NAME
4: mpictures \- picture inclusion macros
5: .SH SYNOPSIS
6: .B troff -mpictures
7: [
8: .I options
9: ]
10: .I file ...
11: .SH DESCRIPTION
12: .I Mpictures
13: macros insert PostScript pictures into
14: .IR troff (1)
15: documents.
16: The macros are:
17: .TP
18: .BI .BP " source height width position offset flags label
19: Define a frame and place a picture in it.
20: Null arguments, represented by \f5""\fR,
21: are interpreted as defaults.
22: The arguments are:
23: .RS
24: .TP
25: .I source
26: Name of a PostScript picture file, optionally
27: suffixed with
28: .RI ( n )
29: to select page number
30: .I n
31: from the file (first page by default).
32: .PD0
33: .TP
34: .I height
35: Vertical size of the frame, default
36: .BR 3.0i .
37: .TP
38: .I width
39: Horizontal size of the frame, current line length by default.
40: .TP
41: .I position
42: .L l
43: (default),
44: .LR c ,
45: or
46: .L r
47: to left-justify, center, or right-justify the frame.
48: .TP
49: .I offset
50: Move the frame horizontally from the original
51: .I position
52: by this amount, default
53: .BR 0i .
54: .TP
55: .I flags
56: One or more of:
57: .RS
58: .PD 0v
59: .TP
60: .BI a d
61: Rotate the picture clockwise
62: .I d
63: degrees, default
64: .IR d =90.
65: .TP
66: .B o
67: Outline the picture with a box.
68: .TP
69: .B s
70: Freely scale both picture dimensions.
71: .TP
72: .B w
73: White out the area to be occupied by the picture.
74: .TP
75: .BR l , r , t ,\fPb
76: Attach the picture to the left right, top, or bottom of the frame.
77: .RE
78: .TP
79: .I label
80: Place
81: .I label
82: at distance
83: .B 1.5v
84: below the frame.
85: .PD
86: .PP
87: If there's room,
88: .B .BP
89: fills text around the frame.
90: Everything destined for either side of the frame
91: goes into a diversion to be retrieved when the accumulated
92: text sweeps past the trap set by
93: .B .BP
94: or when the diversion is explicitly closed
95: by
96: .BR .EP .
97: .RE
98: .TP
99: .BI .PI " source height" , width , "yoffset\fB,\fPxoffset flags.
100: This low-level macro, used by
101: .BR .BP ,
102: can help do more complex things.
103: The two arguments not already described are:
104: .RS
105: .TP
106: .I xoffset
107: Offset the frame from the left margin by this amount, default
108: .BR 0i .
109: .PD0
110: .TP
111: .I yoffset
112: Offset the frame from the current baseline,
113: measuring positive downward, default
114: .BR 0i .
115: .PD
116: .RE
117: .TP
118: .B .EP
119: End a picture started by
120: .BR .BP ;
121: .B .EP
122: is usually called implicitly by a trap
123: at frame bottom.
124: .PP
125: If a PostScript file lacks page-delimiting comments,
126: the entire file is included.
127: If no
128: .B %%BoundingBox
129: comment is present, the picture is
130: assumed to fill an 8.5\(mu11-inch page.
131: Nothing prevents the picture from being placed off the page.
132: .SH FILES
133: .F /usr/lib/tmac/tmac.pictures
134: .SH SEE ALSO
135: .IR troff (1)
136: .SH DIAGNOSTICS
137: A picture file that can't be read by the PostScript
138: postprocessor is replaced by white space.
139: .SH BUGS
140: A picture and associated text silently disappear if
141: a diversion trap set by
142: .B .BP
143: isn't reached.
144: Call
145: .B .EP
146: at the end of the document to retrieve it.
147: .br
148: Macros in other packages may break the adjustments
149: made to the line length and indent when text is being placed
150: around a picture.
151: .br
152: A missing or improper
153: .B %%BoundingBox
154: comment may cause the frame to be filled incorrectly.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.