NAME

     read_Image - loads an Image structure  with  data  from  the
                    specified image file

SYNOPSIS

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

     Image *read_Image(char *filename, int showmessages)

      <filename> - pointer to an character string containing  the
     file name
      <showmessages> - shall I be verbose?

PATH

     $CVIPHOME/CONVERSION/convert.c

DESCRIPTION

     Loads an Image structure with data from the specified  image
     file  <filename>. All data members of the structure are ini-
     tialized to the specifications of the image file read in.

TYPES AND CONSTANTS


RETURN VALUES

     Pointer to newly allocated Image structure loaded with  data
     from image <filename>

HISTORY

     History information recorded: None

EXAMPLE

      #include <CVIPtoolkit.h>
      #include <CVIPimage.h>
      #include <CVIPdef.h>
      #include <CVIPview.h>
      #include <CVIPconvert.h>
      #define VIEWER "picture"
      #define VIDEO_APP "SunVideo &"

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

      setDisplay_Image(VIEWER, "Default");

      print_CVIP("\n\t\tEnter the  Input File Name:  ");
      inputfile =(char *) getString_CVIP();
      format = getFormat_CVIP(inputfile);
      /* the following call loads an image  structure  with  data
     from
      the specified file */
      cvipImage = read_Image(inputfile,1);
      view_Image(cvipImage, inputfile);
      free(inputfile);
      print_CVIP("\n\t\tEnter the Output File Name:  ");
      outputfile = getString_CVIP();
      view_Image(cvipImage,outputfile);
      /* the following call writes the contents of the CVIP image
      structure out to disk.The format is the same as the
      input file format */
      write_Image(cvipImage,outputfile,CVIP_NO,CVIP_NO,format,1);
      free(outputfile);
      }

SEE ALSO

     libconverter

AUTHOR

     Copyright (C) 1996 SIUE -  by  Scott  E.  Umbaugh  and  Greg
     Hance.