NAME

     label - labels objects

SYNOPSIS

      #include "CVIPtoolkit.h"
      #include "CVIPobject.h"

     Image * label( const Image *imageP )

      <imageP> - pointer to an Image

PATH

     $CVIPHOME/FEATURE/label.c

DESCRIPTION

     This function calls the function label_Objects (from  libob-
     ject).

TYPES AND CONSTANTS

     None

RETURN VALUES

     A labeled image

HISTORY

     History information recorded: None

EXAMPLE

      #include "CVIPtoolkit.h"
      #include "CVIPobject.h"
      #include "CVIPconvert.h"

      #include <math.h>
      #include "ObjectContour.h"

      void main() {
         Image *inputImage, *labeledImage;
         IMAGE_FORMAT format;
         char *inputfile, *outputfile;
         int rows, cols;
         long lArea;

         setDisplay_Image("picture", "Default");

         print_CVIP("0nter the Input File Name:  ");
         inputfile = (char *) getString_CVIP();
         inputImage = read_Image(inputfile, format, TRUE);
         view_Image(inputImage,inputfile);

         labeledImage = label(inputImage);

         free(inputfile);
       }

SEE ALSO

     libfeature, libobject, setUpLabel_Objects

AUTHOR

     Copyright (C) 1996 SIUE - by Scott E. Umbaugh,  Greg  Hance,
     Kun Luo, and Wenxing Li.