Annotation of researchv10no/cmd/post.src/postdmd/postdmd.1, revision 1.1.1.1

1.1       root        1: .ds dQ /usr/lib/postscript
                      2: .TH POSTDMD 1
                      3: .SH NAME
                      4: .B postdmd
                      5: \- PostScript translator for
                      6: .SM DMD
                      7: bitmap files
                      8: .SH SYNOPSIS
                      9: \*(mBpostdmd\f1
                     10: .OP "" options []
                     11: .OP "" files []
                     12: .SH DESCRIPTION
                     13: .B postdmd
                     14: translates
                     15: .SM DMD
                     16: bitmap
                     17: .IR files ,
                     18: as produced by
                     19: .BR dmdps ,
                     20: or
                     21: .I files
                     22: written in the Ninth Edition
                     23: .BR bitfile (9.5)
                     24: format
                     25: into PostScript and writes the results on the
                     26: standard output.
                     27: If no
                     28: .I files
                     29: are specified, or if
                     30: .OP \-
                     31: is one of the input
                     32: .IR files ,
                     33: the standard input is read.
                     34: The following
                     35: .I options
                     36: are understood:
                     37: .TP 0.75i
                     38: .OP \-b num
                     39: Pack the bitmap in the output file using
                     40: .I num
                     41: byte patterns.
                     42: A value of 0 turns off all packing of the output file.
                     43: By default
                     44: .I num
                     45: is 6.
                     46: .TP
                     47: .OP \-c num
                     48: Print
                     49: .I num
                     50: copies of each page.
                     51: By default only one copy is printed.
                     52: .TP
                     53: .OP \-f
                     54: Flip the sense of the bits in
                     55: .I files
                     56: before printing the bitmaps.
                     57: .TP
                     58: .OP \-m num
                     59: Magnify each logical page by the factor
                     60: .IR num .
                     61: Pages are scaled uniformly about the origin,
                     62: which by default is located at the center of
                     63: each page.
                     64: The default magnification is 1.0.
                     65: .TP
                     66: .OP \-n num
                     67: Print
                     68: .I num
                     69: logical pages on each piece of paper,
                     70: where
                     71: .I num
                     72: can be any positive integer.
                     73: By default
                     74: .I num
                     75: is set to 1.
                     76: .TP
                     77: .OP \-o list
                     78: Print pages whose numbers are given in the comma-separated
                     79: .IR list .
                     80: The list contains single numbers
                     81: .I N
                     82: and ranges
                     83: .IR N1\-\|N2 .
                     84: A missing
                     85: .I N1
                     86: means the lowest numbered page, a missing
                     87: .I N2
                     88: means the highest.
                     89: .TP
                     90: .OP \-p mode
                     91: Print
                     92: .I files
                     93: in either \*(mBportrait\fP or \*(mBlandscape\fP
                     94: .IR mode .
                     95: Only the first character of
                     96: .I mode
                     97: is significant.
                     98: The default
                     99: .I mode
                    100: is \*(mBportrait\fP.
                    101: .TP
                    102: .OP \-u
                    103: Disables much of the unpacking for Eighth
                    104: Edition bitmap files.
                    105: Usually results in smaller output files that take longer to print.
                    106: Not a recommended option.
                    107: .TP
                    108: .OP \-x num
                    109: Translate the origin
                    110: .I num
                    111: inches along the positive x axis.
                    112: The default
                    113: coordinate system has the origin fixed at the
                    114: center of the page, with positive
                    115: x to the right and positive y up the page.
                    116: Positive
                    117: .I num
                    118: moves everything right.
                    119: The default offset is 0 inches.
                    120: .TP
                    121: .OP \-y num
                    122: Translate the origin
                    123: .I num
                    124: inches along the positive y axis.
                    125: Positive
                    126: .I num
                    127: moves everything up the page.
                    128: The default offset is 0.
                    129: .TP
                    130: .TP
                    131: .OP \-L file
                    132: Use
                    133: .I file
                    134: as the PostScript prologue.
                    135: .br
                    136: The default is
                    137: .MR \*(dQ/postdmd.ps .
                    138: .PP
                    139: Three options allow insertion of arbitrary PostScript
                    140: at controlled points in the translation process:
                    141: .TP 0.75i
                    142: .OP \-C file
                    143: Copy
                    144: .I file
                    145: to the output file;
                    146: .I file
                    147: must contain legitimate PostScript.
                    148: .TP
                    149: .OP \-P string
                    150: Include
                    151: .I string
                    152: in the output file;
                    153: .I string
                    154: must be legitimate PostScript.
                    155: .TP
                    156: .OP \-R action
                    157: Requests special
                    158: .I action
                    159: (e.g.,
                    160: .MR manualfeed )
                    161: on a per page or global basis.
                    162: The
                    163: .I action
                    164: string can be given as
                    165: .IR request,
                    166: .IM request : page\f1\|,
                    167: or
                    168: .IM request : page : file\f1\|.
                    169: If
                    170: .I page
                    171: is omitted or given as 0, the request applies to all pages.
                    172: If
                    173: .I file
                    174: is omitted, the request lookup is done in
                    175: .MR \*(dQ/ps.requests .
                    176: .PP
                    177: Only one bitmap is printed on each logical page, and each of the input
                    178: .I files
                    179: must contain complete descriptions of at least one bitmap.
                    180: Decreasing the pattern size using the
                    181: .OP \-b
                    182: option may help throughput on printers with fast processors
                    183: (e.g., \s-1PS\s+1-810),
                    184: while increasing the pattern size will often be the right move
                    185: on older models
                    186: (.e.g, \s-1PS\s+1-800).
                    187: .SH DIAGNOSTICS
                    188: A 0 exit status is returned if
                    189: .I files
                    190: were successfully processed.
                    191: .br
                    192: .ne 4v
                    193: .SH FILES
                    194: .MW \*(dQ/postdmd.ps
                    195: .br
                    196: .MW \*(dQ/forms.ps
                    197: .br
                    198: .MW \*(dQ/ps.requests
                    199: .SH SEE ALSO
                    200: .BR dpost (1),
                    201: .BR postdaisy (1),
                    202: .BR postio (1),
                    203: .BR postmd (1),
                    204: .BR postprint (1),
                    205: .BR postreverse (1),
                    206: .BR posttek (1)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.