## NAME

         gray_multiply - multiplies each pixel by a fixed ratio

## SYNOPSIS

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

         Image *gray_multiply(Image *input,float ratio)

          <input> - pointer to an Image
          <ratio> - multiplier

## PATH

         $CVIPHOME/HISTOGRAM/graylevel_mod.c

## DESCRIPTION

         The function gray_multiply multiplies each pixel in an image
         by  a  fixed  value.  The  function  clips to 0 and 255, and
         requires CVIP_BYTE type input.

## TYPES AND CONSTANTS

         None

## RETURN VALUES

         Pointer to an image

## HISTORY

         History information recorded: None
          #include <CVIPtoolkit.h>
          #include <CVIPimage.h>
          #include <CVIPconvert.h>
          #include <CVIPview.h>
          #include "histogram.h"
          #define VIEWER "picture"
          #define VIDEO_APP "SunVideo &"

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

          setDisplay_Image(VIEWER, "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);
          free(inputfile);
          /* the following call multiplies each pixel value by
          a factor of 2.0 with clipping at 255 */
          cvipImage = gray_multiply(cvipImage,2.0);
          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

         libhisto, gray_multiply2

## AUTHOR

         Copyright (C) 1996 SIUE - by Scott E. Umbaugh and Kun Luo.