NAME

     hough_transform,hough_inverse,  hough_filter   -   completes
     lines in a binary image

SYNOPSIS

      #include "CVIPtoolkit.h"
      #include "CVIPdef.h"

     Image *hough_transform(Image* cvipImage,char  *interpret,int
     num)

      <inputImage> - pointer to a binary image
      <interpret> - a string indicating angles of interest
      <num> - length of the interpret string

     Image  *hough_inverse(Image   *cvipImage,int   height,   int
     width,int threshold)

      <cvipImage>   -   pointer   to   an   Image   output   from
     hough_transform
      <height> - height of output image (usually  original  image
     size)
      <width> - width of output  image  (usually  original  image
     size)
      <threshold> - minimum number of pixels to define a line

     char* parse_string(char *input)

      <input> a character to be parsed

     Image  *hough_filter(Image  *cvipImage,  char  *name,   char
     *degree_string,  int threshold, int connection, int interac-
     tive)

      <cvipImage> - pointer to a binary image structure
      <name> - name of the input image
      <degree_string> - a string indicating angles of interest
      <threshold> - minimum number of pixels to define a line
      <connection> - maximum distance to link on a line
      <interactive> - 0 = use above parameters
                      1 = read degree_string, threshold, and
                          connection from standard input

PATH

      $CVIPHOME/SPATIALFILTER/hough.c

DESCRIPTION

     The Hough transform is designed to find or complete lines in
     an image.  It uses an edge-detected image as input and links
     those points that fit user-defined  parameters  of  distance
     and orientation angle.

     For a detailed explanation of the required inputs,  see  the
     header         description        in         the        file
     $CVIPHOME/SPATIALFILTER/hough.c.

TYPES AND CONSTANTS

     None

RETURN VALUES

     A transformed image

HISTORY

     History information recorded: None

BUGS

     None at this time

SEE ALSO

     libspatialfilter, edge_link_filter

AUTHOR

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