Located on the left of the interface, the mapping panels contain everything related to the geometry, transformation and organization of your shapes.
The Layer list
Every time you add an object in your work area, you’ll see it appear in this Layer list. In the list, faces , masks
and players
all have a specific symbol to better differentiate them. Learn more about the role of each of these object here.
In your mapping, shapes are always placed in groups, with masks always at the top of the group they belong to, and players and faces mixed below. This group segmentation will, amongst other things, allow you to display different built-in effects in the faces of your mapping. Indeed, all the faces in a specific group contain the same group effects.
In addition, know that the order of the layers in the list impacts the rendering order in the output, i.e. if a group is above another in the list, it will be rendered in front of it in the output. You can change the arrangement of groups and objects in the list with drag & drop movements, among other methods that will be further discussed later.
In short, you'll see that this panel lets you manage groups, shapes and the hierarchy of all these layers in the selected sequence. Its operation will be detailed throughout this guide, but let’s have a quick overview of the features it contains here. Many options in this panel will facilitate your workflow:
Add Group: creates a new group. If shapes were selected when you hit the button, they are directly added to this new group.
,
Move Group Backward / Forward: moves the active group (in light gray, here Group 1) one step down / up in the list.
Lock/Unlock shapes: depending on the line in the list, you can either lock/unlock one shape, all shapes in a group, or all shapes in the list at once.
Show/Hide shapes: depending on the line in the list, you can either hide/show one shape, all shapes in a group, or all shapes in the list at once.
Options: depending on the line in the list, you can either access options for one shape, one group or global options for the whole list.
Collapse/Expand: folds or unfolds the list of shapes contained in a group.
Group color: indicates the color that the shapes of this group bear in the work area. Clicking on it will reveal a 30-color palette that you can choose from to change the group’s color.
Add to group: moves the selected shapes to the corresponding group.
Display mode selector: allows you to choose how to display your player. Either its content is displayed in the full player area, or you can choose to display it only in the faces of the group it belongs to.
- Group name: double-click on it to rename the group. This is also valid for shapes.
- Subgroups titles: as we've said before, masks always have to be at the top of the group and faces and players below them. To help you categorize better if you have a lot of objects, you can choose to display titlebars for "Masks" and "Shapes" subgroups, as seen in the screenshot above. This option is located in Edit → Preferences... → General → Interface.
Note: some of the options detailed above are also accessible from right-click context menus in the work area.
The Properties panel
When you select an object in your work area or in the Layer list, it might have additional options related to its geometry or transformation. Some of these options are usually not accessible from the canvas, hidden, or need a shortcut to be enabled so the Properties panel gives you a quick and easy access to them.
Note: the Properties panel doesn't handle multi-selection (yet), so you'll only see options appear if you select one element with properties at a time.
Player properties
Here are the properties you'll find if you select one player shape:
- Display mode: this lets you choose whether to display the content of your player in the full player area or just in the faces of its group. Learn more about them here.
- Postprocessing effects: this section lets you add and manage postprocessing effects on your player. Those are not counted as "content" per say, as they behave more like "filters" that affect the content in your player. Learn more about them here.
- Warping: this section allows you to use the warping tool on your player to deform its texture.
Vertex properties
Here are the properties you'll find if you select one point in a face:
- Handles: this lets you convert your point to a straight point or one of the 3 types of curve points. Learn more about them here.
Center properties
Here are the properties you'll find if you select a face or its Center:
- X and Y: these input fields let you set the coordinates of the Center in the Canvas. You can animate them with LFOs. Learn more about it here.
- Reset position: this button lets you reset the coordinates of the Center back to coincide with the geometrical center of the face.