USAGE: redeye [-k kind] [-l light] [-s sat] [-f fuzz] [-i inc] [-b begin] [-e end] [-d dilate] [-t type] [-r rad] "x1,y1 x2,y2 ..." infile outfile

USAGE: redeye [-k kind] [-l light] [-s sat] [-f fuzz] [-i inc] [-b begin] [-e end] [-d dilate] [-t type] [-r rad] -p point_file infile outfile

USAGE: redeye [-h or -help]

"x1,y1 x2,y2 ..." ... x,y coordinates in image where redeye needs
..................... to be corrected; one or more point pairs
..................... are allowed; atleast one pair must be provided;
..................... list pair list must be specified just prior
..................... to the infile
-p ... point_file ... text file containing list of point pairs;
..................... one x,y pair per line
-k ... kind ......... kind of image to process for redeye region:
..................... 1 is image or 2 is HSB saturation channel;
..................... default=1
-l ... light ........ desired lightness; 0<=integer<=100; default=15
-s ... sat .......... desired saturation; 0<=integer<=100; default=0
-f ... fuzz ......... fuzz value for redeye floodfill; 0<=float<=100;
..................... nominal 15 to 20; default is for automatic
..................... detection of optimal fuzz value
-i ... inc .......... fuzz iteration increment in automatic mode;
..................... 0<integer<100; default=5
-b ... begin ........ fuzz interation begin value in automatic mode;
..................... 0<integer<100; default=10
-e ... end .......... fuzz interation end value in automatic mode;
..................... 0<integer<100; default=50
-d ... dilate ....... dilation amount to increase the size of the
..................... detected redeye areas; integer>=0; default=1
-t ... type ......... type of white specular reflection processing;
..................... choices are: desat or remove; default=desat
-r ... rad .......... radius of white specular reflection region
..................... float>0; default=3

PURPOSE: To remove redeye from an image.

DESCRIPTION: REDEYE removes redeye from an image. It does so by the user specifying coordinates in each redeye area. Processing then floodfills at those coordinates either in the image or the saturation channel to create a mask. The mask is then used with a desaturated version of the image and the original image to modify the color of the redeye areas. The white specular component inside the redeye region may optionally be removed. The user may specify a particular fuzz value to use or let the script attempt to find an optimal value.

ARGUMENTS:

"x1,y1 x2,y2" ... x,y coordinates in the image where redeye needs to be corrected. One or more point pairs are allowed. Atleast one pair must be provided. IMPORTANT: the list of point pairs must be specified just prior to infile.

-f point_file ... point-file is a text file containing the list of point pairs, one x,y pair per line. Atleast one pair must be provided.

-k kind ... KIND of image to process for redeye region. Choices are: 1 for input image or 2 for the HSB saturation channel. The default=1

-l light ... LIGHT is the desired lightness in the redeye area. Values are 0<=integer<=100. The default=15

-s sat ... SAT is the desired saturation in the redeye area. Values are 0<=integer<=100. The default=0

-f fuzz ... FUZZ is the desired fuzz value for the redeye floodfill. Values are in the range of 0<=float<=100 . Nominal values appear to be about 15 to 20 from limited testing. The default is for automatic interative detection of an optimal fuzz value. This usually works reasonably well, but tends to be an under estimate. It seems to work better for the saturation channel than the image, but tends to be more underestimated in the former case. In the latter case, it can overestimates more frequently than in the former case. To correct for understimation either increase the value reported or increase the dilation argument. For overstimation reduce the fuzz value.

-i inc ... INC is the fuzz iteration increment in automatic mode. Values are 0<integer<100. The default=5

-b begin ... BEGIN is the fuzz interation begin value in automatic mode. Values are 0<integer<100. The default=10

-e end ... END is the fuzz interation end value in automatic mode. Values are 0<integer<100. The default=50

-d dilate ... DILATE is the dilation amount to increase the size of the detected redeye areas. Values are integers>=0. The default=1

-t type ... TYPE of white specular reflection processing. The choices are: desat (d) for desaturation or remove (r). The default=desat

-r rad ... RAD is the radius of the white specular reflection region. Values are floats>0. The default=3

REQUIREMENTS: IM 6.5.9-0 in order to support the -morphology methods used in the script. However, due to possible bugs, it may require at least IM 6.5.9-3

CAVEAT: No guarantee that this script will work on all platforms, nor that trapping of inconsistent parameters is complete and foolproof. Use At Your Own Risk.