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

FreeBSD Manual Pages

  
 
  

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

NAME
       ghostview - View	PostScript documents using ghostscript

SYNOPSIS
       ghostview [filename]
       or
       ghostview  [-monochrome]	[-grayscale] [-color] [-[no]title] [-[no]date]
       [-[no]locator] [-[no]labels] [-resolution dpi]  [-dpi dpi]  [-xdpi dpi]
       [-ydpi dpi]  [-magstep n]  [-[no]safer]	[-[no]quiet] [-arguments argu-
       ments] [-[no]center] [-portrait]	[-landscape] [-upsidedown] [-seascape]
       [-[no]swap]  [-letter] [-tabloid] [-ledger] [-legal] [-statement] [-ex-
       ecutive]	[-a3] [-a4] [-a5]  [-b4]  [-b5]	 [-folio]  [-quarto]  [-10x14]
       [-force]	    [-forceorientation]	   [-forcemedia]    [-[no]openwindows]
       [-[no]ncdwm] [-page label] [-toolkitoption ...]	[filename]

DESCRIPTION
       The ghostview program provides an X11 user  interface  for  the	ghost-
       script  interpreter.  Ghostview and ghostscript function	as two cooper-
       ating programs.	Ghostview creates the viewing window  and  ghostscript
       draws in	it.

       Don't  be  alarmed  by  the  number of options.	Generally, one invokes
       ghostview with just one parameter, the name of  the  file  to  be  pre-
       viewed.	 If the	filename is ``-'', ghostview will read from ``stdin''.
       The options provide a way to set	X resources from the command line  for
       a  single  invocation of	ghostview.  For	that reason, discussion	of the
       options is delayed until	after the X resources are discussed.

MAIN WINDOW
       The main	viewport is on the right side of the main window.  If the page
       is larger than the viewport, there will be scroll bars along the	bottom
       and right edges of the viewport.	 To the	left of	the  viewport  is  the
       table  of  contents.   If  the PostScript file has document structuring
       convention (DSC)	comments, the table of context will display  the  page
       labels  (i.e.  usually page numbers).  To the left of the table of con-
       tents is	the menu box.  Each push button	brings up a popup menu.	  Over
       the menu	box and	table of contents there	are three optional labels that
       contain the title, date,	and locator.  The  title  label	 contains  the
       document	 title	found  in the DSC comments.  If	no title can be	found,
       the filename is used in its place.  The date label contains  the	 docu-
       ment date found in the DSC comments.  If	no date	can be found, the last
       modified	date of	the file is used in its	place.	Since  the  title  and
       date labels may be clipped by the main viewport,	the date and title la-
       bels are	push buttons that bring	up a popup window with	the  title  or
       date.   These  popup  windows  also show	the ``document'' icon when the
       displayed string	comes from the DSC comments.  The  locator  shows  the
       location	 of  the cursor	in the viewport.  The location is expressed in
       the default user	coordinate system.  The	locator	is useful for  measur-
       ing bounding boxes.

       Within  the  main viewport the mouse cursor is a	``target'' when	ghost-
       script is doing work.  The cursor is a ``cross hair'' when  ghostscript
       is  idle.   When	 moving	to another page	in a document, it is generally
       best to wait for	ghostscript to become idle.   Otherwise,  the  current
       ghostscript process must	be killed and the overhead of reading the pro-
       logue is	incurred again.

       Ghostview will check to see if the file has been	modified  just	before
       it displays a page or when the application is deiconified.  If the file
       has changed, it will reopen the file.

       Clicking	anywhere within	the viewport will popup	a  zoom	 window.   The
       window  is centered about the location that was clicked.	 Clicking with
       the first mouse button pops up a	low resolution zoom window.   Clicking
       with  the  second mouse button pops up a	medium resolution zoom window.
       Clicking	with the third mouse button pops up  a	high  resolution  zoom
       window.	 The  cursor  in  the zoom window will display a ``target'' or
       ``cross hair'' depending	on the state of	ghostscript.  The locator  re-
       ports  the  position  of	 the cursor in the zoom	windows	as well	as the
       main viewport.

       In the table of contents, the first and third mouse button function ex-
       actly  as they do in a Text widget.  That is the	first mouse button se-
       lects text and the third	mouse  button  extends	selections.   However,
       clicking	 on  a page label with the second mouse	button will cause that
       page to be shown.  The page being displayed is marked with a '<'	in the
       right margin of the table of contents.

POPUP WINDOWS
       There  are  several  additional windows that may	appear.	 The copyright
       window will appear whenever copyright information  is  requested.   The
       information  window  appears whenever the ghostscript process writes to
       ``stdout'' or ``stderr''.  Whenever there is an error in	the PostScript
       program,	 the stack trace will appear in	this window.  When ghostscript
       is invoked without the quiet option,  informational  message  regarding
       the  state  of  ghostscript will	appear in the information window.  The
       copyright and information windows  can  be  dismissed  by  pushing  the
       ``Dismiss'' button.

       The Select File dialog widget will appear when you wish to open or save
       a file.	The Select File	dialog widget allows an	X11 user to  select  a
       file  by	 typing	 the path or by	browsing in directory listings and se-
       lecting entries with the	mouse.

       The space bar can be pressed to complete	filenames, and tilde  is  used
       for  home  directories.	 All the usual key bindings can	be used	in the
       text widget, except for Return and Control-M, which are	equivalent  to
       pressing	the OK button.	The path can be	scrolled using the large hori-
       zontal scroll bar, or by	moving the insertion cursor in the  text  wid-
       get.   The  directory entries can be scrolled using the vertical	scroll
       bars, or	by holding a mouse button down and moving out of the  listing.
       The scrolling speed varies with the distance from the listing.

       The  directory entries are terminated with special characters that show
       the type	of entry, similar to the -F option of ls(1).

       The Select File dialog widget is	in total control until is  pops	 down.
       No other	controls in ghostview will be active during this time.

MENUS
       There  are five buttons in the menu box.	 They are the File, Page, Mag-
       step, Orientation, and Media buttons.  There are	keyboard  accelerators
       for  most of the	popup menus.  Be sure to read the keyboard accelerator
       section.

       File	 This popup menu controls file access:

		 Open...   Pops	up the Select File window  in  preparation  to
			   open	 a  file.   The	Select File widget is in total
			   control until it pops down.	 Opens	the  file  for
			   viewing.

		 Reopen	   Reopens the current file.

		 Print...  Pops	 up  a	dialog	widget	to ask for the printer
			   name.  Sends	the whole document to the printer.

		 Print marked pages...
			   Pops	up a dialog widget  to	ask  for  the  printer
			   name.   Sends  the marked pages to the printer.  If
			   no pages have been marked, the  mark	 procedure  is
			   called  before  printing and	then the unmark	proce-
			   dure	is called after	printing.

		 Save marked pages...
			   Pops	up the Select File window  in  preparation  to
			   save	 a  file.   The	Select File widget is in total
			   control until it pops down.	Saves the marked pages
			   in  the  selected  file.   If  no  pages  have been
			   marked, the mark procedure is called	before	saving
			   and	then the unmark	procedure is called after sav-
			   ing.

		 Copyright...
			   Pops	up the copyright window.

		 Quit	   Causes ghostview to exit.

       Page	 This popup menu controls page access:

		 Next	   Display the next page.

		 Redisplay Display the current page.

		 Previous  Display the previous	page.

		 Center	   Center the page in the viewport.

		 Mark	   Mark	the pages that have been selected in the table
			   of  contents.  If no	pages have been	selected, mark
			   the current page.

		 Unmark	   Unmark the pages that have been selected in the ta-
			   ble	of  contents.  If no pages have	been selected,
			   unmark the current page.

       Magstep	 The Magstep menu controls the magnification at	which the doc-
		 ument	is viewed.  The	default	magstep	of 0 implies no	magni-
		 fication (i.e.	the size on the	screen should match  the  size
		 on paper).  Ghostview borrows the notion of magstep from TeX.
		 The magnification is defined to be 1.2**magstep.  At  magstep
		 1, the	document is magnified by 1.2.  At magstep -1, the doc-
		 ument is reduced by 1.2.  The Magstep menu lists values  from
		 -5 to 5.

       Orientation
		 The  Orientation  menu	 controls  the display orientation.  A
		 ``dot'' appears in front of  the  current  orientation.   The
		 first	mouse  button  sets  the default orientation.  The DSC
		 comments may specify an orientation of	Portrait or  Landscape
		 that  overrides  the default.	In this	case, a	"document" ap-
		 pears in front	of the current orientation.  The second	 mouse
		 button	can be used to ``force'' the orientation on a document
		 to override the DSC comments.	If  an	orientation  is	 being
		 forced,  then	a  ``tie fighter'' will	appear in front	of the
		 current orientation.

		 Portrait  Set the orientation to Portrait.  This  implies  no
			   rotation.   A  portrait  orientation	indicates that
			   the longest edge of the paper is  parallel  to  the
			   vertical (y)	axis.

		 Landscape Set	the  orientation to Landscape.	This implies a
			   clockwise rotation of the paper by 90  degrees.   A
			   landscape  orientation  indicates  that the longest
			   edge	of the paper is	parallel to the	horizontal (x)
			   axis.

		 Upside-down
			   Set the orientation to Upside-Down.

		 Seascape  Set	the  orientation  to Seascape.	This implies a
			   counterclockwise rotation of	the paper  by  90  de-
			   grees.

		 Swap Landscape
			   Swap	 the  meaning of Landscape and Seascape.  Most
			   of the Landscape documents that I have  encountered
			   require  a  90  clockwise  rotation of the paper to
			   view.   However, there is no	standard and some doc-
			   uments  need	to be rotated the other	way.  The swap
			   landscape button allows ghostview to	 automatically
			   rotate  the	document  the right way	in response to
			   the %%Orientation comment in	the PostScript file.

       Media	 The entries on	the Media menu set the page media.  Media  de-
		 fined	in  the	 document  appear at the beginning of the menu
		 separated by a	line from the standard media.  A  ``dot''  ap-
		 pears	in front of the	current	media.	The first mouse	button
		 sets the default media.  The DSC  comments  may  specify  the
		 page media that overrides the default.	 In this case, a "doc-
		 ument"	appears	in front of the	 current  media.   The	second
		 mouse button can be used to ``force'' the media on a document
		 to override the DSC comments.	Forcing	the media on  an  EPSF
		 figure	will override the Bounding Box.	 This makes is easy to
		 view a	figure with an incorrect %%BoundingBox comment.	 If  a
		 media	is being forced, then a	``tie fighter''	will appear in
		 front of the current media.

		 Here are the standard media names and their sizes.  The  size
		 is given as the width and height in PostScript	points.
		 Letter		 612 x	792    (8.5 x 11  in.)
		 Tabloid	 792 x 1224    (11  x 17  in.)
		 Ledger		1224 x	792    (17  x 11  in.)
		 Legal		 612 x 1008    (8.5 x 14  in.)
		 Statement	 396 x	612    (5.5 x 8.5 in.)
		 Executive	 540 x	720    (7.5 x 10  in.)
		 A3		 842 x 1190
		 A4		 595 x	842
		 A5		 420 x	595
		 B4		 729 x 1032
		 B5		 516 x	729
		 Folio		 612 x	936    (8.5 x 13  in.)
		 Quarto		 610 x	780
		 10x14		 720 x 1008    (10  x 14  in.)

KEYBOARD ACCELERATORS
       Most  of	 the popup menu	commands have an equivalent action that	can be
       invoked from the	keyboard.  The popup  menu  entry  must	 be  sensitive
       (i.e.  not  grayed out) for the action to have effect.  Here is the de-
       fault keyboard binding:

       Q	 Bound to GhostviewQuit() which	is equivalent to  pushing  the
		 Quit menu button on the Ghostview menu.

       O	 Bound	to  GhostviewOpen() which is equivalent	to pushing the
		 Open... menu button on	the File menu.

       R	 Bound to GhostviewReopen() which is equivalent	to pushing the
		 Reopen	menu button on the File	menu.

       S	 Bound	to  GhostviewSave() which is equivalent	to pushing the
		 Save marked pages... menu button on the File menu.

       P	 Bound to GhostviewPrintMarked() which is equivalent to	 push-
		 ing the Print marked pages... menu button on the File menu.

       Shift-P	 Bound to GhostviewPrintWhole()	which is equivalent to pushing
		 the Print... menu button on the File menu.

       BackSpace, Delete, Prior, B
		 Bound to GhostviewPrevious() which is equivalent  to  pushing
		 the Previous menu button on the Page menu.

       space, Return, Next, F
		 Bound	to  GhostviewNext() which is equivalent	to pushing the
		 Next menu button on the Page menu.

       period, Ctrl-L
		 Bound to GhostviewShow() which	is equivalent to  pushing  the
		 Redisplay menu	button on the Page menu.

       M	 Bound	to  GhostviewMark() which is equivalent	to pushing the
		 Mark menu button on the Page menu.

       N	 Bound to GhostviewUnMark() which is equivalent	to pushing the
		 Unmark	menu button on the Page	menu.

       0	 Bound	to  GhostviewMagstep(0)	which is equivalent to pushing
		 the 0 menu button on the Magstep menu.

       1	 Bound to GhostviewMagstep(1) which is equivalent  to  pushing
		 the 1 menu button on the Magstep menu.

       2	 Bound	to  GhostviewMagstep(2)	which is equivalent to pushing
		 the 2 menu button on the Magstep menu.

       3	 Bound to GhostviewMagstep(3) which is equivalent  to  pushing
		 the 3 menu button on the Magstep menu.

       4	 Bound	to  GhostviewMagstep(4)	which is equivalent to pushing
		 the 4 menu button on the Magstep menu.

       5	 Bound to GhostviewMagstep(5) which is equivalent  to  pushing
		 the 5 menu button on the Magstep menu.

       +	 Bound	to GhostviewIncreaseMagstep() which increases the mag-
		 step by 1.

       -	 Bound to GhostviewDecreaseMagstep() which decreases the  mag-
		 step by 1.

       U	 Bound to GhostviewUp()	which scrolls the main viewport	up.

       D	 Bound	to  GhostviewDown()  which  scrolls  the main viewport
		 down.

       H	 Bound to GhostviewLeft()  which  scrolls  the	main  viewport
		 left.

       J	 Bound	to  GhostviewDown()  which  scrolls  the main viewport
		 down.

       K	 Bound to GhostviewUp()	which scrolls the main viewport	up.

       L	 Bound to GhostviewRight() which  scrolls  the	main  viewport
		 right.

       Up (arrow)
		 Bound to GhostviewDefault() GhostviewSetOrientation(portrait)
		 which is equivalent to	pushing	Portrait with the first	 mouse
		 button	on the Orientation menu.

       Right (arrow)
		 Bound	 to  GhostviewDefault()	 GhostviewSetOrientation(land-
		 scape)	which is equivalent  to	 pushing  Landscape  with  the
		 first mouse button on the Orientation menu.

       Down (arrow)
		 Bound	 to   GhostviewDefault()   GhostviewSetOrientation(up-
		 side-down) which is equivalent	to  pushing  Upside-down  with
		 the first mouse button	on the Orientation menu.

       Left (arrow)
		 Bound to GhostviewDefault() GhostviewSetOrientation(seascape)
		 which is equivalent to	pushing	Seascape with the first	 mouse
		 button	on the Orientation menu.

       Shift-Up	(arrow)
		 Bound	to  GhostviewForce() GhostviewSetOrientation(portrait)
		 which is equivalent to	pushing	Portrait with the second mouse
		 button	on the Orientation menu.

       Shift-Right (arrow)
		 Bound	to GhostviewForce() GhostviewSetOrientation(landscape)
		 which is equivalent to	 pushing  Landscape  with  the	second
		 mouse button on the Orientation menu.

       Shift-Down (arrow)
		 Bound	  to	GhostviewForce()   GhostviewSetOrientation(up-
		 side-down) which is equivalent	to  pushing  Upside-down  with
		 the second mouse button on the	Orientation menu.

       Shift-Left (arrow)
		 Bound	to  GhostviewForce() GhostviewSetOrientation(seascape)
		 which is equivalent to	pushing	Seascape with the second mouse
		 button	on the Orientation menu.

ACTIONS
       Most  of	 the popup menu	commands have an equivalent action that	can be
       used in a translation.  The popup menu entry must  be  sensitive	 (i.e.
       not grayed out) for the action to have effect.  Here is the list	of ac-
       tions:

       GhostviewCopyright()
		 Equivalent to pushing the Copyright...	 menu  button  on  the
		 Ghostview menu.

       GhostviewQuit()
		 Equivalent  to	 pushing the Quit menu button on the Ghostview
		 menu.

       GhostviewOpen()
		 Equivalent to pushing the Open... menu	 button	 on  the  File
		 menu.

       GhostviewReopen()
		 Equivalent  to	 pushing  the  Reopen  menu button on the File
		 menu.

       GhostviewSave()
		 Equivalent to pushing the Save	marked pages...	menu button on
		 the File menu.

       GhostviewPrintWhole()
		 Equivalent  to	 pushing  the Print... menu button on the File
		 menu.

       GhostviewPrintMarked()
		 Equivalent to pushing the Print marked	pages...  menu	button
		 on the	File menu.

       GhostviewPrevious()
		 Equivalent  to	 pushing  the Previous menu button on the Page
		 menu.

       GhostviewShow()
		 Equivalent to pushing the Redisplay menu button on  the  Page
		 menu.

       GhostviewNext()
		 Equivalent to pushing the Next	menu button on the Page	menu.

       GhostviewCenter()
		 Equivalent  to	 pushing  the  Center  menu button on the Page
		 menu.

       GhostviewMark()
		 Equivalent to pushing the Mark	menu button on the Page	menu.

       GhostviewUnmark()
		 Equivalent to pushing the Unmark  menu	 button	 on  the  Page
		 menu.

       GhostviewSetMagstep(magstep)
		 Sets the magstep.  The	parameter must be an integer.

       GhostviewIncreaseMagstep()
		 Increases magstep by one.

       GhostviewDecreaseMagstep()
		 Decreases magstep by one.

       GhostviewSetOrientation(orientation)
		 Set  the  orientation to the passed parameter.	 The parameter
		 must be portrait, landscape, upside-down, or seascape.

       GhostviewSwapLandscape()
		 Equivalent to pushing the Swap	Landscape menu button  on  the
		 Orientation menu.

       GhostviewSetPageMedia(media-name)
		 Sets  the  media.  The	parameter should be either a media de-
		 fined in the document or a standard media.

       GhostviewDefault()
		 The orientation or media being	set is not forced on the docu-
		 ment.	 This action is	called before the action that sets the
		 orientation or	media.

       GhostviewForce()
		 The orientation or media being	set is forced on the document.
		 This  action is called	before the action that sets the	orien-
		 tation	or media.

       GhostviewDeleteWindow()
		 Destroy the current window.  This provides a way to implement
		 the Delete Window protocol for	window managers.

       GhostviewDismiss()
		 Pop  down  the	current	window.	 This provides a way to	imple-
		 ment the Delete Window	protocol for window managers.

       GhostviewScrollUp()
		 Scroll	the main viewport up.

       GhostviewScrollDown()
		 Scroll	the main viewport down.

       GhostviewScrollLeft()
		 Scroll	the main viewport left.

       GhostviewScrollRight()
		 Scroll	the main viewport right.

       GhostviewEraseLocator()
		 Used to erase the locator when	leaving	a Ghostview widget.

       GhostviewCheckFile()
		 Checks	to see if the file changed and refreshes the screen if
		 necessary.

APPLICATION RESOURCES
       The  following  application resources may be set	to control the default
       behavior	of ghostview.

       showTitle (class	Labels)
		 Tells whether to display the %%Title comment.	The default is
		 ``true''.

       showDate	(class Labels)
		 Tells	whether	to display the %%Data comment.	The default is
		 ``true''.

       showLocator (class Labels)
		 Tells	whether	 to  display  the  locator.   The  default  is
		 ``true''.

       autoCenter (class AutoCenter)
		 Tells whether to center the page within the viewport whenever
		 the page size changes.	 The default is	``true''.

       horizonalMargin (class Margin)
		 Tells how many	pixels ghostview  should  reserve  for	window
		 decorations  in  the horizontal direction.  The default value
		 is ``20''.

       verticalMargin (class Margin)
		 Tells how many	pixels ghostview  should  reserve  for	window
		 decorations  in the vertical direction.  The default value is
		 ``44''.

       minimumMagstep (class Magstep)
		 Tells the  smallest  magstep  to  display.   The  default  is
		 ``-5''.

       maximumMagstep (class Magstep)
		 Tells the largest magstep to display.	The default is ``5''.

       magstep (class Magstep)
		 Sets the default magstep.  The	default	is ``0''.

       orientation (class Orientation)
		 Sets the default orientation.	The default is ``Portrait''.

       page (class Page)
		 Gives	the  initial  page to display.	This resource only af-
		 fects the display of the file listed  on  the	command	 line.
		 The default is	NULL.

       pageMedia (class	PageMedia)
		 Sets the default page media.  The default is ``Letter''.

       forceOrientation	(class Force)
		 Tells	whether	to force the orientation on the	document.  The
		 default is ``false''.

       forcePageMedia (class Force)
		 Tells whether to force	the page media on the  document.   The
		 default is ``false''.

       swapLandscape (class SwapLandscape)
		 Tells	whether	to swap	the meaning of Landscape and Seascape.
		 The default is	``false''.

       printCommand (class PrintCommand)
		 Sets the command used for printing.  The printer  environment
		 variable  is set to the desired printer and then this command
		 is executed using  popen.   This  command  should  read  from
		 ``stdin''  and	send the file to the appropriate printer.  The
		 default value is ``lpr'' for BSD and ``lp'' for System	V.

       printerVariable (class PrinterVariable)
		 Gives the name	of the printer environment variable.  The  de-
		 fault	value is ``PRINTER'' for BSD and ``LPDEST'' for	System
		 V.

       defaultPrinter (class DefaultPrinter)
		 Gives the printer name	to use when  the  printer  environment
		 variable is not set.  The default value is NULL.

       printPrompt (class PrintPrompt)
		 Sets  the  prompt  used to ask	for the	printer	name.  The de-
		 fault value is	``Printer Name:	''.

       printFail (class	printFail)
		 Sets the string used to inform	the user that the printer com-
		 mand failed.  The default is ``"lpr" command failed.''.

       openPrompt (class OpenPrompt)
		 Sets the prompt used to ask for a file	name to	open.  The de-
		 fault value is	``Open File: ''.

       openFail	(class OpenFail)
		 Sets the string used to inform	the user that the open failed.
		 The default value is ``Cannot open file: ''.

       savePrompt (class SavePrompt)
		 Sets the prompt used to ask for a file	name to	save.  The de-
		 fault value is	``Save File: ''.

       saveFail	(class SaveFail)
		 Sets the string used to inform	the user that the save failed.
		 The default value is ``Cannot save file: ''.

       openWindows (class OpenWindows)
		 OpenWindows servers sometimes cause error messages about bit-
		 maps not being	1 bit deep.  Turning on	this  resource	avoids
		 the problem by	not using any bitmaps.	You lose the function-
		 ality of having the current magstep,  orientation  and	 media
		 marked	on the popup menus.  The default value is ``false''.

       ncdwm (class Ncdwm)
		 The  Xt Intrinsics has	a bug that causes bogus	information in
		 the window manager size hints.	 Ncdwm and possibly other win-
		 dow  managers	get confused by	the bogus information and make
		 the window extremely small.  Twm and mwm ignore the bogus in-
		 formation.   Turning  on the resource avoids the problem with
		 ncdwm by doing	things slightly	 differently.	However,  this
		 can  confuse  other window managers such as mwm.  This	bug is
		 fixed in X11R5	fix-10.	 You should only set this resource  if
		 you have the problem.	The default value is ``false''.

GHOSTVIEW WIDGET RESOURCES
       Certain	resources  in  the  Ghostview  widget  may be set by the user.
       These selected resources	are presented below.

       arguments (class	Arguments)
		 Additional arguments passed to	the interpreter.  It is	conve-
		 nient	to  name  files	that preload fonts here	for PostScript
		 programs that continually  reload  fonts  while  rendering  a
		 page.	The default is no additional arguments.

       busyCursor (class Cursor)
		 The cursor shown when ghostscript is rendering	to the window.
		 The busy cursor is set	to the ``target'' by  the  application
		 defaults.

       cursor (class Cursor)
		 The  cursor shown when	ghostscript is idle.  The default cur-
		 sor is	the ``crosshair''.

       interpreter (class Interpreter)
		 The name of the executable to call to render the  PostScript.
		 It  is	 convenient to set this	resource to the	path of	an al-
		 ternate version of  ghostscript  for  testing.	  The  default
		 value is ``gs''.

       palette (class Palette)
		 Tells	ghostscript how	to restrict the	palette	used when ren-
		 dering.  The possible values  are  ``color'',	``grayscale'',
		 and ``monochrome''.  The default value	is ``color''.

       quiet (class Quiet)
		 Tells	ghostscript whether to supress informational messages.
		 The default value is ``true''.

       safer (class Safer)
		 Tells ghostscript whether to run in ``safer'' mode.  The  de-
		 fault value is	``true''.

       useBackingPixmap	(class UseBackingPixmap)
		 Tells	whether	 to use	a backing pixmap.  If this resource is
		 false,	backing	store is requested on  the  Ghostview  window.
		 Some  X  servers  have	 limited  resources for	large pixmaps.
		 Also, some X servers' backing store is	much faster than using
		 a  backing  pixmap.  You should reset this resource if	your X
		 server	is one of the server  types  mentioned.	  The  default
		 value is ``true''.

       xdpi (class Resolution)
		 Sets  the  X  resolution of the window	in dots	per inch.  You
		 can use this resource to affect the main window.   Zoom  win-
		 dows have their X dpi set explicitly in the program.  The de-
		 fault value is	calculated from	the screen metrics.

       ydpi (class Resolution)
		 Sets the Y resolution of the window in	dots  per  inch.   You
		 can  use  this	resource to affect the main window.  Zoom win-
		 dows have their Y dpi set explicitly in the program.  The de-
		 fault value is	calculated from	the screen metrics.

GHOSTVIEW WIDGET ACTIONS
       notify(width height xdpi	ydpi)
		 The notify event is used by the ghostview application for the
		 locator and popup zoom	windows.  If the width and height  are
		 0, the	event is user for the locator.	Otherwise, it triggers
		 a popup zoom window.  The default width and  height  are  72.
		 The  default  xdpi and	ydpi are 300.  The height will default
		 to the	width if the height is omitted.	 The xdpi will default
		 to the	xdpi if	the ydpi is omitted.

OPTIONS
       -monochrome
		 Equivalent to setting ``*Ghostview.palette: Monochrome''.

       -grayscale
		 Equivalent to setting ``*Ghostview.palette: GrayScale''.

       -color	 Equivalent to setting ``*Ghostview.palette: Color''.

       -title	 Equivalent to setting ``Ghostview.showTitle: True''.

       -notitle	 Equivalent to setting ``Ghostview.showTitle: False''.

       -date	 Equivalent to setting ``Ghostview.showDate: True''.

       -nodate	 Equivalent to setting ``Ghostview.showDate: False''.

       -locator	 Equivalent to setting ``Ghostview.showLocator:	True''.

       -nolocator
		 Equivalent to setting ``Ghostview.showLocator:	False''.

       -labels	 Equivalent to setting ``Ghostview.Labels: True''.

       -nolabels Equivalent to setting ``Ghostview.Labels: False''.

       -resolution dpi
		 Equivalent to setting ``*Ghostview.Resolution:	dpi''.

       -dpi dpi	 Equivalent to setting ``*Ghostview.Resolution:	dpi''.

       -xdpi dpi Equivalent to setting ``*Ghostview.xdpi: dpi''.

       -ydpi dpi Equivalent to setting ``*Ghostview.ydpi: dpi''.

       -magstep	magstep
		 Equivalent to setting ``Ghostview.magstep: magstep''.

       -safer	 Equivalent to setting ``*Ghostview.safer: True''.

       -nosafer	 Equivalent to setting ``*Ghostview.safer: False''.

       -quiet	 Equivalent to setting ``*Ghostview.quiet: True''.

       -noquiet	 Equivalent to setting ``*Ghostview.quiet: False''.

       -arguments arguments
		 Equivalent to setting ``*Ghostview.arguments: arguments''.

       -center	 Equivalent to setting ``Ghostview.autoCenter: True''.

       -nocenter Equivalent to setting ``Ghostview.autoCenter: False''.

       -portrait Equivalent to setting ``Ghostview.orientation:	Portrait''.

       -landscape
		 Equivalent to setting ``Ghostview.orientation:	Landscape''.

       -upsidedown
		 Equivalent to setting ``Ghostview.orientation:	Upside-down''.

       -seascape Equivalent to setting ``Ghostview.orientation:	Seascape''.

       -swap	 Equivalent to setting ``Ghostview.swapLandscape: True''.

       -noswap	 Equivalent to setting ``Ghostview.swapLandscape: False''.

       -letter	 Equivalent to setting ``Ghostview.pageMedia: Letter''.

       -tabloid	 Equivalent to setting ``Ghostview.pageMedia: Tabloid''.

       -ledger	 Equivalent to setting ``Ghostview.pageMedia: Ledger''.

       -legal	 Equivalent to setting ``Ghostview.pageMedia: Legal''.

       -statement
		 Equivalent to setting ``Ghostview.pageMedia: Statement''.

       -executive
		 Equivalent to setting ``Ghostview.pageMedia: Executive''.

       -a3	 Equivalent to setting ``Ghostview.pageMedia: A3''.

       -a4	 Equivalent to setting ``Ghostview.pageMedia: A4''.

       -a5	 Equivalent to setting ``Ghostview.pageMedia: A5''.

       -b4	 Equivalent to setting ``Ghostview.pageMedia: B4''.

       -b5	 Equivalent to setting ``Ghostview.pageMedia: B5''.

       -folio	 Equivalent to setting ``Ghostview.pageMedia: Folio''.

       -quarto	 Equivalent to setting ``Ghostview.pageMedia: Quarto''.

       -10x14	 Equivalent to setting ``Ghostview.pageMedia: 10x14''.

       -force	 Equivalent to setting ``Ghostview.Force: True''.

       -forceorientation
		 Equivalent to setting ``Ghostview.forceOrientation: True''.

       -forcemedia
		 Equivalent to setting ``Ghostview.forcePageMedia: True''.

       -openwindows
		 Equivalent to setting ``Ghostview.openWindows:	True''.

       -noopenwindows
		 Equivalent to setting ``Ghostview.openWindows:	False''.

       -ncdwm	 Equivalent to setting ``Ghostview.ncdwm: True''.

       -noncdwm	 Equivalent to setting ``Ghostview.ncdwm: False''.

       -page label
		 Equivalent to setting ``Ghostview.page: label''.

WIDGET HIERARCHY
       The hierarchy of	the ghostview application:

       Ghostview  ghostview
	    Form  form
		 MenuButton  titleButton
		      SimpleMenu  menu
			   SmeBSB  title
		 MenuButton  dateButton
		      SimpleMenu  menu
			   SmeBSB  date
		 Label	locator
		 Box  box
		      MenuButton  fileButton
			   SimpleMenu  menu
				SmeBSB	open
				SmeBSB	reopen
				SmeBSB	printwhole
				SmeBSB	printmarked
				SmeBSB	save
				SmeLine	 line
				SmeBSB	copyright
				SmeBSB	quit
		      MenuButton  pageButton
			   SimpleMenu  menu
				SmeBSB	next
				SmeBSB	show
				SmeBSB	prev
				SmeLine	 line
				SmeBSB	center
				SmeLine	 line
				SmeBSB	mark
				SmeBSB	unmark
		      MenuButton  magstepButton
			   SimpleMenu  menu
				SmeBSB	-5
				SmeBSB	-4
				SmeBSB	-3
				SmeBSB	-2
				SmeBSB	-1
				SmeBSB	0
				SmeBSB	1
				SmeBSB	2
				SmeBSB	3
				SmeBSB	4
				SmeBSB	5
		      MenuButton  orientationButton
			   SimpleMenu  menu
				SmeBSB	portrait
				SmeBSB	landscape
				SmeBSB	upsidedown
				SmeBSB	seascape
				SmeLine	 line
				SmeBSB	swap
		      MenuButton  pagemediaButton
			   SimpleMenu  menu
				SmeBSB	Letter
				SmeBSB	Tabloid
				SmeBSB	Ledger
				SmeBSB	Legal
				SmeBSB	Statement
				SmeBSB	Executive
				SmeBSB	A3
				SmeBSB	A4
				SmeBSB	A5
				SmeBSB	B4
				SmeBSB	B5
				SmeBSB	Folio
				SmeBSB	Quarto
				SmeBSB	10x14
		 Text  toc
		 Viewport  pageview
		      Core  clip
		      Ghostview	 page
		      Scrollbar	 horizontal
		      Scrollbar	 vertical
	    TopLevelShell  information
		 Form  form
		      Text  text
		      Command  dismiss
	    TopLevelShell  copyright
		 Form  form
		      Text  text
		      Command  dismiss
	    TransientShell  popup
		 Form  dialog
		      Label  prompt
		      Text  response
		      Command  okay
		      Command  cancel
	    TopLevelShell  zoom
		 Form  form
		      Ghostview	 page
		      Command  dismiss

       The hierarchy of	the Select File	dialog box:

       TransientShell  selFile
	    Form  selFileForm
		 Label	selFilePrompt
		 Text  selFileField
		 Scrollbar  selFileHScroll
		 Composite  selFileList1
		      Scrollbar	 selFileVScroll
		      Scrollbar	 selFileHScroll
		 Composite  selFileList2
		      Scrollbar	 selFileVScroll
		      Scrollbar	 selFileHScroll
		 Composite  selFileList3
		      Scrollbar	 selFileVScroll
		      Scrollbar	 selFileHScroll
		 Command  selFileOK
		 Command  selFileCancel

ENVIRONMENT
       LPDEST	 The  LPDEST  environment  variable  gives the default printer
		 destination on	System V.

       PRINTER	 The PRINTER environment variable gives	 the  default  printer
		 destination on	BSD.

LIMITATIONS
       If  the document	does not begin with ``%!PS-Adobe-'', it	does not claim
       conformance to the document structuring convention.  When  these	 docu-
       ments  are  encountered,	 the  functionality of ghostview is limited to
       giving you scroll bars and a next page capability.  Because there is no
       table  of  contents,  skipping around the document and marking pages is
       impossible.

       If there	is no table of contents	for the	document, the popup zoom  win-
       dow will	always show the	first page.

BUGS
       If you find a bug, please send a	bug report to ghostview@cs.wisc.edu.

AUTHOR
       Copyright (C) 1992  Timothy O. Theisen

       This program is free software; you can redistribute it and/or modify it
       under the terms of the GNU General Public License as published  by  the
       Free  Software Foundation; either version 2 of the License, or (at your
       option) any later version.

       This program is distributed in the hope that it	will  be  useful,  but
       WITHOUT	ANY  WARRANTY;	without	 even  the  implied  warranty  of MER-
       CHANTABILITY or FITNESS FOR A PARTICULAR	PURPOSE.  See the GNU  General
       Public License for more details.

       You should have received	a copy of the GNU General Public License along
       with this program; if not, write	to the Free Software Foundation, Inc.,
       675 Mass	Ave, Cambridge,	MA 02139, USA.

       Author:	 Tim Theisen	     Systems Programmer
       Internet: tim@cs.wisc.edu     Department	of Computer Sciences
       UUCP:	 uwvax!tim	     University	of Wisconsin-Madison
       Phone:	 (608)262-0438	     1210 West Dayton Street
       FAX:	 (608)262-9777	     Madison, WI   53706

ACKNOWLEDGEMENTS
       The Select File widget contains the following copyright notice:

       Copyright 1989 Software Research	Associates, Inc., Tokyo, Japan

       Permission  to  use, copy, modify, and distribute this software and its
       documentation for any purpose and without fee is	hereby	granted,  pro-
       vided  that  the	 above	copyright notice appear	in all copies and that
       both that copyright notice and this permission notice  appear  in  sup-
       porting	documentation,	and  that  the name of Software	Research Asso-
       ciates not be used in advertising or publicity pertaining to  distribu-
       tion of the software without specific, written prior permission.	 Soft-
       ware Research Associates	makes no representations about the suitability
       of  this	 software for any purpose.  It is provided "as is" without ex-
       press or	implied	warranty.

       SOFTWARE	RESEARCH ASSOCIATES DISCLAIMS ALL WARRANTIES  WITH  REGARD  TO
       THIS  SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES	OF MERCHANTABILITY AND
       FITNESS,	IN NO EVENT SHALL SOFTWARE RESEARCH ASSOCIATES BE  LIABLE  FOR
       ANY  SPECIAL,  INDIRECT OR CONSEQUENTIAL	DAMAGES	OR ANY DAMAGES WHATSO-
       EVER RESULTING FROM LOSS	OF USE,	DATA OR	PROFITS, WHETHER IN AN	ACTION
       OF  CONTRACT, NEGLIGENCE	OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
       CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

       Author:	 Erik M. van der Poel
		 Software Research Associates, Inc., Tokyo, Japan
		 erik@sra.co.jp

								  GHOSTVIEW(1)

NAME | SYNOPSIS | DESCRIPTION | MAIN WINDOW | POPUP WINDOWS | MENUS | KEYBOARD ACCELERATORS | ACTIONS | APPLICATION RESOURCES | GHOSTVIEW WIDGET RESOURCES | GHOSTVIEW WIDGET ACTIONS | OPTIONS | WIDGET HIERARCHY | ENVIRONMENT | LIMITATIONS | BUGS | AUTHOR | ACKNOWLEDGEMENTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ghostview&sektion=1&manpath=FreeBSD+5.4-RELEASE+and+Ports>

home | help