NAME

     h_image - create a mask image according to the size and type

SYNOPSIS

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

     Image *h_image(int type, unsigned int height,  unsigned  int
     width)

      <type>   - mask type: 1-Constant
                            2-Center weighted
                            3-Gaussian
      <height> - height of the mask image
      <width>  - width of the mask image

PATH

     $CVIPHOME/XFORMFILTER/h_image.c

DESCRIPTION

     Creates a single band mask image of size (width x height). A
     constant  mask image has all the pixel values as 1; a center
     weighted mask image is  the same as a  constant  mask  image
     except  the  central value is (width x height); the Gaussian
     mask is normalized to (width x height) at the central value.
     The return Image data type is CVIP_FLOAT.

TYPES AND CONSTANTS

     None

RETURN VALUES

     Pointer to a CVIP_FLOAT real image

HISTORY

     History information recorded: None

EXAMPLE

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

      void main()
      {
      Image *cvipImage;
      IMAGE_FORMAT format;
      char *inputfile,*outputfile;
      (void) setDisplay_Image(VIEWER,"default");
      /* the following call creates a gaussian mask of size 3 */
      cvipImage=h_image(3,3,3);
      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

     libxformfilter

AUTHOR

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