postbgi - PostScript translator for BGI (Basic Graphical Instructions) files \*(mBpostbgi\f1 .OP "" options [] .OP "" files [] postbgi translates BGI (Basic Graphical Instructions) files into PostScript and writes the results on the standard output. If no files are specified, or if .OP - is one of the input files , the standard input is read. The following options are understood:

0.75i .OP -c num Print num copies of each page. By default only one copy is printed.

.OP -f name Print text using font name . Any PostScript font can be used, although the best results will only be obtained with constant width fonts. The default font is Courier.

.OP -m num Magnify each logical page by the factor num . Pages are scaled uniformly about the origin, which by default is located at the center of each page. The default magnification is 1.0.

.OP -n num Print num logical pages on each piece of paper, where num can be any positive integer. By default num is set to 1.

.OP -o list Print pages whose numbers are given in the comma-separated list . The list contains single numbers N and ranges N1-\|N2 . A missing N1 means the lowest numbered page, a missing N2 means the highest.

.OP -p mode Print files in either \*(mBportrait or \*(mBlandscape mode . Only the first character of mode is significant. The default mode is \*(mBportrait.

.OP -w num Set the line width used for graphics to num points, where a point is approximately 1/72 of an inch. By default num is set to 0 points, which forces lines to be one pixel wide.

.OP -x num Translate the origin num inches along the positive x axis. The default coordinate system has the origin fixed at the center of the page, with positive x to the right and positive y up the page. Positive num moves everything right. The default offset is 0 inches.

.OP -y num Translate the origin num inches along the positive y axis. Positive num moves everything up the page. The default offset is 0 inches.

.OP -E name Set the character encoding for text fonts to name . Requesting name means include file .MI \*(dQ name .enc \f1. A nonexistent encoding file is silently ignored. The default selects file .MR \*(dQ/Default.enc .

.OP -L file Use file as the PostScript prologue.

The default is .MR \*(dQ/postbgi.ps .

Three options allow insertion of arbitrary PostScript at controlled points in the translation process:

0.75i .OP -C file Copy file to the output file; file must contain legitimate PostScript.

.OP -P string Include string in the output file; string must be legitimate PostScript.

.OP -R action Requests special action (e.g., .MR manualfeed ) on a per page or global basis. The action string can be given as request , M request : page\f1\|, or M request : page : file\f1\|. If page is omitted or given as 0, the request applies to all pages. If file is omitted, the request lookup is done in .MR \*(dQ/ps.requests .

postbgi can handle STARE (black and white) and PRISM (color) BGI jobs. By default plots are rigidly scaled to fill the page, which produces the good results for most STARE jobs. PRISM jobs typically fill regions with colors, and often require device specific tuning to produce acceptable results. Adding the .MW -P"/prism true def" option is strongly recommended when postbgi is translating PRISM jobs.

For most STARE jobs, .EX postbgi \f2file gives good results, while .EX postbgi -P"/prism true def" \f2file is recommended when translating PRISM jobs. A 0 exit status is returned if files were successfully processed. The default line width is too small for write-white print engines, like the one used by the PS-2400. Several BGI opcodes have not been implemented. .MW \*(dQ/postbgi.ps

.MW \*(dQ/forms.ps

.MW \*(dQ/ps.requests

dpost (1), postdaisy (1), postdmd (1), postio (1), postmd (1), postprint (1), postreverse (1), posttek (1), psencoding (1)