Annotation of 43BSDTahoe/new/X/man/man1/xpr.0, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: 
                      4: XPR(1)             UNIX Programmer's Manual               XPR(1)
                      5: 
                      6: 
                      7: 
                      8: NAME
                      9:      xpr - print X window dump
                     10: 
                     11: SYNOPSIS
                     12:      xpr [ -scale _s_c_a_l_e ] [ -height _i_n_c_h_e_s ] [ -width _i_n_c_h_e_s ] [
                     13:      -left _i_n_c_h_e_s ] [ -top _i_n_c_h_e_s ] [ -header _s_t_r_i_n_g ] [ -trailer
                     14:      _s_t_r_i_n_g ] [ -landscape ] [ -portrait ] [ -output _f_i_l_e_n_a_m_e ] [
                     15:      -append _f_i_l_e_n_a_m_e ] [ -noff ] [ -split _n ] [ -device _d_e_v ] [
                     16:      _f_i_l_e_n_a_m_e ]
                     17: 
                     18: DESCRIPTION
                     19:      _X_p_r takes as input an X window dump file produced by _x_w_d(1)
                     20:      and formats it for output on the LN03 or LA100 printer.  If
                     21:      no file argument is given, the standard input is used.  By
                     22:      default, _x_p_r prints the largest possible representation of
                     23:      the window on the output page.  Options allow the user to
                     24:      add headers and trailers, specify margins, adjust the scale
                     25:      and orientation, and append multiple window dumps to a sin-
                     26:      gle output file.  Output is to standard output unless -out-
                     27:      put is specified.
                     28: 
                     29:      Command Options
                     30: 
                     31: 
                     32:      -scale _s_c_a_l_e
                     33:          Affects the size of the window on the page.  The LN03
                     34:          is able to translate each bit in a window pixel map
                     35:          into a grid of a specified size.  For example each bit
                     36:          might translate into a 3x3 grid.  This would be speci-
                     37:          fied by -scale _3.  By default a window is printed with
                     38:          the largest scale that will fit onto the page for the
                     39:          specified orientation.
                     40: 
                     41:      -height _i_n_c_h_e_s
                     42:          Specifies the maximum height of the window on the page.
                     43: 
                     44:      -width _i_n_c_h_e_s
                     45:          Specifies the maximum width of the window.
                     46: 
                     47:      -left _i_n_c_h_e_s
                     48:          Specifies the left margin in inches.  Fractions are
                     49:          allowed.  By default the window is centered in the
                     50:          page.
                     51: 
                     52:      -top _i_n_c_h_e_s
                     53:          Specifies the top margin for the picture in inches.
                     54:          Fractions are allowed.
                     55: 
                     56:      -header _h_e_a_d_e_r
                     57:          Specifies a header string to be printed above the win-
                     58:          dow.
                     59: 
                     60: 
                     61: 
                     62: 
                     63: Printed 9/15/87          27 August 1985                         1
                     64: 
                     65: 
                     66: 
                     67: 
                     68: 
                     69: 
                     70: XPR(1)             UNIX Programmer's Manual               XPR(1)
                     71: 
                     72: 
                     73: 
                     74:      -trailer _t_r_a_i_l_e_r
                     75:          Specifies a trailer string to be printed below the win-
                     76:          dow.
                     77: 
                     78:      -landscape
                     79:          Forces the window to printed in landscape mode.  By
                     80:          default a window is printed such that its longest side
                     81:          follows the long side of the paper.
                     82: 
                     83:      -portrait
                     84:          Forces the window to be printed in portrait mode.  By
                     85:          default a window is printed such that its longest side
                     86:          follows the long side of the paper.
                     87: 
                     88:      -output _f_i_l_e_n_a_m_e
                     89:          Specifies an output file name.  If this option is not
                     90:          specified, standard output is used.
                     91: 
                     92:      -append _f_i_l_e_n_a_m_e
                     93:          Specifies a filename previously produced by _x_p_r to
                     94:          which the window is to be appended.
                     95: 
                     96:      -noff
                     97:          When specified in conjunction with -append, the window
                     98:          will appear on the same page as the previous window.
                     99: 
                    100:      -split _n
                    101:          This option allows the user to split a window onto
                    102:          several pages. This might be necessary for very large
                    103:          windows that would otherwise cause the printer to over-
                    104:          load and print the page in an obscure manner.
                    105: 
                    106:      -device _d_e_v_i_c_e
                    107:          Specifies the device on which the file will be printed.
                    108:          Currently only the LN03 and LA100 are supported.
                    109: 
                    110: SEE ALSO
                    111:      xwd(1), xdpr(1), xwud(1), X(1)
                    112: 
                    113: LIMITATIONS
                    114:      The current version of _x_p_r can generally  print out on  the
                    115:      LN03 most X  windows that are not  larger than two-thirds
                    116:      of the screen.  For example, it will be able to print out a
                    117:      large Emacs  window,  but it will usually fail when trying
                    118:      to print out the  entire screen.  The LN03 has memory  limi-
                    119:      tations that can cause it to  incorrectly  print very
                    120:      large or complex   windows.    The two   most common
                    121:      errors encountered  are ``band  too  complex'' and ``page
                    122:      memory exceeded.'' In the first case, a window may have  a
                    123:      particular six  pixel row that contains too many  changes
                    124:      (from black to  white to black).  This will cause the
                    125:      printer to drop part of the line  and possibly  parts of the
                    126: 
                    127: 
                    128: 
                    129: Printed 9/15/87          27 August 1985                         2
                    130: 
                    131: 
                    132: 
                    133: 
                    134: 
                    135: 
                    136: XPR(1)             UNIX Programmer's Manual               XPR(1)
                    137: 
                    138: 
                    139: 
                    140:      rest of the page. The printer will flash the  number `1' on
                    141:      its front panel when this problem occurs. A  possible solu-
                    142:      tion  to this problem is to increase the scale of the pic-
                    143:      ture, or to split the picture  onto two  or  more pages.
                    144:      The second problem,   ``page memory exceeded,'' will occur
                    145:      if the picture contains too much  black, or if the  picture
                    146:      contains   complex half-tones such   as   the  background
                    147:      color of a display.  When this   problem occurs  the
                    148:      printer will  automatically split the picture  into two or
                    149:      more pages.   It may  flash the number `5' on  its from
                    150:      panel.   There  is no easy  solution to this problem.  It
                    151:      will probably be  necessary to either  cut  and paste, or
                    152:      rework to application to produce a less complex picture.
                    153: 
                    154:      _X_p_r provides some support   for the  LA100.   However, there
                    155:      are several limitations on its use: The picture will  always
                    156:      be printed in portrait mode (this may  be  changed  in the
                    157:      future;)  there   is no scaling; and the aspect ratio will
                    158:      be slightly off.
                    159: 
                    160: AUTHOR
                    161:      Copyright 1985, Massachusetts Institute of Technology
                    162: 
                    163:      Michael R. Gretzinger, MIT Project Athena
                    164: 
                    165: 
                    166: 
                    167: 
                    168: 
                    169: 
                    170: 
                    171: 
                    172: 
                    173: 
                    174: 
                    175: 
                    176: 
                    177: 
                    178: 
                    179: 
                    180: 
                    181: 
                    182: 
                    183: 
                    184: 
                    185: 
                    186: 
                    187: 
                    188: 
                    189: 
                    190: 
                    191: 
                    192: 
                    193: 
                    194: 
                    195: Printed 9/15/87          27 August 1985                         3
                    196: 
                    197: 
                    198: 

unix.superglobalmegacorp.com

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