1. slideshow

Generating different types of animated slideshows (generating a slideshow can take a while).

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 9 0 9

Slideshow type:
= 0 - simple slideshow (shuffling pictures),
= 1 - square transition effect,
= 2 - invalid type,
= 3 - cube effect (images are placed on the faces of a rotating cube),
= 4 - noise diffusion slideshow,
= 5 - transition with random lines,
= 6 - rays transition slideshow,
= 7 - polaroid effect slideshow,
= 8 - flashing slideshow (flash of light between slides),
= 9 - 'vertical shutters' transition slideshow.

2. animated_effect

Various animations for the http://avatar.pho.to/ service.

Parameters:

Name Type Minimum value Maximum value Default value Description
template_name text NULL    

Animation template name (see all templates at http://avatar.pho.to/ service).

static bool FALSE    

If this value is TRUE, a static image will be generated instead of an animated one.

3. animated_filter

Fading effect animation (fading from a source image to the same image edited with a static effect/filter).

Parameters:

Name Type Minimum value Maximum value Default value Description
filter text NULL    

Name of a static filter used to edit a photo (it will later be used to create a fading animation as described above).

4. animated_caricature

Fading effect animation (fading from a source image to the same image edited with a static effect/filter).

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 0 -1  

Morphing type:
-1 - no morphing,
0 - random morphing (it is pseudo-random, in fact, because 'randomness' is determined by the random_seed number),
1 - smile,
2 - sad,
3 - surprised,
4 - squint eyed,
5 - troll,
6 - wink,
7 - flirt (smile, one eyebrow is raised),
8 - offended,
9 - Alien (narrow chin, wide set eyes),
10 - Martian (alien with small nose and huge eyes),
11 - bulb head (narow chin, wide forehead, big eyes),
12 - tough guy (big jaw, bulbous nose, one eyebrow is raised),
13 - grotesque,
14 - fat-cheeked.

random_seed int      

Number that determines the pseudo-random morphing type for type=0.
All pseudo-random emotions can only change the mouth and the eyes area.
They might not be found in the usual list of morphing types.
The main advantage of pseudorandomness is that when sending the same request, the result is sure to be the same.
This makes it possible to make repeated requests or make minor changes to requests (e.g. adding parameters like cartoon or crop_portrait), without changing emotion type.
The same random_seed number always results in the same emotion type.
If you want to apply different 'random' emotion types to the same face, you should send requests with different random_seed values.

strength float -1 -1 1

This parameter is available only for type = 1 and 2.
If this value is -1, the emotion can be described as normal / moderate.
If the value is 1, the emotion is exaggerated.
If the value is 0, no emotion at all is applied.
If the value is a number between 0 and 1 - middle state between no emotion and an exaggerated emotion.

crop_portrait bool FALSE    

If the value is true, a photo is cropped to contain only the face area. Only one face (the first face found by the algorithm) is cropped from any photo.

cartoon bool FALSE    

If the value is true, the resulting image is edited with the cartoon filter (see cartoon).

5. animated_eyes

Adding animated sprites to eyes.

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 0 0 5

type:
= 0 - fire burning in eyes,
= 1 - sparkling stars in eyes,
= 2 - dollar eyes,
= 3 - beating hearts in eyes,
= 4 - monster eyes,
= 5 - crazy rolling eyes.

6. animated_fire

This filter adds fire effect to a photo (makes an image look like it is made of fire flames). The filter also has an animated version, see < name >.

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 1 0 1

If the value is 0, fire lines are added right to the given image, following object edges.
If the value is 1, fire lines are added to a predefined background.

7. animated_matrix

Animated matrix effect (inspired by The Matrix movie). The filter also has a static version, see 'matrix' method.

Parameters:

Name Type Minimum value Maximum value Default value Description
symbol_type int 1 0 2

The type of symbols in the matrix.
0 - squares;
1 - numbers (0 and 1);
2 - hieroglyphs.

symbol_size int 0 0  

This value determines symbols size.
If the value is 0, symbol size is determined automatically.
If the value is other than 0, symbol size is fixed and is determined by this value.

columns_number int 0 0  

This value determines the number of symbols in a line.
If the value is 0, the number of symbols is determined automatically.
(If the symbol_size value is specified, the columns_number value is ignored).

8. animated_sniper_aim

Animated sniper aim effect.

9. animated_painting

Animation: sketch (or blurred image) gradually turning to original photo.

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 0 0 1

type = 0 - sketch gradually turning to original photo,
type = 1 - blurred image gradually turning to original image.

10. animated_kaleidoscope

Kaleidoscope animation.

11. animated_magnifier

Animation: moving a magnifier above an image.

12. animated_water_reflection

Animated water reflection effect.

13. animated_particles

Adding animated particles to an image.

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 0 0 3

Particles type:
0 - rain effect + reflection in water,
1 - snow effect,
2 - soap bubbles moving horizontally,
3 - soap bubbles moving vertically.

14. animated_blinking

Blinking animation: an image blinks, gradually changing its hue or gamma.

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 0 0 1

Blinking type:
0 - rainbow colors animation (an image gradually changes its hue),
1 - an image gradually changes its gamma (brightness).

15. animated_puzzle

Animated puzzle effect (an image turns into a puzzle).

16. animated_head

Adding animated sprites to face pictures.

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 0 0 1

Animation type:
0 - human turns into a terminator,
1 - X-ray effect.

17. animated_camera

Animation effects for face pictures.

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 0 0 2

Animation type:
0 - scary effect (an image twiches suddenly and turns from positive to negative and vice versa),
1 - an image zooms in, and the eyes sparkle,
2 - fractal effect: moving towards the person's eye.

18. animated_text

Applying animated text to an image.

Parameters:

Name Type Minimum value Maximum value Default value Description
text text null    

Text to be applied.

red int 0 0 255

Font color, if custom_font=0.

green int 0 0 255
blue int 0 0 255
font text Arial    

System font name, if custom_font=0 (the specified font must be registered in the operating system).

size int 30 1 100

Font size.

custom_font int 1 0 1

0 - system text (font specified in the 'font' parameter is used).
1 - drawn animated text

position int 2 1 9

Position of text in an image:
1 - text is placed at the bottom,
4 - text is placed vertically on the left side,
6 - text is placed vertically on the right side,
7 - text is placed on top.

animation_type int 0 0 2

Animation type:
0 - simple animated text,
1 - gradually appearing text (changes opacity),
2 - text appearing letter by letter

static bool FALSE    

 

19. animated_deformation

Animated version of 'deformation' method.

20. animated_radar

Radar animated effect.

21. animated_lights

Disco lights animated effect.

22. animated_plastic

Disco lights animated effect.

23. animated_negative

Yin_Yang animated effect.

24. animated_crazy_eyes

Crazy eyes animated effect.

25. animated_hearts

Burst of hearts animated effect.

26. animated_hill_of_ashes

Hill of ashes animated effect (an image turns into a hill of ashes).

27. animated_sparkles

Hill of ashes animated effect (an image turns into a hill of ashes).

Parameters:

Name Type Minimum value Maximum value Default value Description
type int 0 1 1

Sparkles type. If the value is 0, a few big sparkles are added (see http://avatar.pho.to/large_sparkles/).
If the value is 1, lots of small sparkles are added (see http://avatar.pho.to/small_sparkles/).

28. animated_waterflow

Animated version of 'underwater' effect.