## 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.