Face retouch

1. red_eyes

Red eye detection and correction (if needed).

Parameters:

Name Type Minimum value Maximum value Default value Description
correction_phase bool TRUE    

This parameter determines whether to fix red eyes that have been found in an image.

can_find_more bool FALSE    

This output parameter indicates if there are more red eyes in an image than have been found yet.

must_find_more bool FALSE    

This parameter enables the search for more red eye candidates.
object_rects rect      

Output parameter: array of rectangles around the detected red eyes.
current_rect_index int -1 -1  

Index number of a rectangle inside which red eye correction should be performed.
If current_rect_index = -1, then all detected red eyes will be corrected.
detection_value float 0.5 0 1

Strength of correction.
0 - maximum redness correction.
1 - minimal redness correction.

correction_value float 0.5 0 1

Strength of pupils darkening.
0 - minimal darkening.
1 - maximum darkening.

eyes_to_find_count int 0 0  

This parameter determines the number of eyes that should be found in an image.

2. portrait_filters

Portrait photos enhancement.

Parameters:

Name Type Minimun value Maximum value Default value Description
defocus_strength float 0.5 0 1

Defocus strength (in fact, depth of field in respect to a face or any other set area).

diffusion_strength float 0.4 0 1

Diffusion strength.

glamour_strength float 0.2 0 1

Color correction strength.
focus_rect rect      

Rectangle area in which the image will remain in focus.
face_detection bool TRUE    

If the value is TRUE, face detection will be used and focusing will be on the face.

3. makeup

Face retouch and makeup.

Parameters:

Name Type Minimun value Maximum value Default value Description
use_auto_red_eye bool TRUE    

The parameter enables automatic red eye correction algorithm ('red_eyes' method is used).

use_skin_healing bool TRUE    

The parameter enables skin improvement algorithm that removes pimples and smoothes minor lines ('skin_healing' method is used).

use_flash_healing bool TRUE    

The parameter enables the algorithm that reduces oily shine ('skin_healing' method is used).

use_wrinkles_healing bool TRUE    

The parameter enables the algorithm that smoothes (horizontal) expression lines ('skin_healing' method is used).
use_portrait_filters bool TRUE    

The parameter enables portrait enhancement filters, such as soft focus, soft contrast and tan effect ('portrait_filters' method is used).
use_eyes_enhancement bool TRUE    

The parameter determines whether to sharpen the eyes.
use_teeth_whitening bool TRUE    

The parameter enables teeth whitening algorithm.
multiple_faces bool TRUE    

The parameter enables multiple faces enhancement (if the value is FALSE, only one face will be processed).
use_skin_color_corrector bool FALSE    

Image color correction with reference to the face area.

4. eye_whitening

Whitening of the eye whites.

5. skin_healing

Skin improvement filter (for portrait photos).

Parameters:

Name Type Minimun value Maximum value Default value Description
skin_smoothing bool TRUE    

If the value is TRUE, skin smoothing will be performed.

pimples_healing bool TRUE    

If the value is TRUE, pimples will be removed.

wrinkles_healing bool FALSE    

If the value is TRUE, wrinkles will be smoothed.
flash_healing bool TRUE    

If the value is TRUE, skin shine will be reduced.