Code/Animation relationships

To know how to mange an animation from you code, see: Animation and Animate references pages.

More specifically, to:

If you want your tablet to do some work while your robot is processing an animation, you can define labels through the Label interface.

Label interface

You can create Labels in the Labels view, each label defines the task to be done in the tablet.

A sequence diagram of a Label interface would look something like this.

https://developer.softbankrobotics.com/sites/default/files/repository/60_rst_pepper/public/source/_build/html/_images/6.1.image1_event_layer.png

By using Labels, you can add operations that will be carried out in the tablet side while playing your animation.

For further details, see How to know when a label is reached.

Labels view

Labels view allows to add labels.

Attached to a Frame, a Label triggers a callback event.

https://developer.softbankrobotics.com/sites/default/files/repository/60_rst_pepper/public/source/_build/html/_images/labels_view.png

Creating labels

The Label layers you define are saved in the animation file. In Label interface, you can place your labels in the appropriate animation frame when your label callback should be run. The actual task that is run should be defined in your Android source code.

To add a label, follow these steps.

Step Action
Open an animation file.
Display the Labels view.

Click the Add group button.

Optionally, click the default name and rename it.

Creating several named groups allows you to organise several categories of labels but it is not mandatory nor impacting your code: the label name only will be used.

On the timeline, right-click a Frame and choose Add a label in the contextual menu.

Click the name and rename it.

https://developer.softbankrobotics.com/sites/default/files/repository/60_rst_pepper/public/source/_build/html/_images/label_sample.png

You can also use the Inspector to edit the Label.

https://developer.softbankrobotics.com/sites/default/files/repository/60_rst_pepper/public/source/_build/html/_images/inspector_label.png
  • To delete a label, select the label and press the Del key
  • To move a label, drag & drop it or edit the Frame number.