Editing

1. color_temperature

Color temperature correction filter. Three correction modes are available:
1) automatic correction;
2) correction to a preset temperature value;
4) manual correction.

Parameters:

Name Type Minimum value Maximum value Default value Description
correction_type integer 1 1 4

Correction mode:
1) automatic color temperature correction (cold, neutral and warm parameter values are used);
2) correction to a preset temperature value (the temperature parameter is used);
4) manual correction (TempValue and TintValue parameters are used).
cold float 6000 1000  

Cold temperature value used in automatic correction mode (correction_type=1)
neutral float 5200 1000  

Neutral temperature value used in automatic correction mode (correction_type=1)
warm float 4400 1000  

Warm temperature value used in automatic correction mode (correction_type=1)
temperature float 5200 1000  

Preset temperature value used in correction_type=2
temp_value float 0 -1 1

Adjusting color gamma (for manual correction mode - correction_type=4): temp_value regulates cool tones in an image, tint_value regulates warm tones.

tint_value float 0 -1 1
powbase float 2 2  

Strength of correction. The more is the value, the more correction will be applied.

2. shadow_highlight

Shadow/higlight method (similar to Photoshop one).

Parameters:

Name Type Minimun value Maximum value Default value Description
shadow_factor float 3 1 6

Strength of shadows correction.
1 - delicate shadows brightening.
6 - strong shadows brightening.

highlight_factor float 2 1 6

Strength of highlights correction.
1 - delicate highlights darkening.
6 - strong highlights darkening.

shadow_range float 0.4 0 0.6

Parameter determining shadow areas.
highlight_range float 0.25 0 0.4

Parameter determining highlight areas.

kradius float 100 1  

Blur radius.
multiscale bool TRUE    

If the value is TRUE, three different radii are used.

autocontrast_enable bool TRUE    

If the value is TRUE, automatic contrast correction is enabled.

3. denoising

Luminance and color denoising.

Parameters:

Name Type Minimun value Maximum value Default value Description
intensity_strength float 0 -4 4

Luminance noise suppression intensity (in fact - strength of blurring).
-4 - minimum intensity,
+4 - maximum intensity.

use_color_denoising bool TRUE    

Enabling the color denoising mode.

color_strength float 0 -4 4

Color noise suppression intensity.
-4 - minimum intensity,
+4 - maximum intensity.

crispness float 0.4 0 1

Percentage of blending of the original image with the processed one.

quality int 1 1 4

Quality of image processing.
use_deblurring bool FALSE    

If the value is TRUE, then deblurring filter (Hanning filter) will be applied to the image before main processing.

deblurring_radius int 4 1  

Deblurring radius.

deblurring_strength float 0.2 0 1

Deblurring strength.

4. deblurring

Deblurring (sharpening) of an image.

Parameters:

Name Type Minimum value Maximum value Default value Description
strength float 0.25 0 1

Sharpening intensity.
0 - minimum intensity,
1 - maximum intensity.

radius int 5 1 100

Convolution radius (Hann convolution is used).

advanced bool FALSE    

Deblurring mode. If advanced = TRUE, then Hanning filter will be used.

suppress_halos bool FALSE    

Halo suppression.
adaptive bool TRUE    

Enabling of adaptive sharpening.

5. rotation

Rotation of an image to an arbitrary angle.

Parameters:

Name Type Minimum value Maximum value Default value Description
angle float 90 0 360

Rotation angle (in degrees).

6. resampling

Resampling (downsizing or upsizing images).

Parameters:

Name Type Minimum value Maximum value Default value Description
method int 2 1 6

Resampling method:
1 - Nearest,
2 - Bilinear,
3 - Bicubic,
4 - Lancoz3,
5 - Lancoz5,
6 - Stair.

width int 0    

Desired width and height of an image.

height int 0    
preserve_aspect bool FALSE    

If the value is TRUE, constrain proportions option is enabled.

enhance bool TRUE    

Enabling the enhance resampling mode.

enhance_factor float 0.26    

Enhancement coefficient (in enhance mode).

7. write_text

Placing text on an image.

Parameters:

Name Type Minimum value Maximum value Default value Description
tl float      

Text positions (coordinate values from 0 to 1).

tr float      
bl float      
br float      
mid float      
red int 0 0 255

Text color.

green int 0 0 255
blue int 0 0 255
letters_limit int      

Maximum number of characters in a text.

format int DT_CENTER|DT_VCENTER    

Text align parameters. DT_XXXXXXX constants are described in the WinUser.h system header file.

effect string NULL    

Noise effects applied to text:
noise1.jpg
text_noise1.jpg
text_noise4.jpg
noise0.jpg
noise_hifreq.jpg
text_noise2.jpg
noise0_edge5.jpg
text_noise0.jpg
text_noise3.jpg

text string NULL    

Text that should be placed on the image.

font font      

A font from the list of available fonts:
DS Eraser2
HansHand
KursivC
Lazy Crazy
Monotype Corsiva
Segoe Script
Segoe Print
Segoe UI
Arial
Arial Black
Calibri
Calibri Bold
Comic Sans MS
Cambria
Cambria Bold
Tahoma
Times New Roman
Verdana
Gabriola
Impact
Stylo
a_AssuanTitulStrDst
Lobster
PopularScript
Arthur Gothic
Blood Cyrillic
Grunge
Calibri Light
Candara
Constantia
Corbel
Courier New
Franklin Gothic Medium
Georgia
Lucida Console
Lucida Sans Unicode
Palatino Linotype
Trebuchet MS
Birch
Anonymous Pro

8. crop

Image cropping.

Parameters:

Name Type Minimum value Maximum value Default value Description
rect rect      

Coordinate values of the crop rectangle in pixels. The crop rectangle can exceed the bounds of the source image; in this case the extended area will be filled with a color.

rectf float rect      

Proportional coordinate values of the crop rectangle in respect to the original image (from 0 to 1).

9. auto_enhancement

Automatic image enhancement. Includes the options described below.

Parameters:

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

The parameter enables red eye correction algorithm.

use_shadow_highlight bool TRUE    

The parameter enables shadow-highlight correction algorithm.

use_color_temperature bool TRUE    

The parameter enables color temperature correction algorithm.

use_saturation bool TRUE    

The parameter enables saturation correction algorithm.

use_denoising bool TRUE    

The parameter enables noise reduction algorithm.

use_deblurring bool TRUE    

The parameter enables sharpening algorithm.

portrait bool FALSE    

The parameter enables 'portrait-friendly' enhancement mode (includes denoising, color correction and shadow-highlights adjustment).

10. blur

Blurring images (Bartlett window is used).

Parameters:

Name Type Minimum value Maximum value Default value Description
radius int 5 1 100

Blur radius.

11. auto_saturation

Automatic saturation adjustment.

12. color_transfer

Filling' an image with a color specified in the 'transfer_color' parameter (the image does not turn into monochrome: opposite colors are constrained).

Parameters:

Name Type Minimum value Maximum value Default value Description
transfer_color RGB      

The color an image should be filled with.

13. adjustments

Adjustment of image exposure, brightness, contrast, saturation and gamma.

Parameters:

Name Type Minimum value Maximum value Default value Description
exposure float 0 -20 20

Exposure:
[-20, 20], -20 - totally black image,
20 - overexposed image,
0 - original exposure

brightness float 0 -100 100

Brightness:
[-100,100], -100 - totally black image,
100 - totally white image,
0 - original brightness.

contrast float 0 -100 100

Contrast:
[-100,100], -100 - evenly grey image,
100 - binary image,
0 - original contrast.

saturation float 0 -100 100

Saturation:
[-100,100], -100 - shades of grey,
0 - original saturation,
100 - highly saturated colors.

gamma float 1 0.01 10

gamma:
[-100,100], 0.01 - underexposed image,
1 - original gamma,
10 - overexposed image.

use_hsv bool FALSE    

If the value is TRUE, HSV color model will be used. If the value is FALSE, HSL color model will be used.

14. warm

Makes image colors warmer or cooler.

Parameters:

Name Type Minimum value Maximum value Default value Description
strength float 2 0 5

The parameter sets the intensity of the blue and red components. The value of 1 corresponds to the original intensity.

15. color_correction

Performs color correction of an image by a combined application of 'color_temperature' and 'shadow_highlight' methods.