Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 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)