Using Sub-Presentations


Sub-Presentations is a feature which allows a Studio presentation or a QML file to be embedded in a Studio presentation.

Sub-presentations execute independently, albeit inside the same Runtime process as the initial presentation. The rendered frame from each sub-presentation is essentially used as a texture on a rectangle in the main presentation. This allows control over where and how each sub-presentation is composited into the final frame.

Using Sub-Presentations

There are two different ways to display a sub-presentation; on a separate layer or on an image element on an existing layer.

Sub-presentation on a Layer

One of the main benefits of adding a sub-presentation on a layer is that you can author different parts of a large presentation as separate smaller presentations. This can help control complexity in single .uip files, as well as allow different parts of a presentation to be authored separately and simultaneously.

  1. From the file menu, select Edit > Sub-presentations.
  2. Click the + icon.
  3. Enter desired name for the sub-presentation in the Name field. In case you have several sub-presentations in your project the names need to be unique.
  4. Set Type to Presentation or QML stream depending on the content you want to embed.
  5. Click Browse, the combobox will display the following options:
    1. Browse - Browse to the folder of desired content and select the .uip or .qml file to add as sub-presentation.

    The options below are only available for Presentation type.

    1. Create - Creates a new empty presentation, which is added as a sub-presentation to the project. You may start editing it at once, or return to the main presentation by opening it from the file menu.
    2. A list of all .uip files in your project folder. Select one to add it as a sub-presentation.

  6. Select the layer you want to use for the sub-presentation in the timeline palette. Then, in the inspector palette, select the desired sub-presentation in the Sub-Presentation field. All sub-presentations added to the project will be listed here.

Sub-presentation on an Image Element

One benefit of displaying a sub-presentation on an image element is that you can use Studio presentations and QML files to map the materials of objects in your presentation. You can apply sub-presentations as any kind of map to object materials, i.e. diffuse maps, specular maps and displacement maps. This way you can for example create animated textures.

  1. Follow step 1 to 5 in the Sub-presentation on a layer section above.
  2. Add a basic object to your layer.
  3. Add any image as a map for the material of the object by first selecting the material of the object in the timeline palette and then selecting desired map in the inspector palette. This image will act only as a placeholder, it does not matter what image you use.

  4. Select the map in the timeline palette and then select the desired sub-presentation in the Sub-Presentation field. All sub-presentations added in the .uia will be listed here.


To display the sub-presentation background as transparent in the main presentation there are two settings in the sub-presentation that needs to be set.

  1. Layer property Layer Background needs to be set to Transparent.
  2. Scene property Set Background needs to be unchecked.

Available under certain Qt licenses.
Find out more.