Developed by : Basant Kumar Dwivedi (2000RCS004) and  Anup Gangwar (2000RCS005)
-------------

Requirements : ImageMagick ver 5.2.2 (We are not sure if this would work with 
-------------  later versions). A statically linked binary is provided 
	       (main.static), so, that there is no problem in running the tool.

Options	: Following is the summary of the command line options.
--------  main -q lists all the command line options available.

1. Hough Transform Circle :	-H "c <increment> <threshold> <circles-to-detect>"
   ------------------------

	increment 	- The value of increment (K).
	threshold 	- This values is used after calculating the laplacian 
			  for binary stating the image.
	circles-to-det	- Number of circles to detect. Basically these many accumulator
			  values are considered.

2. Hough Transform Line :       -H "l <increment> <threshold> <lines-to-detect>"
   ----------------------

	increment 	- The value of increment (K).
	threshold 	- This values is used after calculating the laplacian 
			  for binary stating the image.
	lines-to-det	- Number of lines to detect. Basically these many accumulator
			  values are considered.


3. Region Growth :		-R "<threshold> <seed.x>, <seed.y>"
   ---------------

	threshold	- This values is used after calculating the laplacian
        		  for binary stating the image.
	seed.x, seed.y	- The x and y coordinates of seed point.


4. Image Morphing :		-m "<mode> <style> <n_img>" -s <src_image_name> -t <tgt_image_name>	
   ---------------		-S <src_points_file> -T <tgt_points_file> -F <src_tri_file> 
				-a "<sector_size> <distanceTh_morph> <HoughTH> <lines-to-detect>" 	

	mode		- Whether automatic (a) or interactive (i).
	style		- One of points (p) or lines (l).
	n_img		- Number of intermediate images to generate.

	src_pt_file	- File containing the points for source (sample in example dir).
	tgt_pt_file	- File containing the points for target.
	src_tri_name	- File conatining the triangles for source image.
	
	sector_size	- In power of 2.
	distanceTh_morph- Threshold for length of line within sector (around sector size).
	HoughTH		- This values is used after calculating the laplacian 
                          for binary stating the image.
	lines-to-detect - Number of lines to detect. Basically these many accumulator
                          values are considered.
		

		
General Notes :
--------------

	1. In case the code core dumps after compiling with a newer version of the
	   library, please revert back to the static version.

	2. url for assignement is,
		http://www.cse.iitd.ernet.in/~anup/dip/
	
	3. A jar file for selecting the points for interactive image morhping is
	   provided. The syntax to run it is,

		java -jar PointDetect.jar <image-name> <out-file-name>

	4. The DCT program takes these points and converts them to the triangles.

	5. We have used gifsicle for creating animated gifs of the intermediate
	   images.


-----------------------------------------------------------------------------------------------