## NAME

         create_black - creates a black PGM image

## SYNOPSIS

          #include "CVIPtoolkit.h"
          #include "CVIPdef.h"
          #include "CVIPimage.h"
          #include "CVIPdrawimg.h"

         Image *create_black(int width, int height)

          <width> - desired image width
          <height> - desired image height

## PATH

         $CVIPHOME/GEOMETRY/create_image.c

## DESCRIPTION

         Creates a black PGM image of size height by width. Used as a
         background image for certain geometric functions.

## TYPES AND CONSTANTS

         None

## RETURN VALUES

         Pointer to an image

## HISTORY

         History information recorded: None

## EXAMPLE

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

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

          setDisplay_Image(VIEWER, "Default")
          /* the following call creates a black image of size
           100 x 100 */

          cvipImage = create_black(100,100);
          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

          libgeometry

## AUTHOR

          Copyright (C) 1996 SIUE - by Scott E. Umbaugh  and  Jianxin
         Tan.