SoftBank Robotics documentation What's new in NAOqi 2.5?

Box libraries panel

Box libraries panel

The Box libraries panel displays the currently opened Box libraries:

../../../_images/box_library_panel_en.png

Toolbar

Button Click on this button to ...
new_box_library_btn

Create a new Box library.

For further details, see: Creating a Box library.

open_box_library_btn

Open an existing Box library.

For further details, see: Opening a Box library.

save_box_library_btn Save Box libraries.
search_box_library_btn Search a specific box among all the opened box libraries.

How to use the Box library panel

You can drag and drop any of the boxes contained in a Box library onto the Flow diagram panel to enrich a Behavior or a Box.

../../../_images/use_box_library_en.png

Box library

../../../_images/boxlibrary_icon.png

A box library consists of a list of Boxes.

This list can be organized with directories.

Each box may have attached files (music, image, etc) also included in the box library.

A box library is particularly useful when you often use the same boxes. You can store it in a box library and use and reuse it later.

Default Box libraries

Opened by default, and read-only box libraries:

  • Animation,
  • Speech,
  • LEDs,
  • Multimedia,
  • Movement,
  • Sensing,
  • Programming.

Also available:

  • deprecated: lets you know which boxes has been deprecated since the last release.

Box library available formats

You can save / open a Box library as:

  • a single compressed file with a CBL extension (ex: MyLibrary.cbl). The box library CBL format is an easy way to archive a box library and / or release it to someone else.
  • a directory. The box library directory format is a very useful way for collaborative / versioned project whose can be modified and extended by many people.

Note

For further details about saving a project as a CRG file or as a directory, see Saving a box library as a .cbl file and Saving a box library as a directory.

In versions older than 1.10, box library files were not compressed (the extension was XAL).

Getting information on a Box

Thanks to the Inspector panel, you can see information about any specific box in the Box Library.

When a Box is selected, the inspector displays the:

inspector_box_lib_en

Managing Box libraries

Opening a Box library

Step Action

Click the open_box_library_btn Open box library button.

../../../_images/open_boxlibrary_en.png

Select the relevant file type:

  • Directory for the Box libraries delivered in release 1.14,
  • .clb for the former Box Libraries.

For further details, see: Box library available formats.

Select the Box library to open.
Click Choose to validate your choice.

Creating a Box library

To create your own Box library:

Step Action

Click the new_box_library_btn New box library button.

The “New box library” windows appears:

../../../_images/new_boxlibrary_en.png
Make sure the file type is Box library directory (Directories).

Make sure you have an empty folder and select it.

Tip: if no empty folder is available, create one using the create_new_folder_btn Create new folder button.

Click Choose to validate your choice.

Customizing a Box library

To add boxes:

From ... Do ...
the Flow diagram Select the box and choose Add to library in the contextual menu.
a box library Copy/paste the box using the contextual menu.

To edit and save the content of the customized Box library, use the contextual menu:

../../../_images/box_library_menu_en.png

To automatically open your own box libraries at Choregraphe startup:

Step Action
Choose Edit > Preferences.

Choose the box libraries you want to be opened in the field User’s box libraries.

For further details, see: Choregraphe preferences.

Saving a box library as a .cbl file

Step Action

Choose Save library as... in the contextual menu.

The “Save box library as...” windows appears:

../../../_images/save_boxlibrary_cbl_en.png
Make sure the file type is Choregraphe box library (*.cbl).
Browse the destination path and complete the “File name” field.
Click Save to validate your choice.

Saving a box library as a directory

Step Action

Choose Save library as... in the contextual menu.

The “Save box library as...” windows appears:

../../../_images/save_boxlibrary_directory_en.png
Make sure the file type is Box library directory (Directories).
Make sure you have an empty folder and select it.
Click Choose to validate your choice.