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.