man pages for ghostview

SunOS 5.7 Last change:

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 arguments]  [-[no]center]  [-por-
     trait] [-landscape]  [-upsidedown]  [-seascape]  [-[no]swap]
     [-letter]  [-tabloid] [-ledger] [-legal] [-statement] [-exe-
     cutive] [-a3] [-a4] [-a5]  [-b4]  [-b5]  [-folio]  [-quarto]
     [-10x14]    [-force]    [-forceorientation]    [-forcemedia]
     [-[no]openwindows] [-[no]ncdwm] [-page  label]  [-toolkitop-
     tion ...]  [filename]

DESCRIPTION
     The ghostview program provides an X11 user interface for the
     ghostscript interpreter.  Ghostview and ghostscript function
     as two cooperating 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 previewed.  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 con-
     tents.  If the PostScript file has document structuring con-
     vention  (DSC)  comments,  the table of context will display
     the page labels (i.e. usually page numbers).  To the left of
     the  table  of  contents  is the menu box.  Each push button
     brings up a popup menu.  Over the menu box and table of con-
     tents  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 document 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 labels  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 measuring bounding boxes.

     Within the main viewport the mouse cursor  is  a  ``target''
     when  ghostscript  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 read-
     ing the prologue 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 win-
     dow.   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 but-
     ton pops up a medium resolution zoom window.  Clicking  with
     the  third  mouse button pops up a high resolution zoom win-
     dow.  The cursor in the zoom window will  display  a  ``tar-
     get''   or   ``cross   hair''  depending  on  the  state  of
     ghostscript.  The locator reports 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  exactly  as they do in a Text widget.  That is the
     first mouse button selects 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 infor-
     mation 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 brows-
     ing  in  directory  listings  and selecting entries with the

     mouse.

     The space bar can be  pressed  to  complete  filenames,  and
     tilde is used for home directories.  All the usual key bind-
     ings 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  horizontal  scroll
     bar,  or  by moving the insertion cursor in the text widget.
     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,  Magstep,  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 pro-
                         cedure 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 saving.

               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  table of contents.  If no pages
                         have been selected, unmark  the  current
                         page.

     Magstep   The Magstep menu  controls  the  magnification  at
               which the document is viewed.  The default magstep
               of 0 implies no magnification (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  document is reduced by 1.2.
               The Magstep menu lists values from -5 to 5.

     Orientation
               The Orientation menu controls the display orienta-
               tion.   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 over-
               rides  the  default.   In  this case, a "document"
               appears in front of the current orientation.   The
               second  mouse  button can be used to ``force'' the
               orientation on a document to override the DSC com-
               ments.   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 orien-
                         tation 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 orien-
                         tation  indicates  that the longest edge
                         of the paper is parallel to the horizon-
                         tal (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 degrees.

               Swap Landscape
                         Swap the meaning of Landscape and  Seas-
                         cape.   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
                         documents  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 defined in the document appear at the begin-
               ning of the menu separated  by  a  line  from  the
               standard media.  A ``dot'' appears 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 "document" 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  %%Boun-
               dingBox 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 default 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  pushing  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 magstep by 1.

     -         Bound    to    GhostviewDecreaseMagstep()    which
               decreases the magstep 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(landscape)     which    is
               equivalent to pushing  Landscape  with  the  first
               mouse button on the Orientation menu.

     Down (arrow)
               Bound            to             GhostviewDefault()
               GhostviewSetOrientation(upside-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(upside-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 actions:

     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 but-
               ton on the Orientation menu.

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

     GhostviewDefault()
               The orientation or media being set is  not  forced
               on the document.  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 orientation 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 implement 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 affects 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 docu-
               ment.  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  vari-
               able.   The  default  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 default value is ``Printer Name: ''.

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

     openPrompt (class OpenPrompt)
               Sets the prompt used to ask for  a  file  name  to
               open.  The default 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 default 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  bitmaps  not  being 1 bit deep.  Turning on
               this resource avoids the problem by not using  any
               bitmaps.  You lose the functionality 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 window managers get  con-
               fused by the bogus information and make the window
               extremely small.  Twm and  mwm  ignore  the  bogus
               information.   Turning  on the resource avoids the
               problem with ncdwm by doing things  slightly  dif-
               ferently.   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 convenient 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 ``tar-
               get'' by the application defaults.

     cursor (class Cursor)
               The cursor shown when ghostscript  is  idle.   The
               default cursor 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 alternate version of ghostscript
               for testing.  The default value is ``gs''.

     palette (class Palette)
               Tells ghostscript how to restrict the palette used
               when   rendering.    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 default 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  men-
               tioned.  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 windows have their  X  dpi  set
               explicitly  in  the program.  The default 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 windows have their  Y  dpi  set
               explicitly  in  the program.  The default value is
               calculated from the screen metrics.

GHOSTVIEW WIDGET ACTIONS
     notify(width height xdpi ydpi)
               The notify event is used by the ghostview applica-
               tion  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:  Mono-
               chrome''.

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

     -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:  mag-
               step''.

     -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:  Exe-
               cutive''.

     -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 conven-
     tion.  When these documents are encountered, the functional-
     ity  of ghostview is limited to giving you scroll bars and a
     next page capability.  Because there is  no  table  of  con-
     tents,  skipping  around  the  document and marking pages is
     impossible.

     If there is no table of contents for the document, the popup
     zoom window 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 ver-
     sion.

     This program is distributed in the hope that it will be use-
     ful, but WITHOUT ANY WARRANTY; without even the implied war-
     ranty of MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR-
     POSE.  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, provided  that  the  above  copyright
     notice  appear  in  all  copies and that both that copyright
     notice and this permission notice appear in supporting docu-
     mentation, and that the name of Software Research Associates
     not be used in advertising or publicity pertaining  to  dis-
     tribution  of  the  software without specific, written prior
     permission.  Software Research Associates makes no represen-
     tations  about the suitability of this software for any pur-
     pose.  It is provided "as is"  without  express  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  WHATSOEVER  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