## 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.