Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XPR(1)			    General Commands Manual			XPR(1)

       xpr - print an X	window dump

       xpr  [  -device	devtype	] [ -scale scale ] [ -height inches ] [	-width
       inches ]	[ -left	inches ] [ -top	inches ] [ -header string ] [ -trailer
       string ]	[ -landscape ] [ -portrait ] [ -plane number ] [ -gray ] [ -rv
       ] [ -compact ] [	-output	filename ] [ -append filename ]	[  -noff  ]  [
       -split  n ] [ -psfig ] [	-density dpi ] [ -cutoff level ] [ -noposition
       ] [ -gamma correction ] [ -render algorithm ] [ -slide ]	[ -version ] [
       filename	]

       xpr takes as input a window dump	file produced by xwd(1)	and formats it
       for output on PostScript	printers, the Digital LN03 or LA100,  the  IBM
       PP3812 page printer, the	HP LaserJet (or	other PCL printers), or	the HP
       PaintJet.  If no	file argument is given,	the standard  input  is	 used.
       By  default, xpr	prints the largest possible representation of the win-
       dow on the output page.	Options	allow the  user	 to  add  headers  and
       trailers, specify margins, adjust the scale and orientation, and	append
       multiple	window dumps to	a single output	file.  Output is  to  standard
       output unless -output is	specified.

       Command Options

       -device devtype
	      Specifies	 the  device  on which the file	will be	printed.  Cur-
	      rently supported:
		   la100  Digital LA100
		   ljet	  HP LaserJet series and other monochrome PCL  devices
			  such as ThinkJet, QuietJet, RuggedWriter, HP2560 se-
			  ries,	and HP2930 series printers
		   ln03	  Digital LN03
		   pjet	  HP PaintJet (color mode)
		   pjetxl HP HP	PaintJet  XL  Color  Graphics  Printer	(color
		   pp	  IBM PP3812
		   ps	  PostScript printer

	      The  default is PostScript.  -device lw (LaserWriter) is equiva-
	      lent to -device ps and is	provided only for  backwards  compati-

       -scale scale
	      Affects  the  size  of  the window on the	page.  The PostScript,
	      LN03, and	HP printers are	able to	translate each bit in a	window
	      pixel map	into a grid of a specified size.  For example each bit
	      might translate into a 3x3 grid.	This  would  be	 specified  by
	      -scale 3.	 By default a window is	printed	with the largest scale
	      that will	fit onto the page for the specified orientation.

       -height inches
	      Specifies	the maximum height of the page.

       -width inches
	      Specifies	the maximum width of the page.

       -left inches
	      Specifies	the left margin	in inches.  Fractions are allowed.  By
	      default the window is centered in	the page.

       -top inches
	      Specifies	 the  top margin for the picture in inches.  Fractions
	      are allowed.

       -header string
	      Specifies	a header string	to be printed above the	window.

       -trailer	string
	      Specifies	a trailer string to be printed below the window.

	      Forces the window	to printed in landscape	mode.	By  default  a
	      window  is  printed  such	that its longest side follows the long
	      side of the paper.

       -plane number
	      Specifies	which bit plane	to use in an image.  The default is to
	      use  the	entire image and map values into black and white based
	      on color intensities.

       -gray  2	| 3 | 4
	      Uses a simple 2x2, 3x3, or 4x4 gray scale	conversion on a	 color
	      image,  rather  than  mapping to strictly	black and white.  This
	      doubles, triples,	or quadruples the effective width  and	height
	      of the image.

	      Forces  the window to be printed in portrait mode.  By default a
	      window is	printed	such that its longest side  follows  the  long
	      side of the paper.

       -rv    Forces the window	to be printed in reverse video.

	      Uses  simple  run-length	encoding for compact representation of
	      windows with lots	of white pixels.

       -output filename
	      Specifies	an output file name.  If this option is	not specified,
	      standard output is used.

       -append filename
	      Specifies	 a  filename  previously  produced by xpr to which the
	      window is	to be appended.

       -noff  When specified in	conjunction with -append, the window will  ap-
	      pear on the same page as the previous window.

       -split n
	      This  option  allows  the	 user  to  split a window onto several
	      pages.  This might be necessary  for  very  large	 windows  that
	      would otherwise cause the	printer	to overload and	print the page
	      in an obscure manner.

       -psfig Suppress translation of the PostScript picture to	the center  of
	      the page.

       -density	dpi
	      Indicates	 what  dot-per-inch  density  should be	used by	the HP

       -cutoff level
	      Changes the intensity level where	colors are  mapped  to	either
	      black or white for monochrome output on a	LaserJet printer.  The
	      level is expressed as percentage of full brightness.   Fractions
	      are allowed.

	      This  option  causes header, trailer, and	image positioning com-
	      mand generation to be bypassed for LaserJet, PaintJet and	Paint-
	      Jet XL printers.

       -gamma correction
	      This  changes the	intensity of the colors	printed	by PaintJet XL
	      printer. The correction is a floating point value	in  the	 range
	      0.00  to	3.00.	Consult	the operator's manual to determine the
	      correct value for	the specific printer.

       -render algorithm
	      This allows PaintJet XL printer to render	 the  image  with  the
	      best  quality  versus  performance tradeoff.  Consult the	opera-
	      tor's manual to determine	which algorithms are available.

       -slide This option allows overhead transparencies to be	printed	 using
	      the PaintJet and PaintJet	XL printers.

	      This option prints the program version information and exits.

       xwd(1), xwud(1),	X(7)

       The  current  version of	xpr can	generally print	out on the LN03	most X
       windows that are	not larger than	two-thirds of the screen.   For	 exam-
       ple,  it	 will  be  able	to print out a large Emacs window, but it will
       usually fail when trying	to print out the entire	screen.	 The LN03  has
       memory limitations that can cause it to incorrectly print very large or
       complex windows.	 The two most common errors encountered	are ``band too
       complex''  and  ``page  memory exceeded.''  In the first	case, a	window
       may have	a particular six pixel row  that  contains  too	 many  changes
       (from  black  to	 white to black).  This	will cause the printer to drop
       part of the line	and possibly parts of  the  rest  of  the  page.   The
       printer	will flash the number `1' on its front panel when this problem
       occurs.	A possible solution to this problem is to increase  the	 scale
       of  the	picture,  or to	split the picture onto two or more pages.  The
       second problem, ``page memory exceeded,'' will  occur  if  the  picture
       contains	 too much black, or if the picture contains complex half-tones
       such as the background color of a display.  When	 this  problem	occurs
       the  printer  will  automatically  split	 the  picture into two or more
       pages.  It may flash the	number `5' on its from	panel.	 There	is  no
       easy solution to	this problem.  It will probably	be necessary to	either
       cut and paste, or to rework the application to produce a	 less  complex

       There  are  several  limitations	on the LA100 support: the picture will
       always be printed in portrait mode, there is no scaling,	and the	aspect
       ratio will be slightly off.

       Support	for  PostScript	 output	 currently  cannot handle the -append,
       -noff or	-split options.

       The -compact option is only supported for PostScript output.   It  com-
       presses	white  space  but not black space, so it is not	useful for re-
       verse-video windows.

       For color images, should	map directly to	PostScript image support.

       If no -density is specified on the command line 300 dots	per inch  will
       be  assumed  for	ljet and 90 dots per inch for pjet.  Allowable density
       values for a LaserJet printer are 300, 150, 100,	and 75 dots per	 inch.
       Consult the operator's manual to	determine densities supported by other

       If no -scale is specified the image will	be expanded to fit the	print-
       able page area.

       The default printable page area is 8x10.5 inches. Other paper sizes can
       be accommodated using the -height and -width options.

       Note that a 1024x768 image fits the default printable  area  when  pro-
       cessed  at 100 dpi with scale=1,	the same image can also	be printed us-
       ing 300 dpi with	scale=3	but will require  considerably	more  data  be
       transferred to the printer.

       xpr may be tailored for use with	monochrome PCL printers	other than the
       LaserJet.  To print on a	ThinkJet (HP2225A) xpr could be	invoked	as:

	   xpr -density	96 -width 6.667	filename

       or for black-and-white output to	a PaintJet:

	   xpr -density	180 filename

       The monochrome intensity	of a pixel is computed as 0.30*R  +  0.59*G  +
       0.11*B.	If a pixel's computed intensity	is less	than the -cutoff level
       it will print as	white.	This  maps  light-on-dark  display  images  to
       black-on-white  hardcopy.   The default cutoff intensity	is 50% of full
       brightness.  Example: specifying	-cutoff	87.5 moves the white/black in-
       tensity point to	87.5% of full brightness.

       A  LaserJet printer must	be configured with sufficient memory to	handle
       the image.  For a full page at 300 dots per inch	approximately  2MB  of
       printer memory is required.

       Color  images  are  produced  on	the PaintJet at	90 dots	per inch.  The
       PaintJet	is limited to sixteen colors from its  330  color  palette  on
       each  horizontal	 print line.  xpr will issue a warning message if more
       than sixteen colors are encountered on a	line.  xpr  will  program  the
       PaintJet	 for the first sixteen colors encountered on each line and use
       the nearest matching programmed value for other colors present  on  the

       Specifying  the	-rv, reverse video, option for the PaintJet will cause
       black and white to be interchanged on the output	image.	No other  col-
       ors are changed.

       Multiplane  images  must	 be recorded by	xwd in ZPixmap format.	Single
       plane (monochrome) images may be	in either XYPixmap or ZPixmap format.

       Some PCL	printers do not	recognize image	positioning commands.	Output
       for  these  printers  will  not	be centered on the page	and header and
       trailer strings may not appear where expected.

       The -gamma and -render options are supported only on  the  PaintJet  XL

       The -slide option is not	supported for LaserJet printers.

       The -split option is not	supported for HP printers.

       The -gray option	is not supported for HP	or IBM printers.
       Copyright 1986, Marvin Solomon and the University of Wisconsin.
       Copyright 1988, Hewlett Packard Company.
       See X(7)	for a full statement of	rights and permissions.

       Michael	R.  Gretzinger,	 MIT  Project  Athena,	Jose Capo, MIT Project
       Athena (PP3812 support),	Marvin Solomon,	University of  Wisconsin,  Bob
       Scheifler,  MIT,	Angela Bock and	E. Mike	Durbin,	Rich Inc. (grayscale),
       Larry Rupp, HP (HP printer support).

X Version 11			   Release 6				XPR(1)


Want to link to this manual page? Use this URL:

home | help