## NAME

         view_Image - choose the appropriate viewer and  displays  an
         image

## SYNOPSIS

          #include "CVIPtoolkit.h"
          #include "CVIPview.h"

          void view_Image( Image *inputImage, char *imagename)
          <inputImage> - pointer to the input Image structure
          <imagename> - character string as the image name

## PATH

         $CVIPHOME/DISPLAY/view.c

## DESCRIPTION

         The view_Image function is a dispatcher of  display_Image(3)
         and  display_RAMImage(3) functions. If the current viewer is
         RamViewer,   the   image    is    displayed    by    calling
         display_RAMImage(3);  otherwise,  it writes the image to the
         disk, and calls display_Image(3). When writing to the  disk,
         it  uses  the  $HOME/.cvip_temp  directory. When used within
         cvipwish/tcl, the temporary images will be removed upon nor-
         mal  termination  of  the program; when used in CVIPlab, the
         temporary images won't be removed automatically, so the user
         is  responsible  to  remove the temporary files on the disk.
         This function WON'T destroy the input Image structure, i.e.,
         it is not necessary to duplicate the image structure.

## TYPES AND CONSTANTS

         NONE

## RETURN VALUES

         NONE

## HISTORY

         History information recorded: None

## EXAMPLE

          #include <CVIPtoolkit.h>
          #include <CVIPimage.h>
          #include <CVIPconvert.h>
          #include <CVIPview.h>

          void main()
          {
          Image *cvipImage;
          IMAGE_FORMAT format;
          char *inputfile;

          print_CVIP("\n\t\tEnter the Input File Name:  ");
          inputfile =(char *) getString_CVIP();
          format = getFormat_CVIP(inputfile);
          cvipImage = read_Image(inputfile, 1);

          /* We don't copy the Image structure.
             Stick to this function, it is nice and easy.
           */

          setDisplay_Image("picture", "Default");
          view_Image(cvipImage, inputfile);
          free(inputfile);
          }

## SEE ALSO

         libgui, display_Image,  display_RAMImage,  getDisplay_Image,
         setDisplay_Image

## AUTHOR

         Copyright (C) 1996 SIUE - by Scott E. Umbaugh  and  Yansheng
         Wei.