Auto Profile-photo Maker
-------------------------------------------------------------------------------
by Vita Beran, VIDEO@FIT, Brno University of Technology, (c) 2010
-------------------------------------------------------------------------------



Introduction
-------------------------------------------------------------------------------
The Auto Profile-photo Maker is the automatic tool for creating profile photos of people from general large photography. Given a photo with a face of a person, the photo may have various size, position and scale of the person's face, rotation, background, etc. The Auto Profile-photo Maker is designed to create normalized profile photo of the person: rotate to proper vertical face orientation, crop the face, resize to predefined format and optionally frame the photo using given frame pattern.   
The Auto Profile-photo Maker is designed for automatic processing of large amount of data, e.g. internet archives, company information system dealing with employee profiles, etc.  



Description 
-------------------------------------------------------------------------------
The Auto Profile-photo Maker process the face detection Viola-Jones face detector. The oritentation invariance is achieved by processing the face detection on several rotated versions of the input photo. When the face is detected, the photo is croped to contain only the face covering the given amout of the profile photo, e.g. 40% of the photo. 
The color normalization can be achieved by giving the hue value for colorize parameter. Then the photo is 
Finally, the frame is added using the frame mask.  
The profile photo is stored according to given output name or the default name is generated.
           
The tool is based on the open source computer-vision library (OpenCV2.1).                                     



Usage
-------------------------------------------------------------------------------
AutoProfilePhoto -frame filename -mask filename [-dst filename] [-size width height] [-face float] [-colorize hue] [-sharpen] file1 [file2 ...]

        -dst filename           output face photo filename
        -size width height      size of the output photo
        -face float             area covered by face (1.0 - only face; 0.5 - half face, half background; 0.1 - 10% face, rest background)
        -frame filename         filename of the image with the frame
        -mask filename          filename of the image with the frame mask
        -colorize hue           apply colorization effect (hue 1-180, 0 generate grayscaled image)
        -sharpen                apply sharpening
        -help                   print this help        
        
        
When more files are given, the destination filename is omitted and auto-name ("profile.filename") is generated.

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