1
2
3# URL of the picture/animation to overlay on the face; currently only supports
4# absolute local path
5string media_url
6
7# duration, in seconds, of the overlay visibility
8# - if the duration is larger than the duration of the animation, the animation
9# will loop.
10# - a duration of 0 means 'forever'. In this case, the action *will never
11# complete* on its own. Cancelling the action will remove the overlay from the
12# face.
13float32 duration
14
15
16###############################################
17## LAYER
18
19# display the image in the background (the eye's iris/pupil will be drawn on
20# top of the overlay
21uint8 BACKGROUND=0
22# display the image on top of the eye (the eye's iris/pupil will be occluded by
23# the image, except where transparent)
24uint8 FOREGROUND=1
25
26# one of BACKGROUND or FOREGROUND
27uint8 layer
28
29###############################################
30## LAYOUT
31
32# extend the provided image to cover both eyes.
33# Note: this typically is the only sensible option for robot with a single face panel
34uint8 EXTEND=0
35# on robots with 2 panels (one per eye), copy the provided image onto each eye
36uint8 COPY=1
37# on robots with 2 panels (one per eye), mirror the provided image onto each eyes (symmetry over the vertical axis)
38uint8 MIRROR=2
39# on robots with 2 panels (one per eye), only display the image on the left eye
40uint8 LEFT_EYE_ONLY=3
41# on robots with 2 panels (one per eye), only display the image on the right eye
42uint8 RIGHT_EYE_ONLY=4
43
44# one of the layout constant defined above
45uint8 layout
46
47
48# scale of the image: 1.0 (default) means full width of the face/eye (depending
49# on the chosen layout); 0.1 means 10% of the width.
50# Note that any value <= 0.0 is ignored (replaced by 1.0)
51float32 scale
52
53# position offset, expressed as a proportion of the face or eye's width/height. Values
54# in [-1.0, 1.0] range.
55#
56# (0.0, 0.0) means that the image is centered with the face/eye
57# (-1.0, 1.0) means that the image's center would be located in the top left
58# corner of the face/eye panel.
59float32 offset_x
60float32 offset_y
61
62###############################################
63## EFFECTS
64
65# if true, the overlay will fade in/fade out
66bool fade
67
68---
69---
70