NAME

     median_filter - a fast median  filter  using  the  histogram
     method.

SYNOPSIS

      #include <CVIPtoolkit.h>
      #include <CVIPdef.h>
      #include <CVIPimage.h>
      #include <CVIPconvert.h>
      #include <CVIPspfltr.h>
      #include <stdio.h>
      #include <math.h>

     cc...<libspatialfilter.a>

     Image *median_filter(Image *inputImage, int size)

      <inputImage> - pointer to an Image
      <size> - mask size (3,5,7,9,...)

PATH

     $CVIPHOME/SPATIALFILTER/median_hist.c

DESCRIPTION

     The function median_filter uses a histogram method  to  per-
     form  a fast median filter on an input image, using a square
     mask of user-determined dimension.  The filter  operates  on
     the  histogram  of the masked area, rather than on the image
     directly.

RETURN VALUES

     The function returns an image that has been median filtered.

HISTORY

     History information recorded: filter window size

EXAMPLE

      #include <CVIPtoolkit.h>
      #include <CVIPdef.h>
      #include <CVIPimage.h>
      #include <CVIPconvert.h>
      #include <CVIPspfltr.h>
      #include <stdio.h>
      #include <math.h>

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

      setDisplay_Image("picture", "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);
      cvipImage = (Image *)median_filter(cvipImage, 3);
      /* example size 3 */
      fflush(stdin);
      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(inputfile);
      free(outputfile);
      }

BUGS

     None at this time

SEE ALSO


AUTHOR

     Copyright (C) 1995 SIUE - by Frank Smith and Scott Umbaugh.