readme.txt

this is image segmentation code

*** 
** Assumes that the image is in PPM format
***

The code is written partly in C and partly in Matlab. The C code contains
the graph cut algorithm provided by Vladimir Kolmogorov (plus a small wrapper
over it to perform segmentation). The executable 'segment' is the graph cut 
algorithm. The graph cut algorithm's code is in the directory "forward_star"
(wrapper is called Segment.cpp).

In Matlab:
The usage is as follows : SegmentVideo(list_of_files) where
list_of_files : file containing the names of all the images that need to be
segmented, one filename per line. 
The function for the pushbuttons is as follows.

B.Box : Draw the bounding box surrounding the rectangle defined by the two
points which are selected by the user by clicking on the left image.

Object: Marks the rectangle defined by the two points selected by the user as
object seed pixels.

Background: Marks the rectangle defined by the two points selected by the user
as background seed pixels.

Segment: Segments 10 frames at a time i.e. the current frame and 9 previous
frames (or how many ever are available in case the current frame number
is less than 10) using the seed pixels given by the user.

Reset: Removes all the rectangles marked by the user as background/object.

Remove: Removes all the rectangles which contain the two points selected by
the user by clicking on the left image.

The various parameters should be easy to find in 'forward_star/Segment.cpp'.