NAME

     enlarge - Enlarges an image to a user-defined size

SYNOPSIS

      #include <CVIPimage.h>
      #include <CVIPmatrix.h>
      #include <CVIPgeometry.h>

      Image *enlarge(Image *cvipImage, int row, int col)

      <cvipImage> - pointer to an Image structure
      <row> - number of rows for enlarged image
      <column> - number of columns for enlarged image

PATH

      $CVIPHOME/GEOMETRY/enlarge.c

DESCRIPTION

     Enlarge allows the user to specify the number  of  rows  and
     columns  in the resultant image, corresponding to the height
     and width of the new image. The integers specified  for  row
     and  column sizes must be equal to or greater than the input
     image sizes or an error results.

     Because the user may enter different values for  height  and
     width,  enlarge  may  be  used  to geometrically distort the
     image in a rubber-sheet fashion.

TYPES AND CONSTANTS

     none

RETURN VALUES

     Returns enlarged image upon successful  completion;  returns
     NULL upon error in size specification.

EXAMPLE

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

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

      setDisplay_Image("picture", "Default");

      system("ln      -s       /opt/cvipimages/Gray/cameraman.pgm

     cameraman.pgm");
      print_CVIP("\nPlease enter the image 'cameraman.pgm' at the
     prompt\n\n");
      print_CVIP("Enter the Input File Name:  ");
      inputfile =(char *) getString_CVIP();
      format = getFormat_CVIP(inputfile);
      cvipImage = read_Image(inputfile, 1);
      view_Image(cvipImage, inputfile);
      cvipImage = enlarge(cvipImage, 300,420);
      print_CVIP("Enter the Output File Name:  ");
      outputfile = getString_CVIP();
      view_Image(cvipImage, outputfile);
      write_Image(cvipImage,   outputfile,CVIP_NO,CVIP_NO,format,
     1);
      free(inputfile);
      free(outputfile);
      }

BUGS

     None at this time

SEE ALSO

     none

AUTHOR

     Copyright (C) 1995 SIUE - by Scott Umbaugh and Kun Luo.