## NAME

         lum_average - creates a grayscale from a multiband image

## SYNOPSIS

          #include "CVIPimage.h"
          #include "CVIPcolor.h"

         Image * lum_average(Image * input_Image)

          <input_Image> - pointer to an Image structure

## PATH

         $CVIPHOME/COLOR/lum_average.c

## DESCRIPTION

         Performs a luminance transform according to the formula
                    P = (band_1 + band_2 + ... + band_n)/n

## TYPES AND CONSTANTS

         None

## RETURN VALUES

         Pointer to a transformed image

## HISTORY

         History information recorded: None

## EXAMPLE

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

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

          setDisplay_Image(VIEWER, "Default");
          /* The input image should be a COLOR one */
          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 creates a gray scale from a
          multiband image */
          cvipImage=lum_average(cvipImage);
          print_CVIP("\n\t\tEnter the Output File Name:  ");
          outputfile = getString_CVIP();
          view_Image(cvipImage,outputfile);
          write_Image(cvipImage,outputfile,CVIP_NO,CVIP_NO,VIP,1);
          free(outputfile);
          }

## SEE ALSO

         libcolor

## AUTHOR

         Copyright (C) 1996 SIUE - by Scott E.  Umbaugh  and  Wenxing
         Li.