Photo and color adjustments
Adjustmentsadjustments
Filter for adjusting exposure, brightness, contrast, color saturation and gamma.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
brightness | brightness | 0 | -100 | 100 | Brightness: -100 — totally black image, 100 — totally white image, 0 — original brightness |
contrast | contrast | 0 | -100 | 100 | Contrast: -100 — evenly grey image, 100 — binary image, 0 — original contrast |
exposure | exposure | 0 | -20 | 20 | Exposure: -20 — totally black image, 20 — overexposed image, 0 — original exposure |
gamma-correction | gamma | 1 | 0.01 | 10 |
Gamma: 0.01 — underexposed image, 1 — original gamma, 10 — overexposed image |
saturation | saturation | 0 | -100 | 100 | Saturation: -100 — shades of grey, 0 — original saturation, 100 — highly saturated colors |
use hsv color model | use_hsv | False | If the value is true, HSV color model will be used. If the value is false, HSL color model will be used |
You can also adjust opacity for this filter.
Set saturationset_saturation
The chromaticity (color saturation) of each pixel of the picture in percent.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
saturation, % | value | 9 | -100 | 100 | Saturation value in percentage |
HSV Color Model | use_hsv | False | - | - |
If the value is TRUE, HSV color will be used. If the value is FALSE, HSL color model will be used. |
You can also adjust opacity for this filter.
Set Hueset_hue
Tone in terms of the HSV / HSL model (http://en.wikipedia.org/wiki/HSL_and_HSV) of each pixel on the image in degrees.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Color tone, degrees | value | 27 | -180 | 180 | Hue value in degrees |
Set level | set_level | False | - | - | False - the hue value of each pixel will be changed in the following way: the value set by the Color tone parameter will be added to the current pixel hue value. True - the hue value of each pixel is determined by the Color tone parameter. The original hue value is ignored. |
You can also adjust opacity for this filter.
Set Luminosityset_luminosity
The chromaticity of each pixel of the picture in percent.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Luminosity, % | value | 50 | -100 | 100 | Luminosity value in percentage |
HSV Color Model | use_hsv | False | - | - |
If the value is TRUE, HSV color will be used. If the value is FALSE, HSL color model will be used. |
You can also adjust opacity for this filter.
Blurblur
Blur — the image is smoothed by the Barletta window.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Radius | radius | 5 | 0.001 | 100 | Blur kernel radius |
Use percentage | use_percentage _values | false | Use radius in percentage of a larger image dimension instead of pixels. |
You can also adjust opacity for this filter.
Blur advancedblur_advanced
Blur filter with the option to adjust the direction and intensity of the blur.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
blur type | method | Motion blur (horizontal); | - | - | Blur type: Motion blur (blur_motion); Zoom blur (blur_zoom); Spin blur (blur_spin); Horizontal image "stratification" (blur_offset); |
intensity | intensity | 5 | 0 | 100 | Blur Intensity from 0 to 100. |
Shadow highlightshadow_highlight
Shadow/Highlight correction filter (similar to the Photoshop tool of the same name).
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Shadows Brightening Strength | shadow_factor | 3 | 1 | 6 | Shadows correction strength. 1 — delicate shadows brightening, 6 — strong shadows brightening |
Highlights Darkening Strength | highlight_factor | 2 | 1 | 6 | Highlights correction strength. 1 — delicate highlights darkening, 6 — strong highlights darkening |
Shadow Range | shadow_range | 0.4 | 0 | 0.6 | Parameter that determines shadow areas |
Highlight Range | highlight_range | 0.25 | 0 | 0.4 | Parameter that determines highlight areas |
Resamplingresampling
Resampling (downsizing or upsizing images).
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
width | width | 0 | Desired image width | ||
height | height | 0 | Desired image height | ||
Keep Aspect Ratio | preserve_aspect | False | - | - | If the value is true, the Keep Aspect Ratio option is enabled |
Clean Shadows On Maskclean_shadows_on_masks
A filter that brightens dark areas in a photo (increases gamma to medium brightness).
Desaturationdesaturation
A filter that transfers a photo into the B&W mode.
You can also adjust opacity for this filter.
Sepiasepia
A filter that processes a photo with the sepia effect.
You can also adjust opacity for this filter.
Color dominancecolor_dominance
A filter that colors the photo in shades of one given color.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Hue | hue | 4.18879 | 0 | 6.283185307 | A hue that is used to tint a photo. The value lies in the range of 0 to 2*PI. The default value means blue, the value of 0 is red, the value of 3.14 is cyan. |
Hue Value in Degrees | hue_in_degree | 0 | 359 | This parameter is the same as the previous one ("Hue"), but is indicated in degrees. If this parameter is used, then the "hue" parameter will be ignored (to be more exact, it will be recalculated with the following formula: hue = hue_in_degree * PI / 180.0) | |
Fixed Saturation | fixed_saturation | 0 | 0 | 1 | If fixed_saturation=0, saturation of the source image will remain intact (black and white images will remain black and white; color images will be tinted with a selected color.) If 0 < fixed_saturation <= 1, the saturation value of the source image will be multiplied by the fixed_saturation value (the more is this value, the more saturated the result will be). If fixed_saturation=1, both color and black and white images will be tinted with a selected color to the maximum extent possible |
You can also adjust opacity for this filter.
Eyedropper By Mask colors_generate
A filter that searches the color in a specified area and fills the whole frame region with this color. The area of a user photo that is used for color measurement is specified with a mask.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Mask | - | Skin Mask | - | - | The mask, specifying the area to calculate color. Available masks:
|
Color Measurement Method | - | median | - | - | Color Measurement Method:
|
You can also adjust opacity for this filter.
Split toningsplit_toning
Split toning effect (an effect that tints the highlights in an image with one color and the shadows with a different color).
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Desaturate | desaturate | False |
If the value is true, the image will be desaturated before toning. If the value is false, the image will not be desaturated |
||
Balance | balance | 50 | 0 | 100 | Balance between shadows and highlights (dark and light areas). The plurality of pixels, whose brightness level is lower than this value, are considered "shadows". Pixels, whose brightness level is higher than this value, are considered "highlights". |
Shadow Hue | shadow_hue | 0 | 0 | 360 | Desired hue for shadows. The value is given in degrees between 0 and 360 (each degree corresponds to a hue in a color wheel). 0 degrees is red |
Highlight Hue | highlight_hue | 0 | 0 | 360 | Desired hue for highlights. The value is given in degrees between 0 and 360 (each degree corresponds to a hue in a color wheel). 0 degrees is red |
Shadow Saturation | shadow_saturation | 0 | 0 | 100 | Saturation of a hue that is used for shadows toning. The less is the value, the more neutral (desaturated) the hue is. The more is the value, the more saturated is the hue set by the shadow_hue parameter. |
Highlight Saturation | highlight_saturation | 0 | 0 | 100 | Saturation of a hue that is used for highlights toning. The less is the value, the more neutral (desaturated) the hue is. The more is the value, the more saturated is the hue set by the highlight_hue parameter. |
You can also adjust opacity for this filter.
Vintagevintage
The filter mimics the effect of a vintage (aged) photograph. The effect works only with the colors of the photo.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Palette Type | palette_type | BRONZE_SEPIA | BRONZE_SEPIA | DARK_YELLOW_RED | Palette type: BRONZE_SEPIA — Colors become warmer and a bit darker. Green and bronze tones prevail. Some vignetting is added. DREAMY_RETRO — Dreamy retro effect. Warm light colors. Sepia, peach and violet tones prevail. DARK_GOLDEN — Dark golden and green tones prevail. GREENER_DARK_GOLDEN — The tones are even greener than in palette_type=2. The green tones are especially noticeable in shadows. DARK_YELLOW_RED — This pallette type desaturates all colors in an image except for the red and yellow component and makes an image darker |
You can also adjust opacity for this filter.
Color temperaturecolor_temperature
Filter for adjusting thecolor temperature of the image.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Correction Type | correction_type | automatic | - | - | Correction Type: automatic — automatic color temperature correction; preset — correction to a preset temperature value (the Temperature parameter is used); manual — manual correction (Temperature and Tint parameters (for manual correction type) are used). |
Temperature (for preset correction type) | temperature | 5200 | 1000 | - | The light source temperature value in Kelvin degrees used as a preset temperature for editing an image. The higher is the temperature of the light source, the ‘colder’ is the light, and the bluer are the colors of the image. The lower is the temperature of the light source, the more red is the light, and the more red are the colors of the image. |
Temperature (for manual correction type) | temp_value | 0 | -1 | 1 | Image temperature will be adjusted to this temperature value. This parameter is similar to the temperature parameter. The coldest temperature value is -1, the warmest temperature value is 1. |
Tint (for manual correction type) | tint_value | 0 | -1 | 1 | This parameter regulates the tint of the light source color from green (the value is -1) to purple (the value is 1). The parameter is similar to the Tint parameter found in the Basic tab in the Camera Raw module in Adobe Photoshop. |
powbase | powbase | 2 | 2 | - | Strength of the correction. The more is the value, the more noticeable is the correction |
You can also adjust opacity for this filter.
Warmwarm
This filter makes an image 'warmer' or 'colder', depending on the parameter value.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Strength | strength | 2 | 0 | 5 | The parameter sets the intensity of the blue and red components. The value of 1 corresponds to the original image. If the value is less than 1, the image gets bluer. If the value is more than 1, the image is made warmer. |
You can also adjust opacity for this filter.
Gradient mapgradient_map
A "gradient map" links the equivalent range of grayscale images to the colors of a certain gradient fill.
- Active color control points
- Parameters of the selected control point:
- Position, %: (range 0-100) set a position of the selected control point
- Color: Define an RGB color of the selected control point
- Delete the selected control point
- Add new control point
Red On Greyred_on_grey
This filter finds red areas in an image and increases saturation in these areas. All other areas in the image are converted to grayscale.
You can also adjust opacity for this filter.
Color Correction color_correction
This filter performs color correction of an image by a combined application of 'Color Temperature' and 'Shadow/Highlight Correction' methods.
If an original image does not need much color correction, applying this filter will result in only slightly noticeable changes.
You can also adjust opacity for this filter.
High Dynamic Range hdr
HDR (High Dynamic Range) effect.
You can also adjust opacity for this filter.
Color Isolationcolors_isolation
The filter changes the saturation of certain areas in a photo, depending on specified color range.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Use geometry | use_geometry | false | - | - | Try to erase small ‘holes’ in the color map when applying the filter. |
Maximize saturation | max_saturation | false | - | - |
If the parameter value is false, then the color range specified in the ‘Color filter’ parameter is left unchanged. For other colors, the saturation value = 0. If the parameter value is true, then the saturation of colors from the color range specified in the ‘Color filter’ parameter will be set to 100. For other colors, saturation = 0. |
Smooth chroma map | use_blur | false | - | - | Smooth (blur out) the color map when applying the filter. |
Color filter | hsl_filters | - | - | - | A set of color ranges in HSL space. The guidelines on how to work with this parameter can be found below. |
The Color filter parameter can be configured via the Color Isolation Editor dialog.
The editor lets you specify one or several color ranges with the given tone and isolate them.
You can add / delete color ranges in the Colors panel, keeping in mind that they cannot overlap. Border and threshold values can be set in terms of numbers, by entering the desired values in the corresponding fields, as well as with the help of the mouse (to do so, just move the pointers on the scale).
Bound and threshold values on the left and on the right serve to create transitions of saturation from 100 to 0 (on the left) and from 0 to 100 (on the right) in the color range, as follows:
- to the left of the ‘left bound’ saturation=0;
- between the ‘left bound’ and the ‘left threshold’ saturation is increasing slowly;
- between the ‘left threshold’ and the ‘right threshold’ saturation is either left unchanged (if Maximize saturation = 0), or maximized (if Maximize saturation = 1);
- between the ‘right threshold’ and the ‘right bound’ saturation is gradually decreasing to zero;
- to the right of the ‘right bound’ saturation=0.
You can also adjust opacity for this filter.
Automatic Enhancementauto_enhancement
A filter that performs automatic image enhancement. It includes options for shadow/highlight correction, color temperature correction, image sharpening, noise reduction, automatic saturation adjustment, as well as portrait filters.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Automatic saturation adjustment | use_saturation | True | - | - | If the value is true, automatic saturation adjustment algorithm is enabled |
Shadow/Highlight correction | use_shadow_highlight | True | - | - | If the value is true, Shadow/Highlight correction algorithm is enabled. |
Color temperature correction | use_color_temperature | True | - | - | If the value is true, color temperature correction algorithm is enabled. |
Image sharpening | use_deblurring | False | - | - | If the value is true, image sharpening algorithm is enabled. |
Portrait mode | portrait | False | - | - | If the value is true, a special mode for enhancing portrait images is enabled (it includes noise reduction, color correction, as well as an algorithm fixing overexposed areas). |
Noise reduction | use_denoising | False | - | - | If the value is true, noise reduction algorithm is enabled. |
You can also adjust opacity for this filter.
Automatic Saturation auto_saturation
Automatic saturation adjustment.
If an original image does not need saturation adjustment, applying this filter will result in only slightly noticeable changes.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Adjustment strength, % | strength | 50% | 0% | 100% | Saturation correction strength |
You can also adjust opacity for this filter.
HSL Adjustment hsl_adjust
The filter detects the specified color components in an image and increases saturation in these areas. All other color components in the image are converted to grayscale.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Red | red | 30 | -100 | 100 | Saturation of the red component. If the value is 0, saturation of the red component is not changed. If the value is positive, saturation is increased. If the value is negative, saturation is decreased. |
Orange | orange | 0 | -100 | 100 | Works in the same way as the red component. |
Yellow | yellow | -100 | -100 | 100 | Works in the same way as the red component. |
Green | green | -100 | -100 | 100 | Works in the same way as the red component. |
Aqua | aqua | -100 | -100 | 100 | Works in the same way as the red component. |
Blue | blue | -100 | -100 | 100 | Works in the same way as the red component. |
Purple | purple | -100 | -100 | 100 | Works in the same way as the red component. |
Magenta | magenta | -10 | -100 | 100 | Works in the same way as the red component. |
You can also adjust opacity for this filter.
Deblurringdeblurring
Image sharpening.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Adaptive sharpening | adaptive | true | - | - | Adaptive (edge) sharpening. |
Strength | strength | 0.25 | 0 | 1 | Sharpening strength. 0 - minimum intensity, 1 - maximum intensity. |
Suppress halos | suppress_halos | false | - | - | Halo suppression. Increases computation time significantly. |
Advanced | advanced | false | - | - | If the value is true, then Hanning filter will be used. |
Radius | radius | 5 | 1 | 100 | Hann convolution radius. |
You can also adjust opacity for this filter.
Sunlight Effect sunny_colors
This filter increases contrast in an image and makes the colors warmer.
You can also adjust opacity for this filter.
Scribblescribble
A filter creating the effect of a picture drawn by hand in a messy line.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Automatic scaling | autosize | true | - | - | If the value is true, the scale of scribbles will be pretty much the same for all sizes of input photos |
You can also adjust opacity for this filter.
Triangulatetriangulate
A filter that turns a photo into an artwork consisting of colored triangles.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Automatic scaling | autosize | true | - | - | If the value is true, the scale of triangles will be pretty much the same for all sizes of input photos. |
Draw borders | draw_borders | true | - | - | If the value is true, the triangles will have black borders. |
You can also adjust opacity for this filter.
DotsDots
This filter fills a photo with black dots of different sizes on a white background.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Maximum radius | max_radius | 0,6 | 0,01 | 20 | The maximum radius of dots in percentage of the longer side of an image |
Step | step | 0,8 | 0,01 | 20 | The distance between adjacent points in percentage of the longer side of an image |
You can also adjust opacity for this filter.
Blended filterblended_filter
of the desaturation filter,
the value of the opacity
parameter: 204
This filter blends the original image and the image obtained as a result of processing with a specified filter, with the opacitycoefficient.
In the example above the opacity filter is applied together with the Desaturation filter, with the opacity coefficient: 204.
The series of examples makes it clear that the selected filter is applied to the original image first, and then opacity is added to the resulting image. That allows you to blend the result with the source image with the opacity set by the 'opacity' factor.
This filter works together with several filters. In the list of their parameters, there is an additional section containing the opacity filter (see the screenshot below).
To disable the filter, you need to delete the opacity value.
The minimum value of the opacity filter is 1, the maximum value is 255. With the minimum value (1) of the 'opacity' coefficient the applied effect will be almost invisible. With the maximum value (255), only the 'parent' effect (in this case - 'Desaturation') will be visible.
Filter Opacity
Desaturation,
the 'opacity' value parameter: 1
|
Filter Opacity
Desaturation,
the 'opacity' value parameter: 255
|
Parameter | Min value | Max value | Description | |
---|---|---|---|---|
Opacity | opacity | 1 | 255 | Opacity factor |
Opacity can be adjusted for the following filters:
Various Imitations
Channel shiftchannel_shift
The filter performs a shift of the color channels relatively to each other.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Horizontal Offset | horizontal_offset | 2 | - | - | Desired horizontal offset (in pixels or percents). The red channel shifts to the right by the specified number of pixels or percents. The green channel shifts to the left by the same number of pixels or percents. The blue channel is not shifted. If you want to shift the red and green channels to the opposite sides, this value should be negative. When using percents, the allowed values are from -99% to 99%. |
-99% | 99% | ||||
Vertical Offset | vertical_offset | 2 | - | - | Desired vertical offset (in pixels or percents). The red channel shifts upwards by the specified number of pixels or percents. The green channel shifts downwards by the same number of pixels or percents. The blue channel is not shifted. If you want to shift the red and green channels to the opposite sides, this value should be negative. When using percents, the allowed values are from -99% to 99%. |
-99% | 99% | ||||
Use percentage | use_percentage _values | FALSE | - | - | Use offsets in percentage instead of pixels |
Edge detectionedge_detection
A filter that seeks the borders of objects in the image and draws them (black on a white background).
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Strength | strength | 1 | 1 | 20 | Edge strength. The more is this value, the thicker are the edges |
Width | width | 1 | 1 | 5 | Edge width in pixels |
Eroded Edges | eroding | 1 | 0 | 10 | Edge eroding width in pixels |
Blur | use_blur | True | - | - | Blur edges before eroding them (this parameter is valid only if eroding is enabled) |
You can also adjust opacity for this filter.
Neuro-based Edge Detectionedge_detection_gpu
A filter similar to "Edge Detection". It differs from the previous filter in the list of available parameters and the result of processing.
Being used together with a user photo mask, this filter gives interesting results (the example uses default parameters):
User photo region without filters
|
A user photo region with the same image index
size and position, but with the
"Neuro-based Edge Detection" filter applied.
It will be used as a mask for the graphic layer.
|
A graphic layer with a user photo mask
built based on the user photo region
with the "Edge Detection GPU" filter applied
|
The result of processing a user photo
with the template.
|
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Detail | exponent | 2 | 0 | 5 | Specifies the level of detail in the resulting image, where 5 is low level of detail, 0 is high level of detail. |
Dave Hilldave_hill
The filter imitates the style used by the famous photographer Dave Hill
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Radius 1 | radius1 | 4 | 1 | 20 | Blur radius used to calculate high-pass filter. The more is the value, the more pronounced effect this filter will have |
Radius 2 | radius2 | 7 | 1 | 20 | Blur radius to calculate big high pass filter |
Radius 3 | radius3 | 5 | 1 | 20 | Blur radius used to calculate resulting high-pass filter. The more is the value, the more pronounced effect this filter will have |
Alpha Blending | alpha | 40 | 0 | 100 | Alpha-blending coefficient (a photo edited with the Dave Hill filter is blended with a black and white variant of the same photo. 0 corresponds to a photo edited with the Dave Hill filter; 100 corresponds to a black and white image; values between 0 and 100 correspond to in between results) |
Pixelation pixelation
Pixelation effect.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Cell width | cell_width | 4 | 1 | - | Horizontal size of a cell. |
Cell height | cell_height | 4 | 1 | - | Vertical size of a cell. |
Palette size | palette_size | 0 | 0 | - | Сolor palette size (the maximum number of colors in a resulting image). If this value is 0, color quantization is not performed, thus the number of colors is not limited. |
Use percentage | use_percent_values | false | - | - | If the parameter value is true, then width and height values are set in percentage terms. If the parameter value is false, then values are set in pixels. |
Infraredinfrared
This filter imitates infrared camera effect.
You can also adjust opacity for this filter.
Chalk and Charcoal chalk_charcoal
A filter that simulates the effect of drawing with chalk and charcoal.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Chalk coverage area | chalk_area | 6 | 2 | 20 | Defines the area covered with chalk. The more is this value, the larger part of an image is covered with chalk. |
Charcoal coverage area | charcoal_area | 6 | 2 | 20 | Defines the area covered with charcoal. The more is this value, the larger part of an image is covered with charcoal. |
Draw background | draw_background | true | - | - | If the value is true, the image will have an even background. |
Draw sketch | draw_sketch | NO | - | - | If the value is YES, the outlines are traced with a pencil. If the value is NO, the outlines are not traced. |
Pencil Sketch sketch
A filter that imitates drawing with pencil on paper.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Detalization level | details | 0,8 | 0,1 | 1 |
This value is valid only for pencil type SOLID (type=0). Drawing detalization level. The higher is this value, the more pencil lines the sketch will have |
Pencil color | color | Black | - | - |
This value is valid only for pencil type STROKES (type=1). Pencil RGB color. |
Pencil pressure | strength | 0,8 | 0,1 | 1 |
This value is valid only for pencil type SOLID (type=0). Pencil pressure. |
Pencil sketch type | patch_type | BLACK_STROKES_WHITE_BACKGROUND | - | - |
This value is valid only for pencil type STROKES (type=1). Pencil sketch type. BLACK_STROKES_WHITE_BACKGROUND — Black strokes on a white background. BLACK_STROKES_BLURRED_BACKGROUND — Black strokes on a blurred black and white version of the source photo. COLORED_STROKES_BLURRED_COLORED_BACKGROUND — Colored strokes on a blurred source photo. BLACK_STROKES_BLURRED_COLORED_BACKGROUND — Black strokes on a blurred source photo. |
Pencil strokes angle | patch_max_rand_angle | 0 | 0 | 45 |
This value is valid only for pencil type STROKES (type=1). Rotation (clockwise or counter-clockwise) of an each stroke to a random angle. The angle varies from 0 to N degrees (where N = patch_max_rand_angle). |
Pencil strokes flexibility | patch_detail_level | 10 | 1 | 99 |
This value is valid only for pencil type STROKES (type=1). Strokes flexibility. The higher is this value, the more flexible strokes are (therefore, edges look smoother). |
Pencil type | type | SOLID | - | - |
The value determines drawing type. If the value is SOLID (type=0), the pencil traces the outline with a continuous line. If the value is STROKES (type=1), the result image looks as if drawn with pencil strokes. |
You can also adjust opacity for this filter
Light Artistlight_artist
A filter that lets you create different lighting effects in a photo. This effect is achieved by adding various types of light sources with adjustable parameters.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Ambient color | ambient_color | white | - | - | Color of ambient light (the white color with the value of the ambient light intensity equal to 50 preserves the original colors of a photo). |
Ambient light | ambient_intensity | 50 | 0 | 100 | Intensity of ambient light. A value of 50 preserves the original light intensity in a photo. Values above 50 make a photo brighter, while values below 50 make a photo darker. If the value is 0, a photo becomes totally black, if 100 - totally white. |
Landscape | landscape | 50 | 0 | 100 | The "depth" of image texture (embossing height). |
Landscape texture bitmap | landscape_bitmap | - | - | - | This parameter allows to select an image that will be used for building texture mask. You can add an image by selecting Insert > Imagefrom the menu bar in the main window. |
Lights | lights | - | - | - | Opens an editor window letting you add/remove light sources and adjust their lighting, reflection and texture settings. |
Ratio of diffuse and specular reflection | reflect_diffuse_to_mirror_ratio | 50 | 0 | 100 | Ratio between diffuse and specular reflection (0 is only specular reflection, 100 is only diffuse reflection). Valid if there is at least one light source. |
Reflection bitmap | reflect_bitmap | - | - | - | This parameter allows to select an image based on which a mask for light reflection will be built. You can add an image by selecting Insert > Imagefrom the menu. |
You can also adjust opacity for this filter.
Below you can see the light sources editor window. It lets you add / remove light sources and adjust their parameters. Changing a parameter in this editor also changes it in the filter settings dialog and vice versa.
- Ambient light — ranges from 0 to 100. You can choose the color and intensity of ambient light. The white color with the intensity of 50 keeps the original colors of a photo unchanged.
- Reflection (Specular/Diffuse) — ranges from 0 to 100. This box allows you to adjust the mixture between specular and diffuse reflection, as well as select an image to be used as a reflection mask.
- Texture — ranges from 0 to 100. You can adjust the depth of texturing based on the mask from a chosen image.
- Light Sources — this panel lets you configure the parameters of light sources, add new sources or remove existing ones.
- Type — selection of light source type. Each source type has its own adjustable parameters.
- Omni — creates a diffused light source.
-
- Intensity: affects the amount of focused light emitted by the source and ranges from 0 to 100. It can be configured only in the parameters edit panel.
- Height: moves the light source vertically relative to the image plane and ranges from 0 to 300. You can configure this parameter both in the edit panel and by moving the control points.
- X / Y: specifies coordinates of the light source center (in pixels). You can adjust coordinates both in the edit panel and by moving the control points.
- Spot — creates a spot light source.
-
- Intensity: affects the amount of focused light emitted by the source and ranges from 0 to 100. It can be configured only in the parameters edit panel.
- Height: moves the light source vertically relative to the image plane and ranges from 0 to 300. It can be configured only in the parameters edit panel.
- Divergence: determines the maximum light cutoff angle. and ranges from 0 to 89. The value of this parameter is half the angle at the apex of the cone-shaped light flux generated by the source. The parameter can be configured both in the edit panel and by moving the control points.
- Tilt angle: determines the degree of deviation of the light source from the vertical axis and ranges from 0 to 89. You can configure this parameter both in the edit panel and by moving the control points.
- Rotation:rotates the light source around its center point on a certain angle.
- X / Y: specifies coordinates of the light source center (in pixels). You can adjust coordinates both in the edit panel and by moving the control points.
- Parallel — creates a light source emanating from the edge of the image (parallel to the image edge).
-
- Intensity: affects the amount of focused light emitted by the source and ranges from 0 to 100.
- Tilt angle: determines the degree of deviation of the light source from the vertical axis and ranges from 0 to 89. You can configure this parameter both in the edit panel and by moving the control points.
- Rotation:rotates the light source around its center point on a certain angle.
- X / Y: coordinates of the light source center (in pixels).
In fact, coordinate parameters don’t affect anything in this type of light source, as the light comes only from the image edge. The only things that matter are the direction of the ray of light (Rotation) and the distance between the two control points (Tilt Angle). The less is the distance, the more light is emitted.
- List of light sources
-
- Displays all available light sources and allows you to select a specific light source and configure its settings.
- + / - buttons
-
- Let you add or remove light sources.
- Preview areaThe preview area displays all available light sources with the specified parameters.
Each light source, depending on its type, has control points that allow you to visually adjust
and position a specific light source in a user photo region.
- Green dot
- The green dot defines the center of a light source. Moving the center point of a light source in a user photo region will change other parameters in accordance with its new position.
- Red dot
- Defines the tilt angle of a light source and the direction of the light flux relative to its center.
- Blue dot
- Determines the light cutoff angle. The closer this dot is to the center of the light source, the wider the cutoff angle. The dot changes its position only when the white dots (peaks) are moved perpendicular to the direction of the light flux.
To move the light source "as is", without changing its parameters, hold down the Shift key while dragging it.
Facial Treatment
This section describes filters that were created exclusively for facial templates. Additional info on how to insert faces can be found in this section.
Face insertionposition_by_face_points
This filter allows to insert a face into a given image.
The coordinates of the eyes centers and the corners of the lips are used to insert a face into a template. These points are specified by the 'Face Region' smart object. Additional info can be found in this section.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Face Mask | - | none | - | - |
This parameter determines whether to crop
the face using the face mask: - NONE (without crop); - Figure mask; - Face mask; - Skin mask; - Hair Mask; |
More information on parameters that affect face insertion can be found here.
Rasterizationsticker
Rasterization is not a filter in a traditional meaning. In contrast to other filters that somehow change the image to which they were applied, Rasterization allows you to apply stickers to facial pictures and customize their parameters. More information about templates with stickers can be found here.
Emotions TransferEmotions Transfer
A filter that allows you to change facial expressions in faces recognized in user photos with the help of an extensive list of parameters.
To work with this filter, you need the Visual Emotion Editor (FaceTool), which is provided upon request by your team lead.
The visual emotion editor contains an extensive list of options for changing facial expressions. Each of the parameters in the list is responsible for the manifestation of a separate mimic element.
(documentation for the Visual Emotion Editor can be found in the directory where it is installed, in the manual folder).
Important! The path to the folder where the Visual Emotion Editor is installed must consist only of latin symbols. If the path contains any non-latin symbols (cyrillic, hieroglyphs, latin symbols with diacritic marks, etc), or if the path is too long, the tool will not work.
The interface of the Face Tool is only available in Russian.
To transfer the emotion data to the Template Creator you need to:
- Export it as a .txt file using the menu File — Save project as (Файл — Сохранить проект как)
- In the list of parameters of the Emotions Transfer filter, click on the button that appears when the EditableParams property is selected.
- In the opened window of the Emotion Settings Editor, click on the Load button
- In the opened window, go to the directory with the required .txt file and open it.
- Confirm the changes by clicking the OK button in the Emotion Settings Editor.
Items 3 and 4 can be excluded by simply dragging and dropping the required .txt file into the Emotion Settings Editor window.
To make changes in the Emotions Transfer filter in an already prepared template:
- Use the Save file button to upload the .txt file with current parameters.
- Load the file with parameters into the Visual Emotions Editor via the File — Open Project (Файл — Открыть проект) menu.
- Make your changes
- Save the new .txt file and load it back into the Emotions Transfer filter according to the previous instruction.
In this way, creating, editing, exporting and importing .txt files between these tools can be performed in both directions.
Eyes Healing eyes_healing
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Perform eyes whitening | do_eyes_whitening | False | - | - | Whitening of the eye whites. |
Face count | face_to_find_count | 1 | 1 | 5 | The number of faces the eyes_healing filter will be applied to. The minimum threshold is one face. |
Red eye correction strength | correction_re_value | 0.5 | 0.0 | 1.0 | Strength of red eye correction (pupils darkening) in the range from 0 to 1 (fractional values are supported). |
Eyes whitening strength | correction_whitening_value | 0.25 | 0.0 | 1.0 | Strength of eye whites whitening, in the range from 0 to 1 (fractional values are supported). |
Perform red eye correction | do_red_eyes_correction | true | - | - | Red eye correction. If the value is true, the correction algorithm is enabled If the value is false, it is disabled. |
Portrait Filter portrait_filters
Using portrait filters
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Defocus strength | defocus_strength | 0.5 | 0 | 1 | Intensity of blurring the background (in fact, depth of field in respect to a face or any other set area). |
Diffusion strength | diffusion_strength | 0.4 | 0 | 1 | Diffusion strength |
Color correction strength | glamour_strength | 0.2 | 0 | 1 | Color correction strength |
Color Transfercolor_transfer
A filter that allows you to transfer the color and texture of hair and skin from a sample photo to a user photo. The sample photo is set in the PSD file as a layer of Image type.
The filter supports masks based on the following:
- hair,
- skin,
- figure.
Important requirements regarding using the filter:
- A sample photo should contain skin or hair (depending on which object the filter is used for). So, you can only transfer color/texture from hair to hair and from skin to skin. It is not possible to transfer custom texture/pattern/fill.
- A sample photo in the PSD should not contain transparent areas or margins. If the size or proportions of the photo do not match those of the PSD canvas, you should position and crop the photo in such a way so that it occupies the entire canvas or add a non-transparent base layer filled with a color close to the colors of the photo. You can also use the Content-Aware Fill workspace in Photoshop to fill in empty areas. The presence of transparent areas significantly reduces the quality of the filter performance.
- The filter transfers color to the entire photo, while an expected result is obtained only within the specified mask (hair or skin). Outside the mask area, color and texture can be transferred with some artifacts. Thus, it makes sense to apply this filter together with dynamic masks and cut out only the necessary fragments of the result.
Original photo
|
Sample photo
|
Result of processing
with default settings
|
Hair mask
|
Hair mask positioned on top
of the original photo
|
You can also adjust opacity for this filter.
Face Warp face_warp
The Face Warp filter lets you deform any face from a user photo. Unlike the Emotions Transfer filter, it lets you make fine adjustments of facial features that look more natural. Besides, it helps avoid the error with automatic closing of the mouth when changing proportions.
In order to add this filter, you must first add a Face Warp Mesh to your template orientation via the menu Insert and then reparse PSD.
if you try to add theFace Warp filter before adding the Face Warp Mesh layer, you will get the following error:
This will create a new smart object in Photoshop named by default as FWM Face Warp Mesh with the following image:
When the reparsing is done, add the Face Warp filter to the user photo region. The Face Warp mesh will already be selected in the parameters tab.
You can have several Face Warp Meshes with different settings in a single project, however the Face Warp filter can use only one mesh at a time to process an image. In order for the filter to use a certain mesh for processing, select the required mesh in the filter settings and save the changes.
If you develop several orientations, it makes sense to add only one FWM smart object via the insert menu for any orientation, and then duplicate it to other orientations in Photoshop by choosing Layer - New - Layer Via Copy . In this case the content of the smart objects will be synchronized and in order to to change the content in all orientations, it will be enough to edit only one of them.
It is important to remember that choosing New Smart Object Via Copy in the context menu will create an independent copy of the smart object that isn't linked to the original. If you choose this method, you will have to change every FWM smart object in every orientation individually.
In order to start working with deformation you have to open this smart object without assigning it a color profile. You must leave it as is.
Inside the FWM Face Warp Mesh smart object there is a layer with another smart object initial.png , which one is the mesh for face morphing.
What can you do with the initial.png layer:
- bend/stretch (for example, using the Liquify filter, including the Face-Aware Liquify);
- use distortion filters;
- use other types of warping and distortion.
What you cannot do with the initial.png layer:
- change canvas size;
- change color and bit width of the image;
- draw anything on the image;
- change opacity.
What is allowed but not recommended due to unpredictable result:
- allow the image to go outside the canvas bounds;
- cut pieces of the image and copy / move to another place on the canvas;
- warp image too much.
Copying parts of the image | Heavy distortion within the canvas borders | The image went beyond the canvas borders |
---|---|---|
When working with the Face Warp filter you should bear in mind the fact, that beside the warp itself the face warp will add a 1px image shift. This fact is barely noticed in static templates (except when pixel precision is required), but is critical for animated templates, where this pixel shift is evident.
This problem is caused by Photoshop which after saving the mesh adds the mentioned shift and breaks the position.
To solve this problem you should add an empty Face Farp mesh to those frames, where morphing is not needed. This will add the same pixel shift and will compensate the difference. But you should remember that additional filters will increase the time required for processing an image.
Instagram filters
This section describes filters that are very similar to Instagram filters with the same names.
Instagram Amaroamaro
An effect similar to Amaro filter on Instagram.
You can also adjust opacity for this filter.
Instagram Clarendon clarendon
An effect similar to Clarendon filter on Instagram.
You can also adjust opacity for this filter.
Instagram Cube cube
Depending on specified parameters, this effect imitates the following Instagram filters: Aden, Juno, Lark, Ludwig, Slumber.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Effect type | table_name | Aden | - | - |
The filter looks different depending on what value is selected for this parameter. The parameter can take the following values: Aden Juno Lark Ludwig Slumber |
Instagram Ginghamgingham
An effect similar to Gingham filter on Instagram.
You can also adjust opacity for this filter.
Instagram Ginzaginza
An effect similar to Ginza filter on Instagram.
You can also adjust opacity for this filter.
Instagram Helena helena
An effect similar to Helena filter on Instagram.
You can also adjust opacity for this filter.
Instagram Hudsonhudson
An effect similar to Hudson filter on Instagram.
You can also adjust opacity for this filter.
Instagram Kelvin kelvin
An effect similar to Kelvin filter on Instagram.
You can also adjust opacity for this filter.
Instagram Lofilofi
An effect similar to Lofi filter on Instagram.
You can also adjust opacity for this filter.
Instagram Mavenmaven
An effect similar to Maven filter on Instagram.
You can also adjust opacity for this filter.
Instagram Moonmoon
An effect similar to Moon filter on Instagram.
You can also adjust opacity for this filter.
Instagram Nashville nashville
An effect similar to Nashville filter on Instagram.
You can also adjust opacity for this filter.
Instagram Valencia valencia
An effect similar to Valencia filter on Instagram.
You can also adjust opacity for this filter.
Other filters
This section describes filters that are too difficult to distribute to existing categories because of them solving non-standard tasks.
Body detectionbody_detection
The filter is used together with the 'figure' user photo region (more details on figures can be found here). It allows you to detect a human figure in a photo and make the background around it transparent.
Figure Retouchinpaint
This filter allows to fill a detected figure with a generated background (based on the background around the figure). The filter only works with Figure and Frame regions.
Figure Retouch applied to a frame region | Figure Retouch applied to a figure region |
---|---|
Neurofilters
Neurofilter is a special effect applied to the photo region, designed to transform it and make stylistically similar to the subject of painting.
To apply the neurofilter to the selected photo region, you have to open the list of filters for the region and select the "Neurofilter" in it.
Parameter | Default value | Min value | Max value | Description | |
---|---|---|---|---|---|
Neural filter name | - | Abstract Turquoise | - | - | Name of a specific neural filter that will be applied to a photo |
Skin enhancement | - | False | - | - | If enabled, the skin area will be additionally processed to remove the artifacts, produced by neural filter |
Skin enancement opacity | - | 200 | 0 | 255 | Opacity of the skin enhancement effect.
0 – no skin enhancement effect, only the original neural filter is visible 255 - in the skin area, the neural filter is completely replaced by the original color-corrected skin. |
- It is impossible to use neurofilters without Internet connection (even if local processing of test user photos is enabled in the Template Creator).
- Using neurofilter can lead to resize of the original photo if its size exceeds 1080x1080 pixels. If the original photo is larger,
it will be reduced to a size of1080 pixels on the larger side.
Thus we do not recommend to set the size of the photo regions with the applied neurofilter that exceeds 1080px on the larger side.Otherwise, the userphoto may be enlarged automatically and become blurred.
The list of neurofilters is available below: