Return to xpr.0 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1

Annotation of 43BSDTahoe/new/X/man/man1/xpr.0, revision 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: 

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