NOAA

Geophysical Fluid
Dynamics Laboratory

Skip to: [content] [navigation]
If you are using Navigator 4.x or Internet Explorer 4.x or Omni Web 4.x , this site will not render correctly!

Vis > image_printing > GFDL Visualization Guide: Xpsview

GFDL Visualization Guide: Xpsview

     NAME
	  xpsview - Adobe Systems PostScript language document
	  previewer.

     SYNOPSIS
	  xpsview [-ept] [-igc]	[-maxp size] [-mono] [-or orientation]
	  [-ps pagesize] [-repsf] [-scale scale] [-sf] [-skipc]	[-tdir
	  dir] [-v] [-wp] [files]

     DESCRIPTION
	  The Adobe Xpsview program displays PostScript	language
	  documents in an X window, using the Display PostScript
	  extension in the X server.

	  The program allows you to preview and	page through both
	  structured and unstructured PostScript language documents.
	  You can choose the size, scale, and orientation of the
	  display.

     OPTIONS
	  You can provide command line options in upper	or lower case.
	  The options may appear in any	order, but filenames must come
	  after	all other options.  Instead of using an	option,	you
	  can often set	an X resource or select	a menu command to
	  achieve the same behavior change.  In	that case:

	       * Use the X resource to permanently set your preferred default
		 (see RESOURCES).
	       * Use the option	to override the	resource setting for one
		 session.
	       * Use the menu command to temporarily override the
	       resource	or option setting (see USER INTERFACE).

	  The Adobe Xpsview program supports all standard X toolkit
	  options described in the X(1)	manual page. In	addition, the
	  program supports the following options:

	  -ept (emulate	paper trays) Changes the page size when	the
	       PostScript language document contains a request for a
	       different paper size. You need this option only if the
	       associated X resource, emulatePaperTrays, has been set
	       to False	and you	want to	change the behavior.
	       Resource: emulatePaperTrays

	  -igc (ignore comments) Ignores all document structuring
	       convention (DSC)	comments in a PostScript language
	       file, that is, treats the document as an	unstructured
	       document. This can be helpful for viewing an
	       incorrectly structured document.	See also filterps(1).
	       Resource: ignoreComments

	  -maxp	size
	       When the	program	displays a page, it first writes the
	       whole page to an	offscreen buffer called	a pixmap, then
	       copies the buffer content to the	window.	 The -maxp
	       option sets the maximum number of bytes of memory that
	       the program is allowed to allocate for that buffer. The
	       default value depends on	the machine on which the
	       window is displayed; the	program	allocates enough
	       memory to display a standard 8-1/2-inch by 11-inch
	       page.

	       The size	parameter may be followed by `k` for kilobytes
	       or `m` for megabytes; for example, -maxp	3m. If size is
	       zero, the program does not create a pixmap and draws
	       directly	to the window. Final window size is based on
	       the page	size specification and the scale factor. If
	       either the final	window width or	the final window
	       height exceeds 8	000 pixels, the	program	reduces	the
	       scale factor.

	       A large page size requires allocation of	a substantial
	       amount of memory	for the	pixmap.	If the memory required
	       for the pixmap exceeds the default or the limit set by
	       this option, the	program	displays a message and draws
	       directly	to the window afterward. See EXCEEDING PIXMAP
	       MEMORY below.

	       If you increase the value of the	size parameter beyond
	       the default, the	previewer may slow down	when you
	       increase	the scale factor.  This	is caused by increased
	       paging in the system when the X server allocates	a
	       large pixmap.
	       Resource: maxPixmapBytes

	  -mono
	       Displays	documents as they would	appear on a monochrome
	       printer.	This may improve performance of	the previewer,
	       since monochrome	documents require a much smaller
	       pixmap. You can choose between optimum performance and
	       optimum display quality:

	       * Consider using	-mono to enhance performance if	you
	       are previewing monochrome documents on a	color display.

	       * Don`t use -mono if memory or speed are	not an issue;
	       this gets you the highest quality display on all
	       monitors.

	       Resource: monochrome

	  -or orientation
	       Sets the	page orientation to the	specified value. Valid
	       choices are:

		  * portrait - The "normal" upright orientation
		  * landscape -	The page rotated 90 degrees clockwise
		  * flip_portrait - The	page rotated 180 degrees clockwise
		  * flip_landscape - The page rotated 270 degrees clockwise

	       Resource: pageOrientation

	  -ps pagesize
	       Specifies the size of the drawing area. pagesize	can be
	       the name	of a standard page size, such as ledger, B,
	       C0, or two numbers, separated by	a colon, that define
	       the width and height of a custom	page. Letter size (8-
	       1/2-inch	by 11-inch) is the default page	size. Possible
	       arguments are:

		    * letter (8.5 x 11), legal (8.5 x 14), ledger (11
		    x 17), or executive	(7.25 x	10.50)
		    * A, B, C, D, E, F,	or E1	       (American ANSI)
		    * A0, A1, ... A10	     (metric ISO)
		    * B0, B1, ... B10		  (metric ISO)
		    * C0, C1, ... C7		  (metric ISO)
		    * width:height		  (custom size)

	       See PAGE	SIZES for the dimensions of the	standard
	       pages.

	       Width and height	are by default specified in inches and
	       may be integers or floating point numbers. To specify
	       units other than	inches,	follow the number with:

		    * cm to specify centimeters
		    * mm to specify millimeters
		    * px to specify pixels

	       If you choose a page size too small for the current
	       page, the effect	is the same as if you used a paper
	       size too	small for a document you print.	The program
	       displays	as much	of the document	as fits	on the page
	       but does	not provide scroll bars. To view the whole
	       page, choose a large enough page	size, then scroll or
	       scale the document as needed if it is larger than the
	       window.
	       Resource: pageSize

	  -repsf
	       (reposition EPS files) Encapsulated PostScript (EPS)
	       files can contain images	at an arbitrary	location on
	       the page. By default, the previewer aligns the upper
	       left corner of the image	with the upper left corner of
	       the page. If the	associated resource (repositionEPSF)
	       has been	changed	to False, you can use the -repsf
	       option to return	to the default behavior.
	       Resource: repositionEPSF

	  -scale scale
	       Sets a scale factor which applies to the	page size and
	       to the drawing on the page. The scale factor may	be an
	       integer or a floating point number. The default value
	       for the scale factor is 1 (one).	The legal range	is 0.1
	       through 10.0.
	       Resource: scale

	  -sf  (substitute fonts) Substitutes Courier font if a
	       document	requires a font	that is	not available.
	       You need	this option only if you	have changed the value
	       of the substituteFonts resource to False. In that case,
	       the previewer displays an error message if you try to
	       load a file that	requires unavailable fonts and the X
	       server does not provide font substitution. A message
	       explains	why the	previewer cannot load the file.
	       Resource: substituteFonts

	  -skipc
	       (skip copyright)	Skips the copyright notice that	is
	       usually displayed when you start	the program.
	       Resource: skipCopyright

	  -tdir	dir
	       When the	program	reads from stdin, it temporarily
	       stores the input	from stdin in the directory specified
	       by the tempDir resource (tmp by default)	and later
	       removes it. Use this option to specify a	different
	       directory for storing the input.
	       Resource: tempDir

	  -v   (verbose) Prints	a short	message	to stderr each time an
	       error dialog box	is displayed. This allows you to save
	       error messages to a file	for later inspection and
	       debugging.
	       Resource: verbose

	  -wp  (watch progress)	By default, the	program	writes a page
	       to a pixmap and displays	it only	when it	is complete.
	       When you	use the	-wp option, the	program	displays parts
	       of the page as it is being drawn. While the option lets
	       you observe the progress	of a display that requires
	       lengthy preparation, the	order in which chunks are
	       displayed is not	meaningful.
	       Resource: watchProgress

	  files
	       Loads one or more files into the	previewer at startup
	       time.

	  -    If you supply - (minus) instead of a filename, the
	       program reads from stdin. In that case, the program
	       temporarily stores the input from stdin in the
	       directory specified by the tempDir resource and later
	       removes it.

	       The - option makes it possible to view plain text
	       files.  Run the file through a program that generates
	       PostScript language output and pipe the output to the
	       previewer's stdin.

     DOCUMENT REQUIREMENTS
	  If a document	uses the PostScript language incorrectly, the
	  program may not be able to display it.

	  A file type must be indicated	on the first line of the
	  document.  Otherwise,	the program cannot read	the file. Even
	  a hand-coded PostScript language file	must contain a file
	  type indicator on the	first line. To indicate	an
	  unstructured document, use a percent sign directly followed
	  by an	exclamation point (%!).	 This exact string, and
	  nothing else,	must be	the first line of the file.

	STRUCTURED AND UNSTRUCTURED DOCUMENTS
	  The Xpsview program does not require a structured PostScript
	  language document, as	defined	in Appendix G of the
	  PostScript Language Reference	Manual,	Second Edition.

	  When you view	an unstructured	document you cannot go
	  directly to a	page, but you can page forward through the
	  document and return to the first page.  The program displays
	  a trailing blank page	at the end of each unstructured
	  document.

	  If a document	uses DSC comments incorrectly, the program may
	  not be able to display it or may display it as an
	  unstructured document. You can use the filterps utility to
	  convert some documents to correctly structured documents.

	SPECIAL	DOCUMENTS
	  The program detects structured documents whose pages have
	  been placed in reverse order and displays the	pages in
	  normal order.

	  When you view	a standalone Encapsulated PostScript (EPS)
	  file the program displays the	file with its top left corner
	  in the top left corner of the	window.	This reduces
	  unnecessary scrolling. You can use the repositionEPSF
	  resource, the	repsf option, or the Reposition	EPS Files
	  command in the Options menu to change	this behavior.

     EXCEEDING PIXMAP MEMORY

	  When the Adobe Xpsview program displays a page, it first
	  draws	the whole page to a pixmap. By default,	the program
	  may only allocate enough memory for the pixmap to draw a
	  standard 8.5-inch by 11-inch page. The exact number depends
	  on  the machine on which you have the	display. You can
	  change the upper limit with the -maxp	option.

	  A large page size, whether requested by the -ps option or by
	  a command in the PostScript language document, requires
	  allocation of	a substantial amount of	memory.	 For example,
	  on a machine that displays 100 dots per linear inch, each
	  square inch has 10 000 dots. If the machine is an 8-bit
	  color	machine, 10 kilobytes are needed for each square inch
	  of the page.

	  If the combination of	the requested page size	and scale
	  factor require pixmap	memory that exceeds the	upper limit,
	  the program does not allocate	a pixmap but draws directly to
	  the window instead. In that case, the	program	displays a
	  warning message. Whether this	message	is displayed again
	  depends on the action	you take:

	     * If you reduce the scale factor but the required pixmap
	     storage still exceeds the number specified	by the -maxp
	     option, the message is displayed again.  This helps you
	     determine how far the scale factor	has to be reduced.

	     * If you increase the scale factor, the message is	not
	     redisplayed, since	you already know there is not enough
	     space. This prevents the message from popping up
	     repeatedly	as you move the	scale slider.

	     * If you don't reduce the scale factor and	open another
	     file, that	file won't have	a pixmap either. Since you
	     have been informed	already, no message is displayed.

	  After	you have acknowledged the message, structured
	  documents are	drawn directly to the window. If you are
	  viewing an unstructured document, the	previewer can display
	  only the part	of the page that was in	the viewing area and
	  not covered by other panels. You have	two options:

	     (1) Decrease the scale factor until the previewer can
	     allocate a	pixmap again, using the	error messages as a
	     guide.

	     (2) Scroll	the page to view the area you want to examine,
	     then choose Reopen	from the File menu and page forward to
	     the information you want to see.

     USER INTERFACE
	  The program opens a standard window. Below the window	title,
	  which	shows the name and version of the program, is a	menu
	  bar. It contains the File, Page, Controls, View, and Options
	  menus.

	  Below	the menu bar, the Page:	 text area displays the	number
	  of the page, and the File:  text area	displays the pathname
	  of the file you are currently	viewing. Scroll	bars and a
	  sizing mechanism are provided	if the window manager supports
	  it.

	  If a menu command has	an associated accelerator, the key
	  sequence is displayed	right-aligned on the same line in the
	  menu.	For example,  Alt/q is displayed right-aligned next to
	  the Exit command in the File menu.  You can use accelerators
	  while	the cursor is over any window or panel that is part of
	  the program. The menu	does not have to be visible. For
	  example, you can hold	down the Alt key and then press	q to
	  invoke the Exit command.

	  System administrators	can change the default size and
	  location of windows and panels and the default accelerator
	  bindings for an entire installation by editing the Xpsview
	  application defaults file. Individual	users can customize
	  key bindings by adding resources in their own	.Xdefaults
	  file.

	THE File MENU
	  Previous - Displays the last file you	selected. Click	on
		Previous repeatedly to step back through the trail of
		selected files.	 If an earlier attempt to preview one
		of the files was unsuccessful, Previous	causes the
		error to recur unless the file has been	corrected.
		Default	Accelerator: Alt/B

	  Next - If you	provided a list	of files at the	command	line
		when you started, Next steps forward through that list
		of files. If you used the Previous command several
		times in a row,	Next steps forward through the trail
		of selected files. If one of the files in the trail
		cannot be displayed, the error recurs unless the file
		has been corrected.
		Default	Accelerator: Alt/F

	  Open... - Calls a standard Motif file	selection panel	that
		allows you to browse directories and choose a file.

		If you know the	name of	the file, type it into the
		text field below the word Selection and	click on OK.

		To search a directory or a group of directories	for a
		file, type the pathname	of the branch you want to
		search in the text field beneath the word Filter, then
		press Return or	click on the Filter button.
		Directories that lie in	the tree structure at that
		level of that path appear in the area headed
		Directories; files appear in the area headed Files.
		If no files pass the filter, square brackets [ ]
		appear.	If the directory was not found,	or if you
		don't have permission to view it, the bell sounds.

		To view	the files in a directory, use Motif wildcard
		filters	in the Filter text field. You can use an
		asterisk (*) to	indicate any number of characters, or
		a question mark	(?) to indicate	exactly	one character.
		For example, assume there is a directory mydir with a
		subdirectory mydocs. To	view all files in the mydocs
		directory, type	mydir/mydocs/* into the	Filter area.
		To view	all files with the suffix .ps, type
		mydir/mydocs/*.ps.

		To load	one of the files listed	in the Files area,
		double-click on	the filename, or select	it with	a
		single click, then click on OK or press	Return.

		Default	Accelerator: Alt/O

	  Reopen - Reopens the current file at the current page	if the
		file contains a	structured document, or	at the first
		page if	it contains an unstructured document.
		Default	Accelerator: Alt/R

	  Exit - Exits the application.
		Default	Accelerator: Alt/Q

	THE Page MENU
	  Previous Page	- Displays the current document's previous
		page.  If you are at the first page of a document,
		Previous Page is not available.	If you are viewing an
		unstructured document,	Previous Page changes to First
		Page.
		Default	Accelerator: Alt/b

	  Next Page - Displays the next	page in	the document. If you
		are at the last	page of	the document, Next Page	is not
		available.
		Default	Accelerator: Alt/f

	  Last Page Viewed - Displays the last page viewed.  This
		command	is useful to alternate between two pages that
		are not	adjacent. Last Page Viewed is only available
		if you are viewing a structured	PostScript language
		document.
		Default	Accelerator: Alt/l

	  Redraw Page -	Redisplays the current page. Redraw Page is
		only available if you are viewing a structured
		PostScript language document.
		Default	Accelerator: Alt/r

	  Page Selection... - Displays the Page	Selection panel. In
		this panel, you	can drag a slider to choose a page or
		type in	the number of the page you want	to view	and
		select it by pressing Return.

		Page Selection is only available if you	are viewing a
		structured PostScript language document. While the
		panel is on screen, the	command	changes	to Close Page
		Selection Panel.
		Default	Accelerator: Alt/p

	THE Controls MENU
	  Interrupt - Interrupts the process of	displaying the current
		page. You can select the Continue command to complete
		the process, or	open a different file. If you are
		viewing	an unstructured	document, you can reopen it to
		view its first page.
		Default	Accelerator: Alt/I

	  Continue -  Resumes the process of displaying	the current
		page.
		Default	Accelerator: Alt/C

	THE View MENU
	  The View menu	lets you determine how a document is
	  displayed. Each of the commands in this menu is followed by
	  an ellipsis (...) and	brings up a panel. While the panel is
	  on screen, the menu command changes to let you close it.
	  There	is also	a Close	or Cancel button on each panel.

	  Position and width of	each panel are determined in the
	  Xpsview2 resource file, which	you can	override in your
	  .Xdefaults file. See FILES and RESOURCES below.

	  Shortcut Panel... - Invokes a	panel containing the most
		commonly used menu commands.  While the	panel is on
		screen,	the command changes to Close Shortcut Panel.
		Default	Accelerator: Alt/c.

	  Scale	Selection... - Invokes the scale selection panel. To
		change the scale at which the program displays a page,
		use the	slider or type the desired scale factor	into
		the text field and select it.

		If you reduce the scale	to one half (.5), the program
		displays a half-size page in the upper left corner of
		the viewing area.  If you increase the scale to	two
		(2.0), the program doubles the size of the text	or
		image in your viewing area. You	can usually see	only
		part of	the page, but scroll bars allow	you to view
		the rest of the	scaled-up page.

		The initial range of the slider	in the Scale Selection
		panel changes if you change the	scale resource or the
		-scale option. The initial range always	extends	from
		half of	the scale that is in effect to twice the scale
		that is	in effect. For the default scale of 1.0,
		initial	range of the slider is .5 to 2.0. If you
		change the scale, the range changes; for example a
		scale factor of	.5 results in an initial  slider range
		between	.25 and	1.0.

		To request a scale factor not included in the slider
		range, type the	value in the Scale Selection panel's
		text window. The slider	range will grow	to fit the
		selection. The possible	range is 0.1 to	10.

		If you combine a relatively large page size with a
		relatively large scale,	the required pixmap will need
		more memory than the maximum amount the	previewer is
		allowed	to allocate. To	avoid this, reduce the scale
		factor or, if appropriate, reduce the page size.  You
		can also use the -maxp option or the maxPixmapBytes
		resource to allow allocation of	more memory to the
		pixmap.

		While the panel	is on screen, the command changes to
		Close Scale Selection Panel.
		Default	Accelerator: Alt/s.

	  Page Orientation... -	Invokes	a panel	for changing the
		orientation of the display.  You can choose from four
		options	represented by icons.  Selecting an option
		rotates	the display.  While the	panel is on screen,
		the command changes to Close Page Orientation Panel.
		Default	Accelerator: Alt/o.

	THE Options MENU
	  The Options menu allows you to set or	change options that
	  determine how	the program treats a file as it	is loaded. All
	  commands in the menu are toggles for selecting or
	  deselecting an option. If you	change the Monochrome or Watch
	  Progress option, the new setting affects the current
	  document immediately.	If you change one of the other
	  options, you have to reopen the document using Reopen	in the
	  File menu. An	option setting remains in effect for all
	  loaded documents until you change the	setting.

	  Resource settings and	command	line options determine the
	  initial setting.

	  Watch	Progress - When	off (the default), the program first
		writes a page to a pixmap and displays it only when it
		is complete. When on, the program incrementally
		displays parts of the page until the process is
		complete. While	this option lets you observe the
		progress of a display that requires lengthy
		preparation, the order in which	chunks are displayed
		is not meaningful.

	  Emulate Paper	Trays -	When on	(the default), the program
		responds to requests for paper tray handling in	the
		PostScript language document.  If, for example,	the
		document contains a request for	a larger paper size,
		the previewer uses a larger page size for the display.

	  Reposition EPS Files - When on (the default),	the program
		displays EPS files with	the top	left corner of the
		picture	in the top left	corner of the page. Since many
		EPS files have the top left corner of the picture in a
		different location, this eliminates superfluous
		scrolling.

	  Substitute Fonts - When on (the default), the	program
		substitutes Courier for	fonts that are not found in
		the environment. When off, the program signals an
		error when attempting to load a	file that requires an
		unavailable font.

	  Ignore Comments - When off (the default), the	program	uses
		the DSC	comments found in the document.	When on, the
		program	ignores	all comments and may therefore allow
		you to view a document with faulty comments.

	  Monochrome - When on,	the program displays documents in
		monochrome only, even when running on a	color display.
		This is	useful for seeing how a	document will look on
		a monochrome printer. Default is off.

     KEYBOARD ACCELERATORS
	File Menu
	  Previous	      Alt/B
	  Next		      Alt/F
	  Open...	      Alt/O
	  Reopen	      Alt/R
	  Exit		      Alt/Q

	Page Menu
	  Previous Page	      Alt/b, b,	p
	  Next Page	      Alt/f, f,	n
	  Last Page Viewed    Alt/l
	  Redraw Page	      Alt/r
	  Page Selection...   Alt/p

	Controls Menu
	  Interrupt	      Alt/I
	  Continue	      Alt/C

	View Menu
	  Shortcut Panel...   Alt/c
	  Scale	Selection...  Alt/s
	  Page Orientation... Alt/o

     PAGE SIZES
	  Page size options include page sizes defined by the user and
	  the following	international standard page sizes:

	  Metric ISO A sizes:
	  A0   841.0 x 1189.0 mm  (33.11 x 46.81 in.)
	  A1   594.0 x 841.0 mm	  (23.39 x 33.11 in.)
	  A2   420.0 x 594.0 mm	  (16.54 x 23.39 in.)
	  A3   297.0 x 420.0 mm	  (11.69 x 16.54 in.)
	  A4   210.0 x 297.0 mm	  ( 8.27 x 11.69 in.)
	  A5   148.0 x 210.0 mm	  ( 5.83 x 8.27	in.)
	  A6   105.0 x 148.0 mm	  ( 4.13 x 5.83	in.)
	  A7   74.0  x 105.0 mm	  ( 2.91 x 4.13	in.)
	  A8   52.0  x 74.0 mm	  ( 2.05 x 2.91	in.)
	  A9   37.0  x 52.0 mm	  ( 1.46 x 2.05	in.)
	  A10  26.0  x 37.0 mm	  ( 1.02 x 1.46	in.)

	  Metric ISO B sizes:
	  B0   1000.0x 1414.0 mm  (39.37 x 55.67 in.)
	  B1   707.0 x 1000.0 mm  (27.83 x 39.37 in.)
	  B2   500.0 x	707.0 mm  (19.68 x 27.83 in.)
	  B3   353.0 x	500.0 mm  (13.90 x 19.68 in.)
	  B4   250.0 x	353.0 mm  ( 9.84 x 13.90 in.)
	  B5   176.0 x	250.0 mm  ( 6.93 x 9.84	in.)
	  B6   125.0 x	176.0 mm  ( 4.92 x 6.93	in.)
	  B7   88.0  x	125.0 mm  ( 3.46 x 4.92	in.)
	  B8   62.0  x	 88.0 mm  ( 2.44 x 3.46	in.)
	  B9   44.0  x	 62.0 mm  ( 1.73 x 2.44	in.)
	  B10  31.0  x	 44.0 mm  ( 1.22 x 1.73	in.)

	  Metric ISO C sizes:
	  C0   914.4 x 1300.5 mm  (36.00 x 51.20 in.)
	  C1   650.2 x 914.4 mm	  (25.60 x 36.00 in.)
	  C2   457.2 x 650.2 mm	  (18.00 x 25.60 in.)
	  C3   325.1 x 457.2 mm	  (12.80 x 18.00 in.)
	  C4   228.6 x 325.1 mm	  ( 9.00 x 12.80 in.)
	  C5   162.6 x 228.6 mm	  ( 6.40 x 9.00	in.)
	  C6   114.3 x 162.6 mm	  ( 4.50 x 6.40	in.)
	  C7   81.3  x 114.3 mm	  ( 3.20 x 4.50	in.)

	  American ANSI	sizes:
	  A    8.5 x 11.0 in.	  ( 215.9 x 279.4 mm)
	  B    11.0 x 17.0 in.	  ( 279.4 x 431.8 mm)
	  C    17.0 x 22.0 in.	  ( 431.8 x 558.8 mm)
	  D    22.0 x 34.0 in.	  ( 558.8 x 863.6 mm)
	  E    34.0 x 44.0 in.	  ( 863.6 x 1117.6 mm)
	  F    28.0 x 40.0 in.	  ( 711.2 x 1016.0 mm)
	  E1   44.0 x 68.0 in.	  (1117.6 x 1727.2 mm)


     EXAMPLES
	  To load two files into the previewer,	the first a document
	  in the current directory, the	second from /usr/local/docs:

				  % xpsview mydoc.ps
	  /usr/local/docs/manual.ps

	  To view the plain text file story.txt, run the file through
	  a program that generates PostScript language output and pipe
	  the output to	the previewer's	stdin.	The following example
	  uses the enscript program from Adobe Systems Incorporated.

	       % enscript -p - story.txt | xpsview -

	  To load a file at double scale:

	       % xpsview -scale	2 filename

	  To start the program for viewing A4 documents:

				  % xpsview -ps	A4

	  To start the program for viewing documents 30	cm high	by 20
	  cm wide:

				  % xpsview -ps	20cm:30cm

	  To set a maximum pixmap size of 5 megabytes:

				  % xpsview -maxp 5m

     FILES
	  The name of the application defaults file for	the Adobe
	  Xpsview program is Xpsview2. This file should	be changed by
	  the system administrator only. Many of the widgets used by
	  the program get their	resources from this file. The file
	  must be in one of the	directories specified by the
	  XFILESEARCHPATH environment variable.

	  To override any of the resources, set	them in	your
	  .Xdefaults file.

     RESOURCES
	  The program understands standard Motif resource names	and
	  classes. In addition,	the following  resources allow
	  application-specific customization.


	  emulatePaperTrays
	     Type:   boolean	    Default: True
	     Option: -ept	    Menu:    Emulate Paper Trays

	     Description: Instructs the	program	to honor requests for
		     paper tray	changes	that come from the PostScript
		     language document itself by using a different
		     size display when the document calls for a
		     different size paper. When	set to False, the
		     program ignores paper tray	requests.

	  ignoreComments
	     Type:   boolean	    Default: False
	     Option: -igc	    Menu:    Ignore Comments

	     Description:  Instructs the program to ignore any DSC
		     comments it finds in a document and to treat the
		     document as unstructured.

	  maxPixmapBytes
	     Type:   integer	    Default: machine dependent
	     Option: -maxp

	     Description:  Allows you to set the maximum number	of
		     bytes allowed for the pixmap that the program
		     draws to before displaying	a page.	See the	-maxp
		     option for	more information. In contrast to the
		     -maxp option, the value of	this resource must be
		     an	integer. Scale factors (m and k) cannot	be
		     used.

	  monochrome
	     Type:   boolean	    Default: False
	     Option: -mono	    Menu:    Monochrome

	     Description: Instructs the	program	to display documents
		     in	monochrome even	on a color display. This
		     simulates the effect of printing on a monochrome
		     printer.

	  pageOrientation
	     Type:   string	    Default: portrait
	     Option: -or	    Menu:    Page Orientation

	     Description: Allows you to	select the initial orientation
		     of	a previewed page.  Possible settings are
		     portrait, landscape, flip_portrait,
		     flip_landscape.

	  pageSize
	     Type:   string	    Default: letter
	     Option: -ps

	     Description:  Allows you to set the default page size.
		     See PAGE SIZES for	a list of standard page	sizes.

	  readFromStandardInput
	     Type:   boolean	    Default: False

	     Description:  Determines whether the program reads	from
		     stdin by default, or only when the	- option is
		     used.

		     If	the - option is	used to	read from stdin, or if
		     the readFromStandardInput resource	is True, the
		     program may have to allocate a temporary file
		     during processing of stdin.  By default, the file
		     is	placed in /tmp and deleted automatically when
		     it	is no longer needed. Use the tempDir resource
		     or	the -tdir option to change the default
		     directory.

	  repositionEPSF
	     Type:   boolean	    Default: True
	     Option: -repsf	    Menu:    Reposition	EPS Files

	     Description:  Determines whether the program places the
		     upper left	corner of an EPS image in the upper
		     left corner of the	page.

	  scale
	     Type:   float	    Default: 1.0
	     Option: -scale	    Menu:    Scale Selection Panel

	     Description: Allows you to	select the initial scale
		     factor at which to	view documents.

	  skipCopyright
	     Type:   boolean	    Default: False
	     Option: -skipc

	     Description:  Instructs the program to bypass the display
		     of	the copyright notice upon startup.

	  substituteFonts
	     Type:   boolean	    Default: True
	     Option: -sf	    Menu:    Substitute	Fonts

	     Description:  Instructs the program to substitute Courier
		     for any missing fonts.

	  tempDir
	     Type:   string	    Default: /tmp
	     Option: -tdir dir

	     Description: When the previewer reads from	stdin, it
		     temporarily stores	the input in the directory
		     specified by tempDir and later removes it.

	  verbose
	     Type:   boolean	    Default: False
	     Option: -v

	     Description: When you set this resource to	True, the
		     program prints a short message to stderr each
		     time an error dialog box is displayed.

	  watchProgress
	     Type:   boolean	    Default: False
	     Option: -wp	    Menu:    Watch Progress

	     Description: Instructs the	program	to update the display
		     while rendering is	in progress instead of waiting
		     for a page	to complete before displaying any of
		     it.

     BUGS
	  If you are using a grayscale monitor and color pages are
	  displaying poorly -- for example, if shades of red and blue
	  are indistinguishable	-- your	X server is most likely
	  misconfigured	as a color server.  This problem frequently
	  manifests itself on SPARCstation X servers.  Adding the
	  option -cc 1 to the command line that	invokes	your X server
	  usually corrects the problem.

	  If this does not work, or if you are unable to change	your X
	  server invocation, add the following lines to	your
	  .Xdefaults file:

		     DPSColorCube.PseudoColor.8.reds: 0
		     DPSColorCube.PseudoColor.8.grays: 17

	  For more information,	see dps(1).

     SEE ALSO
	  TranScript(1), filterps(1), enscript(1)

	  [1] O'Reilly & Assoc., The Definitive	Guides to the X	Window
	  System, Vol. 0-7.

	  [2] Adobe Systems Incorporated, PostScript Language
	  Reference Manual, Second Edition.

     NOTES
	  Copyright 1991, 1992 Adobe Systems Incorporated. All Rights
	  Reserved.

	  Adobe, Adobe Xpsview,	PostScript, Display PostScript,	and
	  TranScript are trademarks of Adobe Systems Incorporated
	  which	may be registered in certain jurisdictions.

	  Motif	is a trademark of the Open Software Foundation,	Inc.
smaller bigger reset
last modified: February 20 2004.