Documentation Center

Plug-ins User Guide

Version 5.2 | Published March 20, 2024 ©

Presets

images/download/attachments/149924430/videowall_icon.PNG

The Presets scene plug-in manages Super Channel-based preset master scenes. It has functionality for creating, updating and removing named presets, as well as the ability to transition between such presets. The presets define different layouts of the Super Channels in the scene. Preset state and the transition animations between presets are represented by directors in the stage. The Presets plug-in also provides a command interface that is utilized by the Media Sequencer Engine for management and playout of named presets.

Note: This plug-in is located in: Plugins -> Scene plug-ins -> Control

Presets Properties

  • Show advanced: Toggles advanced properties.

    • Current preset: The last preset taken, cut or selected in the dropdown.

    • Command in: Receives commands in order to perform an operation on the preset master scene.

    • Command result: Returns a result using the result parameter when a command is successfully executed.

    • Command error: Sets an error message using the error parameter on invalid commands or command failure.

  • Add superchannel: Adds a Super channel and a default content transition director to the scene, and applies Super Channel settings needed for playout from the Media Sequencer.

  • Preset name: Specifies the name of a new preset.

  • No layout transitions (new preset): Specifies whether the new preset should be transitionless. When selected, new presets added do not support layout transitions to and from other presets. When transitioning to and from such presets, the plug-in always falls back to cut (immediately applies the layout without animation).

  • Add preset: Adds a new preset with the name specified by the preset name parameter. The layout of the new preset is determined by the layout of Super Channels in the scene at the moment of adding the preset. This does not overwrite existing presets.

  • Preset: Determines the preset for editing.

  • Discard changes: Discards the changes made to the Super Channel layout and shows the layout for the preset currently selected in the dropdown list.

  • Apply changes: Applies changes to the preset currently selected in the dropdown list. This updates the preset director and preset transition directors with the layout currently visible in the editor.

  • Remove preset: Removes the preset currently selected in the dropdown list from the scene.

Creating a Preset Master Scene

This section describes how to create a preset master scene from scratch with Viz Artist. Start with an empty scene.

Adding the Presets Scene plug-in

The first step is to add the Presets scene plug-in to the scene.

Adding Super Channels

The preset scene manages named presets that define layouts of Super Channels. We need to add Super Channels to the scene. Super Channels can be added to the scene one by one with the plug-in:

images/download/attachments/149924430/vw_addsc.png

It is possible to add Super Channels to the scene manually in the DVE media assets tab, however this is discouraged because the default Super Channel configuration does not support playout from the Media Sequencer. The following settings are set when adding Super Channels with the Presets plug-in:

  • Super Channel asset type is set to Texture.

  • Super Channel start mode is set to Loaded / Cleared.

  • Directors for transitioning from subchannels A to B and from B to A are set to content transition directors generated by the plug-in.

  • Start mode for Super Channel subchannels are set to Transition Start.

  • Image zoom mode is set to Scale to fit min for Super Channel subchannels.

  • Image border color is set to transparent (alpha 0%).

Creating Presets

When the Presets plug-in and Super Channels are added to the scene, we can create presets, defining different layouts of Super Channels.

To create a new preset, first arrange the Super Channels to the desired layout and set the desired Super Channel properties:

images/download/attachments/149924430/vw_set_sclo.png

When the desired layout is set, use the Presets plug-in interface to add a new preset:

images/download/attachments/149924430/vw_addpre.png

Specify a unique name for the new preset before pressing the Add preset button. Existing presets are not overwritten. For adding more presets to the scene, repeat the process of adjusting the Super Channel layout, choosing a new preset name and pressing the Add preset button. If it is desired to add a preset without layout transitions to and from other presets, the option No layout transitions (new preset) should be enabled before pressing the Add preset button.

The presets and transitions between presets are now represented by directors in the stage, created by the plug-in:

images/download/attachments/149924430/vw_stage.png

Editing Presets

To edit a preset, first make sure it is selected in the dropdown list:

images/download/attachments/149924430/vw_preset_list.png

Now you can rearrange the Super Channels to the desired layout. Note that selecting a different preset discards any unapplied changes currently made in the editor. Changes can be applied to the selected preset with the Apply changes button, or discarded with the Discard changes button.