![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to postbgi.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / post.src / postbgi|
Return to postbgi.1 CVS log | Up to [Research Unix] / researchv10no / cmd / post.src / postbgi |
1.1 root 1: .ds dQ /usr/lib/postscript
2: .TH POSTBGI 1 "DWB 3.2"
3: .SH NAME
4: .B postbgi
5: \- PostScript translator for
6: .SM BGI
7: (Basic Graphical Instructions) files
8: .SH SYNOPSIS
9: \*(mBpostbgi\f1
10: .OP "" options []
11: .OP "" files []
12: .SH DESCRIPTION
13: .B postbgi
14: translates
15: .SM BGI
16: (Basic Graphical Instructions)
17: .I files
18: into PostScript and writes the results on the
19: standard output.
20: If no
21: .I files
22: are specified, or if
23: .OP \-
24: is one of the input
25: .IR files ,
26: the standard input is read.
27: The following
28: .I options
29: are understood:
30: .TP 0.75i
31: .OP \-c num
32: Print
33: .I num
34: copies of each page.
35: By default only one copy is printed.
36: .TP
37: .OP \-f name
38: Print text using font
39: .IR name .
40: Any PostScript font can be used,
41: although the best results will only be
42: obtained with constant width fonts.
43: The default font is Courier.
44: .TP
45: .OP \-m num
46: Magnify each logical page by the factor
47: .IR num .
48: Pages are scaled uniformly about the origin,
49: which by default is located at the center of
50: each page.
51: The default magnification is 1.0.
52: .TP
53: .OP \-n num
54: Print
55: .I num
56: logical pages on each piece of paper,
57: where
58: .I num
59: can be any positive integer.
60: By default
61: .I num
62: is set to 1.
63: .TP
64: .OP \-o list
65: Print pages whose numbers are given in the comma-separated
66: .IR list .
67: The list contains single numbers
68: .I N
69: and ranges
70: .IR N1\-\|N2 .
71: A missing
72: .I N1
73: means the lowest numbered page, a missing
74: .I N2
75: means the highest.
76: .TP
77: .OP \-p mode
78: Print
79: .I files
80: in either \*(mBportrait\fP or \*(mBlandscape\fP
81: .IR mode .
82: Only the first character of
83: .I mode
84: is significant.
85: The default
86: .I mode
87: is \*(mBportrait\fP.
88: .TP
89: .OP \-w num
90: Set the line width used for graphics to
91: .I num
92: points, where a point is approximately 1/72
93: of an inch.
94: By default
95: .I num
96: is set to 0 points, which forces lines to be
97: one pixel wide.
98: .TP
99: .OP \-x num
100: Translate the origin
101: .I num
102: inches along the positive x axis.
103: The default
104: coordinate system has the origin fixed at the
105: center of the page, with positive
106: x to the right and positive y up the page.
107: Positive
108: .I num
109: moves everything right.
110: The default offset is 0 inches.
111: .TP
112: .OP \-y num
113: Translate the origin
114: .I num
115: inches along the positive y axis.
116: Positive
117: .I num
118: moves everything up the page.
119: The default offset is 0 inches.
120: .TP
121: .OP \-E name
122: Set the character encoding for text fonts to
123: .IR name .
124: Requesting
125: .I name
126: means include file
127: .MI \*(dQ name .enc \f1.
128: A nonexistent encoding file is silently ignored.
129: The default selects file
130: .MR \*(dQ/Default.enc .
131: .TP
132: .OP \-L file
133: Use
134: .I file
135: as the PostScript prologue.
136: .br
137: The default is
138: .MR \*(dQ/postbgi.ps .
139: .PP
140: Three options allow insertion of arbitrary PostScript
141: at controlled points in the translation process:
142: .TP 0.75i
143: .OP \-C file
144: Copy
145: .I file
146: to the output file;
147: .I file
148: must contain legitimate PostScript.
149: .TP
150: .OP \-P string
151: Include
152: .I string
153: in the output file;
154: .I string
155: must be legitimate PostScript.
156: .TP
157: .OP \-R action
158: Requests special
159: .I action
160: (e.g.,
161: .MR manualfeed )
162: on a per page or global basis.
163: The
164: .I action
165: string can be given as
166: .IR request ,
167: .IM request : page\f1\|,
168: or
169: .IM request : page : file\f1\|.
170: If
171: .I page
172: is omitted or given as 0, the request
173: applies to all pages.
174: If
175: .I file
176: is omitted, the request
177: lookup is done in
178: .MR \*(dQ/ps.requests .
179: .PP
180: .B postbgi
181: can handle
182: .SM STARE
183: (black and white) and
184: .SM PRISM
185: (color)
186: .SM BGI
187: jobs.
188: By default plots are rigidly scaled to fill the page, which produces
189: the good results for most
190: .SM STARE
191: jobs.
192: .SM PRISM
193: jobs typically fill regions with colors, and often require device
194: specific tuning to produce acceptable results.
195: Adding the
196: .MW \-P"/prism\ true\ def"
197: option is strongly recommended when
198: .B postbgi
199: is translating
200: .SM PRISM
201: jobs.
202: .br
203: .ne 7v
204: .SH EXAMPLES
205: For most
206: .SM STARE
207: jobs,
208: .EX
209: postbgi \f2file
210: .EE
211: gives good results, while
212: .EX
213: postbgi \-P"/prism true def" \f2file
214: .EE
215: is recommended when translating
216: .SM PRISM
217: jobs.
218: .SH DIAGNOSTICS
219: A 0 exit status is returned if
220: .I files
221: were successfully processed.
222: .SH BUGS
223: The default line width is too small for write-white
224: print engines, like the one used by the PS-2400.
225: Several
226: .SM BGI
227: opcodes have not been implemented.
228: .SH FILES
229: .MW \*(dQ/postbgi.ps
230: .br
231: .MW \*(dQ/forms.ps
232: .br
233: .MW \*(dQ/ps.requests
234: .SH SEE ALSO
235: .BR dpost (1),
236: .BR postdaisy (1),
237: .BR postdmd (1),
238: .BR postio (1),
239: .BR postmd (1),
240: .BR postprint (1),
241: .BR postreverse (1),
242: .BR posttek (1),
243: .BR psencoding (1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.