Return to xpr.cat CVS log

Up to [Research Unix] / researchv9 / X11 / src / X.V11R1 / clients / xpr

Annotation of researchv9/X11/src/X.V11R1/clients/xpr/xpr.cat, 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 ] [ -compact ] [ -output
        !            15:      _f_i_l_e_n_a_m_e ] [ -append _f_i_l_e_n_a_m_e ] [ -noff ] [ -split _n ] [
        !            16:      -device _d_e_v ] [ _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, LA100, or Apple
        !            21:      LaserWriter printer.  If no file argument is given, the
        !            22:      standard input is used.  By default, _x_p_r prints the largest
        !            23:      possible representation of the window on the output page.
        !            24:      Options allow the user to add headers and trailers, specify
        !            25:      margins, adjust the scale and orientation, and append multi-
        !            26:      ple window dumps to a single output file.  Output is to
        !            27:      standard output unless -output 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:           and LaserWriter are able to translate each bit in a
        !            35:           window pixel map into a grid of a specified size.  For
        !            36:           example each bit might translate into a 3x3 grid.  This
        !            37:           would be specified by -scale _3.  By default a window is
        !            38:           printed with the largest scale that will fit onto the
        !            39:           page for the 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: X Version 10                    1                 14 October 1986
        !            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:      -compact
        !            89:           Uses simple run-length encoding for compact representa-
        !            90:           tion of windows with lots of white pixels.
        !            91: 
        !            92:      -output _f_i_l_e_n_a_m_e
        !            93:           Specifies an output file name.  If this option is not
        !            94:           specified, standard output is used.
        !            95: 
        !            96:      -append _f_i_l_e_n_a_m_e
        !            97:           Specifies a filename previously produced by _x_p_r to
        !            98:           which the window is to be appended.
        !            99: 
        !           100:      -noff
        !           101:           When specified in conjunction with -append, the window
        !           102:           will appear on the same page as the previous window.
        !           103: 
        !           104:      -split _n
        !           105:           This option allows the user to split a window onto
        !           106:           several pages. This might be necessary for very large
        !           107:           windows that would otherwise cause the printer to over-
        !           108:           load and print the page in an obscure manner.
        !           109: 
        !           110:      -device _d_e_v_i_c_e
        !           111:           Specifies the device on which the file will be printed.
        !           112:           Currently only the LN03 (-device ln03), LA100 (-device
        !           113:           la100) and Apple LaserWriter (-device lw or -device ps)
        !           114:           are supported.
        !           115: 
        !           116: SEE ALSO
        !           117:      xwd(1), xdpr(1), xwud(1), X(1)
        !           118: 
        !           119: LIMITATIONS
        !           120:      The current version of _x_p_r can generally  print out on  the
        !           121:      LN03 most X  windows that are not   larger than two-thirds
        !           122:      of the screen.  For example, it will be able to print out a
        !           123:      large Emacs  window,  but it will usually fail when trying
        !           124:      to print out the  entire screen.  The LN03 has memory  limi-
        !           125:      tations that can cause it  to  incorrectly  print very
        !           126: 
        !           127: 
        !           128: 
        !           129: X Version 10                    2                 14 October 1986
        !           130: 
        !           131: 
        !           132: 
        !           133: 
        !           134: 
        !           135: 
        !           136: XPR(1)              UNIX Programmer's Manual               XPR(1)
        !           137: 
        !           138: 
        !           139: 
        !           140:      large or complex    windows.    The two   most common
        !           141:      errors encountered  are ``band  too  complex'' and ``page
        !           142:      memory exceeded.'' In the first case, a window may have  a
        !           143:      particular six  pixel row that contains too many  changes
        !           144:      (from black to  white to black).  This will cause the
        !           145:      printer to drop part of the line  and possibly  parts of the
        !           146:      rest of the page.  The printer will flash the  number `1' on
        !           147:      its front panel when this problem occurs.  A  possible solu-
        !           148:      tion  to this problem is to increase the scale of the pic-
        !           149:      ture, or to split the picture  onto two  or  more pages.
        !           150:      The second problem,   ``page memory exceeded,'' will occur
        !           151:      if the picture contains too much  black, or if the  picture
        !           152:      contains    complex half-tones such   as   the  background
        !           153:      color of a display.  When this   problem occurs  the
        !           154:      printer will  automatically split the picture  into two or
        !           155:      more pages.   It may  flash the number `5' on  its from
        !           156:      panel.   There  is no easy  solution to this problem.  It
        !           157:      will probably be  necessary to either  cut  and paste, or
        !           158:      rework to application to produce a less complex picture.
        !           159: 
        !           160:      _X_p_r provides some support  for the  LA100.   However, there
        !           161:      are several limitations on its use: The picture will  always
        !           162:      be printed in portrait mode (this  may  be  changed  in the
        !           163:      future;)   there   is no scaling; and the aspect ratio will
        !           164:      be slightly off.
        !           165: 
        !           166:      Support for the the LaserWriter currently cannot handle the
        !           167:      -append, -noff or -split options.  The -compact option is
        !           168:      _o_n_l_y supported for the LaserWriter.  It compresses white
        !           169:      space but not black space, so it is not useful for reverse-
        !           170:      video windows.
        !           171: 
        !           172: AUTHOR
        !           173:      Copyright 1985, Massachusetts Institute of Technology.
        !           174:      LaserWriter support copyright 1986, Marvin Solomon and the
        !           175:      University of Wisconsin.
        !           176: 
        !           177:      Michael R. Gretzinger, MIT Project Athena
        !           178: 
        !           179: 
        !           180: 
        !           181: 
        !           182: 
        !           183: 
        !           184: 
        !           185: 
        !           186: 
        !           187: 
        !           188: 
        !           189: 
        !           190: 
        !           191: 
        !           192: 
        !           193: 
        !           194: 
        !           195: X Version 10                    3                 14 October 1986
        !           196: 
        !           197: 
        !           198: 

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