.ds dQ /usr/lib/postscript.TH POSTBGI 1 "DWB 3.2".SH NAME.B postbgi\- PostScript translator for.SM BGI(Basic Graphical Instructions) files.SH SYNOPSIS\*(mBpostbgi\f1.OP "" options [].OP "" files [].SH DESCRIPTION.B postbgitranslates.SM BGI(Basic Graphical Instructions).I filesinto PostScript and writes the results on thestandard output.If no.I filesare specified, or if.OP \-is one of the input.IR files ,the standard input is read.The following.I optionsare understood:.TP 0.75i.OP \-c numPrint.I numcopies of each page.By default only one copy is printed..TP.OP \-f namePrint text using font.IR name .Any PostScript font can be used,although the best results will only beobtained with constant width fonts.The default font is Courier..TP.OP \-m numMagnify each logical page by the factor.IR num .Pages are scaled uniformly about the origin,which by default is located at the center ofeach page.The default magnification is 1.0..TP.OP \-n numPrint.I numlogical pages on each piece of paper,where.I numcan be any positive integer.By default.I numis set to 1..TP.OP \-o listPrint pages whose numbers are given in the comma-separated.IR list .The list contains single numbers.I Nand ranges.IR N1\-\|N2 .A missing.I N1means the lowest numbered page, a missing.I N2means the highest..TP.OP \-p modePrint.I filesin either \*(mBportrait\fP or \*(mBlandscape\fP.IR mode .Only the first character of.I modeis significant.The default.I modeis \*(mBportrait\fP..TP.OP \-w numSet the line width used for graphics to.I numpoints, where a point is approximately 1/72of an inch.By default.I numis set to 0 points, which forces lines to beone pixel wide..TP.OP \-x numTranslate the origin.I numinches along the positive x axis.The defaultcoordinate system has the origin fixed at thecenter of the page, with positivex to the right and positive y up the page.Positive.I nummoves everything right.The default offset is 0 inches..TP.OP \-y numTranslate the origin.I numinches along the positive y axis.Positive.I nummoves everything up the page.The default offset is 0 inches..TP.OP \-E nameSet the character encoding for text fonts to.IR name .Requesting.I namemeans include file.MI \*(dQ name .enc \f1.A nonexistent encoding file is silently ignored.The default selects file.MR \*(dQ/Default.enc ..TP.OP \-L fileUse.I fileas the PostScript prologue..brThe default is.MR \*(dQ/postbgi.ps ..PPThree options allow insertion of arbitrary PostScriptat controlled points in the translation process:.TP 0.75i.OP \-C fileCopy.I fileto the output file;.I filemust contain legitimate PostScript..TP.OP \-P stringInclude.I stringin the output file;.I stringmust be legitimate PostScript..TP.OP \-R actionRequests special.I action(e.g.,.MR manualfeed )on a per page or global basis.The.I actionstring can be given as.IR request ,.IM request : page\f1\|,or.IM request : page : file\f1\|.If.I pageis omitted or given as 0, the requestapplies to all pages.If.I fileis omitted, the requestlookup is done in.MR \*(dQ/ps.requests ..PP.B postbgican handle.SM STARE(black and white) and.SM PRISM(color).SM BGIjobs.By default plots are rigidly scaled to fill the page, which producesthe good results for most.SM STAREjobs..SM PRISMjobs typically fill regions with colors, and often require devicespecific tuning to produce acceptable results.Adding the.MW \-P"/prism\ true\ def"option is strongly recommended when.B postbgiis translating.SM PRISMjobs..br.ne 7v.SH EXAMPLESFor most.SM STAREjobs,.EXpostbgi  \f2file.EEgives good results, while.EXpostbgi \-P"/prism true def"  \f2file.EEis recommended when translating.SM PRISMjobs..SH DIAGNOSTICSA 0 exit status is returned if.I fileswere successfully processed..SH BUGSThe default line width is too small for write-whiteprint engines, like the one used by the PS-2400.Several.SM BGIopcodes have not been implemented..SH FILES.MW \*(dQ/postbgi.ps.br.MW \*(dQ/forms.ps.br.MW \*(dQ/ps.requests.SH SEE ALSO.BR dpost (1),.BR postdaisy (1),.BR postdmd (1),.BR postio (1),.BR postmd (1),.BR postprint (1),.BR postreverse (1),.BR posttek (1),.BR psencoding (1)