Viz Mosart User Guide

Version 5.0 | Published June 21, 2022 ©

Control Command Keys

This section focuses on control commands and the common use case of assigning them to a keyboard shortcut. Topics covered include:

images/download/attachments/72113891/Control_Command.png
Control Commands are commands the operator can send directly to one of the connected devices, independent of templates currently in use.

For example, a control command key can be defined to send a DVE FORWARD command to the vision mixer or similarly, a Continue graphics command can be sent to the connected graphics system.

Most of Control Commands have parameters attached to them, as described below:

Keyboard-based Control Commands

Common Parameters

Touch Mode

images/download/attachments/72113891/keyboard_touchmode.png
All control command keys share the TouchMode parameter.

  • OnAir indicates that clicking or pressing the keyboard shortcut in the shortcut window immediately executes the relevant control command.

  • None disables touch/click functionality for the button.

Adding a New Command

  • From the menu bar select Tools > Keyboard shortcuts editor.

  • Click Add new command to add multiple commands to a shortcut.

    images/download/attachments/72113891/keyboard_add-new-cmd.png


    In the figure above, two commands have been added: SET_AUX_CROSSPOINT and LIGHT.
    These commands are executed sequentially from left to right (in the example, first SET_AUX_CROSSPOINT, then LIGHT).

AUDIO

Audio Control Commands have an associated Faderate parameter, which allows the operator to set a fade rate in frames where relevant.

images/download/thumbnails/72113891/Control_Command_Audio.png

Audio Parameters

Name

Description

FADE_OUT_KEEPS

Faders that are set as "keep level" in the template On Air are faded out. Default: CTRL+F Will also work when new templates have been taken in between the 'keep' action and the FADE_OUT_KEEPS.

FADE_MANUAL

The audio faders for the On Air server channel are set to Manual control, and are not changed by Viz Mosart until taken out of manual control again. Default: CTRL+M

FADE_UP_SECONDARY_AUDIO

Viz Mosart fades up relevant audio sources not connected to the video currently On Air, when cutting between sources.
For example, when cutting from a camera to a live source, internal Viz Mosart logic dictates that all the microphones in the camera template are left up.
Pressing SHIFT+F10 fades the camera template microphones down. F10 brings them back up again, for example to allow the presenter to talk to a reporter at the end of a live segment. Default: F10

FADE_DOWN_SECONDARY_AUDIO

Viz Mosart fades down relevant audio sources not connected to the video currently On Air. Default: SHIFT+F10

FREEZE_AUDIO

With the Control Command Freeze Audio all sound faders are frozen, and do not respond to commands from templates.
This command is a toggle function. Default: CTRL+K. Same function as 'Keep Sound', i.e. the K button in the Audio Function Area.

SET_LEVEL_2_PREVIEW

The second level for faders in the template are set on the template which is in preview, and be performed on next transition. Default: CTRL+L

SET_LEVEL_2_ONAIR

The second level for faders in the template which are On Air are set. Default: SHIFT+CTRL+L

AUTOTAKE

Sets the Viz Mosart system to auto take mode.

PARAMETERS: The key can be defined as a toggle key, or two separate keys can be used to activate or deactivate autotake mode.

Default: Toggle with CTRL+SHIFT+A.

AUTOTRANS

Tells the switcher to perform a transition on a given ME between the currently cued and On Air source.

PARAMETERS: ME and transition rate.

DIRECTTAKE

Executes a direct take template.

PARAMETERS: Recall Number of the direct take template.

You can create a direct take in the Template Editor. Note that all direct takes have to be created as part of the special Directtakes template set. Under Template properties (Recall Nr) the direct take number is defined. When the direct take has been created, you can assign a keyboard shortcut to perform this direct take, under 'Control Command Key' in the Keyboard Shortcuts editor.

DVE

Sends a forward or reverse command to the DVE in the vision mixer.

PARAMETERS: Set to forward or backward.

Default: Forward with PageUp

Default: Backward with PageDown

ENABLE_GRAPHICS_MIRRORING

Target: FULLSCREEN, OVERLAY, ALL - Where to enable/disable graphics mirroring

Action: ENABLE, DISABLE - What to do

This is for the functionality of sending same graphic commands to multiple graphics engines.

FULLSCREEN_GRAPHICS

ENGINE: The engine number on which control commands execute. The engine number is selected from the drop down menu and must be same as the number defined in AV Automation.

Action:

  • CONTINUE: Send a continue command for a fullscreen graphic on a graphics engine.

  • MACRO: For graphics systems that support macro recall, this recalls a macro on the defined engine.

PARAMETER: The Parameter value has specific functionality depending on the chosen command.
When MACRO: Name of the macro to recall.

For VIZRT graphics, two special macros are available: "INITIALIZE" (or "INITIALISE") and "CLEANUP", which initializes and clears the playlist, respectively.

images/download/thumbnails/72113891/image2020-6-16_15-41-39.png

Default: Send a Continue to the current engine with F11.

GRAPHICSPROFILE

Changes the current graphics profile loaded.

PARAMETERS: Enter the name of the desired graphics profile.

LIGHT

Activates a specific light setup.

PARAMETERS: Enter the number of the desired scene

MARKER

Inserts a metadata marker into the timeline.

PARAMETERS: Description to be entered for the marker.

OVERLAY_GRAPHICS

The Overlay Graphics Interface provides control and monitoring of overlay graphics for all Viz Mosart-approved graphic engines. For a detailed description, see section Overlay Graphics Interface of the Viz Mosart Administrator Guide.

All Overlay Graphics commands share the Render parameter. This parameter can be set to send the given command to a specific engine, or to engines which currently have active graphics On Air.
In addition, the Parameter value has varying functionality depending on the chosen command.

  • CLEAR: This command takes out all on-air overlay graphics. Default: CTRL + X.

    • Parameter specifies the destination to clear the graphics from.

images/download/thumbnails/72113891/image2020-6-23_14-46-12.png

    • Render specifies the engine number (from the Overlay Graphics screen) to clear the graphics from if Parameter is empty.
      This value can also be non-numeric (in the left-hand example below: Current), to clear the graphics from all the engines.

      Any non-numeric value (including the empty value) has the same effect: Clear the graphics from all the engines.


      images/download/thumbnails/72113891/image2020-6-23_14-47-17.png images/download/thumbnails/72113891/image2020-6-23_14-47-41.png

      Parameter field value has a higher precedence than the value of Render.

    • Value field is ignored.


  • CONTINUE: If the current overlay graphics contains stop points/triggers, this command continues the timeline.
    The Parameter can be either one of the Mosart graphics destinations (channels) or a valid graphics ID.
    If the Parameter-field is not empty, and the value given is not found among the destinations configured in the Viz Mosart OverlayGraphics, then this is considered to be a graphics ID.
    In such cases, the destination is searched for in the configured destinations from within the OverlayGraphics settings based on the value of the Render-field (which is the engine ID).
    Possible values for the Value-field:

    • STRICT: means that the shortcut is executed only if the graphics contain continue points.

    • <empty>: Applies to all the graphics.
      Default: Send a Continue with SHIFT+F11

  • PRETAKE NEXT: With this command, the next overlay graphics in the timeline are taken in.
    Parameter field can contain a graphics Handler name (WALL or DSK etc). This value overrides the value in Render.
    Default: CTRL + O.

  • TAKE LAST OUT: This command takes out the last overlay graphics which have been taken in. Render value has no effect.
    In the Parameter field, it is possible to enter a graphics Handler name (WALL or DSK etc.). Default: HOME.

  • TAKE MANUAL OUT: This command takes out overlay graphics which have been set to wait for a manual take out.
    Parameter field specifies the name of the destination to take out the graphics from.
    Default: SHIFT + HOME.

  • TAKE NAMED OVERLAY: This command is to take a specific named overlay graphic item to air via a keyboard shortcut.
    Parameter field holds ItemId. If blank, use current item.
    Value=Slug.

  • MACRO : For graphics systems that support macro recall, this recalls a macro on the defined engine(s).
    Parameter field is the name of the macro to execute.

    For VIZRT graphics, two special macros are available: "INITIALIZE" (or "INITIALISE") and "CLEANUP", which initializes and clears the playlist, respectively.

SET_AUX_CROSSPOINT

Sets a crosspoint on one of the AUX buses on the mixer.

PARAMETERS: Select bus and specify crosspoint.

SET_CROSSPOINT

Sets a crosspoint on the vision mixer.

PARAMETERS: The operator can choose the ME, bus (A, B, C, D or keyers) and crosspoint for the command.

Buses C and D are used for video switchers supporting M/Es effects with 4 layers (e.g. vizrt-ips).

images/download/attachments/72113891/image2021-1-13_13-11-20.png

SET_CURRENT_ME

Sets a given ME On Air.

PARAMETERS: Choose an ME.

RUNDOWN_NCS_RESYNC

Initializes a reconnect to the NCS.

SEQUENCE

Contains controls for a sequence as defined in a template.
This applies to all secondary items; including lowerthird graphics and accessories.
In a rundown in the GUI, you can right-click on a story → Edit → Save story as sequence.

  • START: Restarts a previously stopped sequence.

  • STOP: Stops a running sequence.

  • STARTLOOP: Sets a running sequence to start looping.

  • STOPLOOP: Stops running a looped sequence in loop

STUDIOSETUP

Changes the current studio setup (template set) loaded.

PARAMETERS: Enter the name of the desired studio setup.

VIDEOWALLMODE

Toggles a mode where key parts of production are shifted via an ME to a connected video wall (e.g. video server ripple, but not camera switching). It is not recommended to use this feature without consulting Viz Mosart support.

PARAMETERS: The ME to be used.

TAKE_SERVER_TO_PROGRAM

Takes a video server port to program on a selected ME. For example: a video clip is running on a video wall. The shortcut can then be used to take the last used/active video server to program.

PARAMETERS: Select on which ME the video server should be taken to program, and the transition rate to use.

TRANSITION_TYPE

Sets the transition type to use on the next transition.

PARAMETERS

TransitionType: The type can be set including Toggle (default), which cycles through the various transition types. In the Value field, the transition rate in frames can be set, or the effect number for the mixer effect transition type.

Value: Used to set a specific value for the TYPE.

Transition Type

Value

Description

TOGGLE_SELECT

images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/error.svg

Toggle between MIX,WIPE,EFFECT

CUT

images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/error.svg

Set the transition to be mix with value = 0

MIX

images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

Set the transition to be mix with the specified value as number of frames

WIPE

images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

Set the transition to be wipe with the specified value as number of frames

EFFECT

images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

Set the transition to be effect with the effect number specified in the value field

WEATHER

Controls the timeline of a connected Viz Weather system.

  • PLAY: This command starts the timeline of the weather system.

  • CONTINUE: When a weather timeline has stop points, this command sends continue commands to the timeline.

  • GO TO FIRST: This command cues the weather scene to its first page/frame.

ACCESSORIES

Pretakes an accessory. Pretake requires the accessory template to have preload enabled and also a primary type to trigger the pretake defined. Only use accessories with in-time=0.

SET_VIDEOSERVER_SALVO

Switches to the videoserver salvo specified in the combobox parameter.

NCS

This control command is for the OpenMedia newsroom system specifically.

Action:
START_STATUS,
STOP_STATUS

Parameter:
RUNDOWN
STORY
ITEM

SWITCH_VIDEOSERVER_MIRRORING

Toggles a switch of any mirrored video ports.

SWITCH_GRAPHICS_MIRRORING

TOGGLE - Toggles mirroring mode for graphics for fullscreen graphics.

ACTIVATE - Activates mirroring mode.

DEACTIVATE - Deactivates mirroring.

RECORD

images/download/thumbnails/72113891/c1.png
The Record control command has the following parameters:

  • Command:

    • PREPARE: Cue a recording.

    • START: Starts a recording previously PREPAREd.

    • STOP: Stops a recording previously STARTed.

    • DELETE

  • ClipName (PREPARE only): The name of the clip to be created.

    Note: It is possible to include the current gallery/studio, template set, and time in the name of the created clip. For details please refer to section Video Server, MAM and Database Connection Strings in the Viz Mosart Administrator Guide (ClipNamePattern property).

  • PortName (PREPARE only): The name of the video port where the recording shall take place. Note that this port has to be part of the “Rec” virtual video port group.
    Default value is “Rec”.

    Note: For the setup of recording ports, please refer to section AV Automation Devices Video Servers in the Viz Mosart Administrator Guide.

  • Recorder: A user-defined name to be used for a recording, tied to ClipName and PortName. Set in the PREPARE command and subsequently used by the START and STOP commands. A value of Default selects the default recorder.

QUICKEVENT

Quickevent control command has the following commands:

Name

Description

TOGGLE_SELECT

Viz Mosart marks the current item in the list as group-selected. The group selected items can be iterated with NEXT_GROUP_ITEM and PREVIOUS_GROUP_ITEM.

NEXT_GROUP_ITEM

Viz Mosart selects the next group-selected item (down).

PREVIOUS_GROUP_ITEM

Viz Mosart selects the previous pre-selected item (up).

CLEAR_SELECTION

All selected and group-selected marks are removed.

NEXT_ITEM

Viz Mosart selects the next item (down).

PREVIOUS_ITEM

Viz Mosart selects the previous item (up).

TAKE_SELECTED

Viz Mosart attempts to put the selected item to air.

TAKE_SELECTED_TO_WALL

Viz Mosart takes the selected item to the wall item specified in the parameter. See Template Router .

PREVIEW_SELECTED

Viz Mosart attempts to put the current selected item to preview.

PREVIEW_SELECTED_TO_WALL

Viz Mosart puts the selected item to the selected wall salvo preview wall item specified in the parameter. See Template Router.

PRELOAD_SELECTED

Viz Mosart tries to preload the current selected item to the preload port\engine if available and configured in AvAutomation.

FILTER_LEFT

Viz Mosart switches the selected filter to the filter displayed to the left of the currently selected filter (this also works with QAP).

FILTER_RIGHT

Viz Mosart switches the selected filter to the filter displayed to the right of the currently selected filter (this also works with QAP).

LOWERTHIRD_ACTION_SELECTED

Viz Mosart puts the selected lowerthird in the quick access tab based on the parameter.
The parameter is mandatory and available with the following actions:

  • DEFAULT: Take in only

  • AUTO: Take in if not On Air
    Take next continue point if On Air and has continue points
    Take out if On Air and no more continue points

  • CONTINUE: Take next continue point

  • TAKEIN: Take in only (same as DEFAULT)

  • TAKEOUT: Take out (even if there are more continue points left)

VIDEO_PORT

images/download/thumbnails/72113891/c2.png
Command for sending a specific command directly to a specific video port. Not applicable for all video servers, behavior varies depending on video server type.
Is not visible in the rundown (only visible in Template Router)!

Action: What action to perform on clip assigned to port:

  • PLAY_PAUSE: Play or Pause assigned clip

  • STOP: Stop assigned clip

  • CUE: Cue assigned clip

  • RECUE: ReCue assigned clip

  • SET_LOOP: Tells the video player to loop the current clip

  • PLAY_TAIL: Skip to end of clip and start playing. Use parameter e.g. -10 to skip to 10 seconds before end of clip. Used for rehearsal.

  • CUE_TAIL: Same as PLAY_TAIL but does not start to play.

VideoPort: Name of the video port for sending commands to.

Parameter: Used for PLAY_TAIL and CUE_TAIL commands. Specified length from end or start of clip to skip to. Use negative number to count from end.

DEVICE_PROPERTY

n/a

USER_MESSAGE

When the keyboard shortcut is activated it adds a user_message log message to all connected logs with the message configured in the keyboard shortcut.

User can insert a simple log message to appear when the button is pressed. This is useful for the operator in fault-finding situations, where, a known message string can be pushed into the log, for example, at the point of a troublesome situation in a production.

OVERLAY_TO_MANUAL

Converts all lowerthirds(overlays) to manual for the current, preview or selected story.

The control command OVERLAY_TO_MANUAL has three optional parameters:

  • Parameter 1: The type of story to be converted, either:

    • SELECTED (default): The selected story in the GUI.

    • PREVIEW: The next story

    • ONAIR: The on air story

  • Parameter 2: Comma-separated list of handler names, e.g. WALL,DSK. Empty list means all handlers.

  • Parameter 3: Method for the converted overlays to be taken out, either:

    • AUTOMATIC (default)

    • MANUAL
      When activated, OVERLAY_TO_MANUAL converts all lower-thirds in the specified story (Parameter 1) with the specified handler name (Parameter 2) to MANUAL. If no handler name is specified, it converts all lower-thirds in that story to MANUAL. If Parameter 3 is set to MANUAL, the converted overlays also have to be taken out manually, otherwise they are taken out (automatically) after the specified duration.

STORY_ACTION

Invokes an action on a target story. This can replace functionality in the story context menu by a shortcut. Can only be used from GUI.

The control command STORY_ACTION has two mandatory parameters:

  • Parameter 1 (Target): The type of story to be converted, either:

    • SELECTED (default): The selected story. Used for GUI.

    • PREVIEW: The next story

    • ONAIR: The on air story

  • Parameter 2 (Action):

    Name

    Description

    SELECTED

    PREVIEW

    ONAIR

    TOGGLE_COUNT_DOWN_TO

    Toggle the target story count down to the target story

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/error.svg

    SET_AS_NEXT

    Set the target story as next

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/error.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/error.svg

    SET_AS_NEXT_AND_SKIP

    Set the target story as next and skip any remaining items

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/error.svg

    TOGGLE_LOCK

    Toggle the lock story from NCS update on the target story

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    REMOVE

    Remove the target story

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/error.svg

    LOOP_START

    Set the start loop at the target story

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    LOOP_END

    Set the end loop at the target story

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    LOOP_CLEAR

    Clears any loops in the rundown

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    APPEND_ITEMS_TO_CURRENT

    Take all items of target story and append them after the current on air item

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

    images/s/-5qjg51/8703/zb070w/_/images/icons/emoticons/check.svg

Additional Control Command Actions

In addition to being assigned to shortcut keys, control commands can be:

  • Set into the Viz Mosart timeline (from the NCS), using written commands. For example, using a textual command, either as a machine command in iNews or like this in ENPS.

    This command performs a DVE FORWARD four seconds into the main item:
    (**COMMAND=DVE FORWARD <00:04**)
  • Attached to templates as continue points

  • Attached to templates to be automatically performed when a template goes on-air or off-air

  • Used for changing the template set

  • Used for changing the graphics profile

  • Used for setting the system in AUTOTAKE-mode.

For further details of the control commands that can be attached to a template, please refer to the Viz Mosart Administrator Guide.

Parameters with Placeholders

Control command parameters may contain placeholders which can be replaced with values found in the fields of the Viz Mosart item which is currently on-air. Refer to the Viz Mosart Administrator Guide, section Parameters with placeholders, in Additional Template Functionality.