In HeavyM, in addition to the built-in library of visual effects, you can add some external content in special shapes called “players”. As of HeavyM 1.6, players can support 5 categories of sources: Medias (photos, videos, GIFs), Webcam streams, Syphon/Spout streams, Shaders, Text.

In this tutorial, you’ll learn how to set the display settings of a player. Indeed, you can choose to project its content entirely, or you can configure the display modes so that its content is only visible in specific faces of your mapping.

 

Adding a player and setting its content

To proceed with this tutorial, we first have to add a player and choose its content. Here’s a quick reminder of one way to achieve this:

1. Drag & Drop a player shape from the toolbar.

2. In the settings in the panel on the right, choose the type of content you want to import in the player.
By default, it is set on Media (photos, videos, GIFs). For this tutorial, we’ll keep it that way.

3. In the same panel, use the + icon to choose the source.

4. Then, click on Play in the settings of the player to launch its playback. (When a player is paused, it is not displayed in the output.)

add a video in HeavyM

 

 

Choosing a display mode

You can choose between three different display modes for each player, accessible from the drop-down selector located on a player item in the layer list.

display mode selector

The modes are: “Background Display”“All Groups Display” and “Solo Group Display”. We’ll go over the differences in the following paragraphs.

Depending on the mode, a player will have a specific place in the layer list. So you can also directly change the position of a player in the pile to adjust its display setting and the mode will switch accordingly.

Note: don’t forget that in any case, a player needs to be on “play” to be displayed.

 

Unclipped in the background

If the “Background Display” option is selected, the player is sent to the back and its content is displayed in its entirety, in the limits of the projection area.

All players with this option are at the bottom of the layer list so they are displayed in the background, behind all faces and all their effects.

Player 1 is displayed in its entirety, in the background, regardless of shape boundaries

If there are several players with this display setting in the same sequence, you can still change their order of superposition.

Note: by default, when you add a player in the work area, its display mode is set on “Background Display”.

 

Clipped to all faces

If the “All Groups Display” option is selected, the player is sent behind all faces and groups, but above “Background Display” players.

This mode allows you to mask parts of a player and only project its content inside all the faces in your mapping, regardless of their group assignments, as if it were cropped.

In the example below, the player is visible in all the faces of the mapping, behind all effects, but masked outside of their boundaries.

Player 1 is displayed within the boundaries of all groups, behind all effects

If there are several players with this display setting, you can change their order of superposition.

Note: if you hide a face, the part of the player that was displayed inside will be hidden in the output.

 

Clipped to a single group

If the “Solo Group Display” option is selected, the player is sent to the group you have chosen, behind all the faces it contains.

This mode allows you to mask parts of a player and only project its content inside the faces of a specific group, as if it were cropped. The player will be displayed behind all faces of the group and their effects.

Player 1 is displayed within the boundaries of Group 1 or Group 2, behind its effects

In this case, the player is part of a group, so it is necessarily displayed above all faces and effects that are in groups below the one it is in, as well as “Background Display” and “All Groups Display” players. On the other hand, it is behind the faces and effects of its group and other groups above.

Know that to set this display mode, you can also directly put the player in a group, using the usual methods (drag & drop, “add to group +” button, etc).

Note: if you hide a face of this group, the part of the player that was displayed inside will be hidden in the output.

 

Cheat sheet

Here’s a summary of the rendering order and the position of players in each display mode (the bottom being the background, Group 2 above Group 1):

RENDERING ORDER for players and effects
Masks
Output effects
Group 2 faces & effects
“Solo Group 2” players
Group 1 faces & effects
“Solo Group 1” players
“All Groups” players
“Background” players

 

Notice that the layer list gives you a good idea of this order: 

cheat sheet rendering order players

 

Warning: since players are rendered behind all effects of the faces they are displayed in, don’t forget to turn off or lower the opacity of any filling effect that might cover it!

 

That’s it for the display settings. To learn about other player-related settings, go check out the rest of the tutorials on the subject!