Return to xpr.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / X / man

Annotation of 43BSD/contrib/X/man/xpr.1, revision 1.1

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