## NAME

         crop - crops a sub-image

## SYNOPSIS

          #include "CVIPimage.h"
          #include "CVIPgeometry.h"
          #include <stdio.h>

         Image  *crop(Image  *imgP,  unsigned  row_offset,   unsigned
         col_offset, unsigned rows, unsigned cols)

          <imgP> - pointer to an Image structure
          <row_offset> - row coordinate of upper-left corner
          <col_offset> - column coordinate of upper-left corner
          <rows> - height of desired subimage
          <cols> - width of desired subimage

## PATH

         $CVIPHOME/GEOMETRY/crop.c

## DESCRIPTION

         This function allows the user to specify a  subimage  to  be
         cropped  from an input image. The user specifies the row and
         column coordinates of the upper-left corner of  the  desired
         area,  along  with  the  subimage's  width  and height.  The
         passed image is deleted.  The function  works  on  all  data
         types and supports complex images.

## TYPES AND CONSTANTS

         None

## RETURN VALUES

         The desired subimage

## HISTORY

         History information recorded: None

## EXAMPLE

          #include <CVIPtoolkit.h>
          #include <CVIPimage.h>
          #include <CVIPdef.h>
          #include <CVIPgeometry.h>
          #include <CVIPconvert.h>
          #include <CVIPview.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);
          cvipImage = read_Image(inputfile, 1);
          view_Image(cvipImage, inputfile);
          free(inputfile);
          /* the following call selects a subimage of size 10x10 from
         location 10,10 of the original image */
          cvipImage = crop(cvipImage,10,10,10,10);
          print_CVIP("\n\t\tEnter the Output File Name:  ");
          outputfile = getString_CVIP();
          view_Image(cvipImage,outputfile);
          write_Image(cvipImage,outputfile,CVIP_NO,CVIP_NO,format,1);
          free(outputfile);
          }

## SEE ALSO

         libgeometry

## AUTHOR

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