IMGVIEW(1)                                                          IMGVIEW(1)


NAME
     imgview - displays and enhances image files


SYNOPSIS
     imgview  [-compare] [-noBorders] [-nofork] [-usePopup] [-exitOnError]
              image_file[:index][#format][%format_args] ...


NOTE
     imgview replaces the imgtool imgworks which is no longer available on
     SGI's Onyx4 UltimateVision graphics systems.


DESCRIPTION
     imgview allows multiple image files to be displayed. Only image files
     with formats supported by the Image File Library (IFL) and that are
     installed, can be displayed. Use the imgformats command to determine
     which file formats are currently supported.

     The following command line options are allowed:

     -compare      Tells the tool to display all images on the command line in
                   a single window instead of in separate windows.  The images
                   will be stacked one on top of the other with the last file
                   specified on the command line appearing at the top of the
                   stack.  This mode can be useful when comparing related
                   images of the same size for subtle differences (by wiping
                   an image on top to reveal the image below).

     -noBorders    Suppresses the normal window manager borders. This option
                   implies -usePopup.

     -nofork       Specifies that the application should run in the
                   foreground, when invoked from the shell. The default is to
                   fork and run in the background during startup.  This is
                   only relevant when -gui is specified.

     -usePopup     Tells the tool to use a popup menu instead of the standard
                   menu bar.

     -exitOnError  Tells the tool to exit if an error is encountered opening
                   any of the images supplied as command line arguments.

     In addition the standard X Window command line arguments like -geometry
     and -iconic are recognized.

     The optional index after a file name is useful on multi-resolution images
     like Photo CD, to select the desired sub-image.  You can use imginfo to
     get a complete list of all sub-images for a given file.


     The optional format following a file name can be used to specify a file
     format where it can't be determined from the file's magic (e.g.  an image
     is in raw format). The format_args are format specific.

     When multiple images are specified on the command line they will be
     displayed in separate windows unless -compare is specified.  If an image
     is larger than the window, the center portion of the image will be
     displayed initially. The middle-mouse button is used to roam around the
     full image. In addition, the images can be moved within the window using
     the left-mouse. Various other options are available thru the menus.


EXAMPLES
     To display the highest resolution of a Photo CD image called "janzen.pcd"
     with a 512x512 window type:

               imgview -geometry 512x512 janzen.pcd:5


RESOURCES
     imgview understands the following X resources:

     geometry
          Specifies the preferred size and location of the imgview window.

     compare
     exitOnError
     noBorders
     nofork
     usePopup
          If specified as True then imgview will behave as if the command line
          switch of the same name had been specified.


NOTES
     The supported image file formats depend on which file formats are
     currently installed.  The installed formats can be listed with the
     imgformats(1) command.


SEE ALSO
     imgcopy(1), imginfo(1), imgworks(1), imgformats(1)


                                                                        Page 2