NAME

     view_CVIP - CVIPtools command to view a desired  image,  its
     histogram, or other data

SYNOPSIS

     view #  [r,R,g,G,b,B,h,l] [l]
     or
     view <imagename>  [r,R,g,G,b,B,h,l] [l]

      # - the image queue number of the item to view
      or
      <imagename> - the filename as it appears in the image queue

      [r,R,g,G,b,B] - the red(r or R), green(g or G),  or  blue(b
     or B) band of an rgb image

      [h] - to view the histogram of the image,  where  appropri-
     ate. The histogram will be displayed with the same number of
     bands as has the image.

      [l] - to view a log-remapped version of a  non-byte  image.
     The  "l"  option may be specified as a third parameter after
     r, R, g, G, b, or B, where appropriate. Note: this parameter
     is the letter 'L', not the numeral '1'.

OPTIONS

     As shown in SYNOPSIS

DESCRIPTION

     View is the command used by CVIPtools to display an image or
     image  information present in the image queue. A full image,
     a single band from a multiband image, or a  histogram  of  a
     byte-type image can be displayed, as can a log-remapped ver-
     sion of a non-byte type image, such as the results of an FFT
     operation.   The  command is invoked with at least the image
     queue number as a parameter, and  may  include  as  many  as
     three parameters in some cases.

     The  view  command  uses  the   currently-selected   display
     software  to  present the image; the display software can be
     determined or changed under  CVIPtools  Environment  Options
     from the top-level menu.

EXAMPLES

     To view an image that is present in the image queue, enter:

                                view #
                                  or
                           view <imagename>

     Further examples will show only the  'view  #'  format,  but
     'view <imagename>' will work as well.
     To view the blue plane of a color image, enter:

                               view # b

     To view a log-remapped version of a non-byte image:

                               view # l

     To view a log-remapped version of one band of a color image:

                              view # g l

FILES

     builtin.c, image_queue.c

DIAGNOSTICS

     "view: an image must be in the queue and  active  before  it
     can  be  viewed.  Try  open <filename> if the file is in the
     pwd."  if you attempt to view an image that is not loaded in
     the queue.

     "Inappropriate option for the  image"   if  you  attempt  to
     display the histogram of a non-byte-type image.

     "Inappropriate option for the  image"   if  you  attempt  to
     display a log-remapped spectrum of a byte-type image.

BUGS

     None at this time

SEE ALSO

     load(1), pq(1)

AUTHOR

     Copyright (C) 1995 SIUE - by Scott Umbaugh and Mark Zuke.