Return to xpr.man CVS log

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

Annotation of researchv9/X11/src/X.V11R1/clients/xpr/xpr.man, revision 1.1

1.1     ! root        1: .\\"$Header: xpr.man,v 1.1 87/06/23 14:49:31 dkk Exp $
        !             2: .\\"$Locker:  $
        !             3: .TH XPR 1 "14 October 1986" "X Version 10"
        !             4: .SH NAME
        !             5: xpr \- print X window dump
        !             6: .SH SYNOPSIS
        !             7: .B xpr
        !             8: [
        !             9: .B \-scale
        !            10: .I scale
        !            11: ] [
        !            12: .B \-height
        !            13: .I inches
        !            14: ] [
        !            15: .B \-width
        !            16: .I inches
        !            17: ] [
        !            18: .B \-left
        !            19: .I inches
        !            20: ] [
        !            21: .B \-top
        !            22: .I inches
        !            23: ] [
        !            24: .B \-header
        !            25: .I string
        !            26: ] [
        !            27: .B \-trailer
        !            28: .I string
        !            29: ] [
        !            30: .B \-landscape
        !            31: ] [
        !            32: .B \-portrait
        !            33: ] [
        !            34: .B \-compact
        !            35: ] [
        !            36: .B \-output
        !            37: .I filename
        !            38: ] [
        !            39: .B \-append
        !            40: .I filename
        !            41: ] [
        !            42: .B \-noff
        !            43: ] [
        !            44: .B \-split
        !            45: .I n
        !            46: ] [
        !            47: .B \-device
        !            48: .I dev
        !            49: ] [
        !            50: .I filename
        !            51: ]
        !            52: .SH DESCRIPTION
        !            53: 
        !            54: .I Xpr
        !            55: takes as input an X window dump file produced by
        !            56: .IR xwd (1)
        !            57: and formats it for output on the LN03, LA100, or Apple LaserWriter
        !            58: printer.  If no file
        !            59: argument is given, the standard input is used.  By default, \fIxpr\fP
        !            60: prints the largest possible representation of the window on the
        !            61: output page.  Options allow the user to add headers and trailers,
        !            62: specify margins, adjust the scale and orientation, and append
        !            63: multiple window dumps to a single output file.  Output is to
        !            64: standard output unless 
        !            65: .B \-output
        !            66: is specified.
        !            67: .sp 1
        !            68: .ne 8
        !            69: .B Command Options
        !            70: .sp 1
        !            71: .IP "\fB\-scale\fP \fIscale\fP"
        !            72: Affects the size of the window on the page.  The LN03 and LaserWriter are
        !            73: able to
        !            74: translate each bit in a window pixel map into a grid of a specified size.
        !            75: For example each bit might translate into a 3x3 grid.  This would be
        !            76: specified by \fB\-scale\fP \fI3\fP.  By default a window is printed 
        !            77: with the largest scale that will fit onto the page for the specified
        !            78: orientation.
        !            79: .IP "\fB\-height\fP \fIinches\fP"
        !            80: Specifies the maximum height of the window on the page.
        !            81: .IP "\fB\-width\fP \fIinches\fP"
        !            82: Specifies the maximum width of the window.
        !            83: .IP "\fB\-left\fP \fIinches\fP"
        !            84: Specifies the left margin in inches.  Fractions
        !            85: are allowed.  By default the window is centered in the page.
        !            86: .IP "\fB\-top\fP \fIinches\fP"
        !            87: Specifies the top margin for the picture in inches.  Fractions are
        !            88: allowed.
        !            89: .IP "\fB\-header\fP \fIheader\fP"
        !            90: Specifies a header string to be printed above the window.
        !            91: .IP "\fB\-trailer\fP \fItrailer\fP"
        !            92: Specifies a trailer string to be printed below the window.
        !            93: .IP "\fB\-landscape\fP"
        !            94: Forces the window to printed in landscape mode.  By default
        !            95: a window is printed such that its longest side follows the long side of
        !            96: the paper.
        !            97: .IP "\fB\-portrait\fP"
        !            98: Forces the window to be printed in portrait mode.  By default
        !            99: a window is printed such that its longest side follows the long side of
        !           100: the paper.
        !           101: .IP "\fB\-compact\fP"
        !           102: Uses simple run-length encoding for compact representation of windows
        !           103: with lots of white pixels.
        !           104: .IP "\fB\-output\fP \fIfilename\fP"
        !           105: Specifies an output file name.  If this option is not specified, standard
        !           106: output is used.
        !           107: .IP "\fB\-append\fP \fIfilename\fP"
        !           108: Specifies a filename previously produced by \fIxpr\fP to which the window
        !           109: is to be appended.
        !           110: .IP "\fB\-noff\fP"
        !           111: When specified in conjunction with \fB\-append\fP, the window will appear
        !           112: on the same page as the previous window.
        !           113: .IP "\fB\-split\fP \fIn\fP"
        !           114: This option allows the user to split a window onto several pages.  
        !           115: This might be necessary for very large windows that would otherwise
        !           116: cause the printer to overload and print the page in an obscure manner.
        !           117: .IP "\fB\-device\fP \fIdevice\fP"
        !           118: Specifies the device on which the file will be printed.  Currently only
        !           119: the LN03 (-device ln03), LA100 (-device la100) and Apple LaserWriter
        !           120: (-device lw or -device ps) are supported.
        !           121: .SH SEE ALSO
        !           122: xwd(1), xdpr(1), xwud(1), X(1)
        !           123: .SH LIMITATIONS
        !           124: 
        !           125: The current version of \fIxpr\fP can generally  print out on  the LN03
        !           126: most X  windows that are not   larger than two-thirds   of the screen.
        !           127: For example, it will be able to print out a  large Emacs  window,  but
        !           128: it will usually fail when trying to print out the  entire screen.  The
        !           129: LN03 has memory  limitations that can cause it  to  incorrectly  print
        !           130: very   large or complex    windows.    The two   most common    errors
        !           131: encountered  are ``band  too  complex'' and ``page  memory exceeded.''
        !           132: In the first case, a window may have  a particular six  pixel row that
        !           133: contains too many  changes (from black to  white to black).  This will
        !           134: cause the printer to drop part of the line  and possibly  parts of the
        !           135: rest of the page.  The printer will flash the  number `1' on its front
        !           136: panel when this problem occurs.  A  possible solution  to this problem
        !           137: is to increase the scale of the picture, or to split the picture  onto
        !           138: two  or  more pages.   The second problem,   ``page memory exceeded,''
        !           139: will occur if the picture contains too much  black, or if the  picture
        !           140: contains    complex half-tones such   as   the  background  color of a
        !           141: display.  When this   problem occurs  the  printer will  automatically
        !           142: split the picture  into two or  more pages.   It may  flash the number
        !           143: `5' on  its from panel.   There  is no easy  solution to this problem.
        !           144: It will probably be  necessary to either  cut  and paste, or rework to
        !           145: application to produce a less complex picture.
        !           146: 
        !           147: \fIXpr\fP provides some support  for the  LA100.   However, there  are
        !           148: several limitations on its use: The picture will  always be printed in
        !           149: portrait mode (this  may  be  changed  in the future;)   there   is no
        !           150: scaling; and the aspect ratio will be slightly off.
        !           151: 
        !           152: Support for the the LaserWriter currently cannot handle the \fB-append\fP,
        !           153: \fB-noff\fP or \fB-split\fP options.
        !           154: The \fB-compact\fP option is
        !           155: .I only
        !           156: supported for the LaserWriter.
        !           157: It compresses white space but not black space, so it is not useful for
        !           158: reverse-video windows.
        !           159: .SH AUTHOR
        !           160: .PP
        !           161: Copyright 1985, Massachusetts Institute of Technology.
        !           162: LaserWriter support copyright 1986, Marvin Solomon and the University of
        !           163: Wisconsin.
        !           164: .PP
        !           165: Michael R. Gretzinger, MIT Project Athena

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