IMGVIEW(1)							    IMGVIEW(1)

NAME    [Toc]    [Back]

     imgview - displays	image files

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     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.






									Page 1






IMGVIEW(1)							    IMGVIEW(1)



     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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


									PPPPaaaaggggeeee 2222