Return to postbgi.1 CVS log

Up to [Research Unix] / researchv10no / cmd / post.src / postbgi

Annotation of researchv10no/cmd/post.src/postbgi/postbgi.1, revision 1.1

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.