Viz Mosart Administrator Guide
Version 5.2 | Published May 22, 2023 ©
Control Commands in Templates
A Mosart control command can be triggered from a template, executed when the template is taken (Command On Take), at continue points (Continue Points) or when the template is taken out (Command On Take Out).
Note:
-
A Mosart template can trigger multiple control commands.
-
A (not-templated) control command can trigger a Mosart template, often used for a DirectTake template.
Working with Control Commands
This is done through AV Automation > Devices > Template Editor > Template > Properties > Control Commands tab.
The figure above shows a single (video) control command to be executed when the template is taken. Multiple control commands can be assigned here.
It is also possible to assign control commands to be executed at continue points and when the template is taken out.
The latter has limitation since the Parameter setting is not available. In this context it may be useful to trigger a direct take at this place.
Adding a Control Command
To Add a Control Command
-
Click the Control Commands tab in the Template properties window.
The three categories of control command are Commands on Cue, Command On Take, Continue Points and Command on Take Out. -
Refer to the table Command Values and Parameters for command details.
Commands on Cue
You can recall control commands in Preview, when the template is cued. This enables triggering of events when a story item is taken to Preview.
As illustrated above, you can give the command a Value and a Parameter in the same way as for Command On Take, Command on Take Out.
Also, in a similar way to Continue Points you can set an offset for when the command is to be executed.
Note: For Cue commands, all offsets are relative to the start of cueing. This differs from Continue Points, where each offset is relative to the previous continue point.
In the illustration above, the User Message (Ready) will be sent 100 frames after cueing.
By defining a Newsroom tag as a parameter for an On Cue command, the user can set the parameter from the NRCS.
-
In the Parameter column right-click and select either Add/Remove/Change a newsroom tag .
Command On Take
When selected, the commands inserted in Control commands Take are executed when the template is taken to Program or On Air.
By defining a Newsroom tag as a parameter for an On Take command, the user can set the parameter from the NRCS.
-
In the Parameter column, right-click and select either Add/Remove/Change a newsroom tag .
Continue Points
When selected, the commands inserted in Continue Points will be taken when pressing TAKE NEXT (default: F12). Viz Mosart executes this continue point from within the primary template in which it is inserted. Each line represents a new Continue Point.
-
Cue Next Item Index: Enter the line number (for example, 0, 1, 2, 3) of the continue point that executes a cue for the next/following Primary object. If empty, Viz Mosart cues when entering the last continue point in the list.
-
Autotake: Insert the autotake time, in frames. The command is then automatically taken after that time.
Note: For Continue Points, all offsets are relative to the last Continue Point. This differs from Commands on Cue, where each offset is relative to the start of cueing.
In the illustration above, the Device Property is fetched 20 frames after being taken on-air, Player Status is fetched at 50 frames later and from the NRCS, the Stop Status at 110 frames after the previous (Get Player Status) Continue Point was processed.
By defining a Newsroom tag as a parameter for a Continue Point, the user can set the parameter from the NRCS.
-
In the Autotake column right-click and select either Add/Remove/Change a newsroom tag.
Command on Take Out
The commands inserted here are executed when the template is taken from the program, taken Off Air, or at the end of the template. Only a single command can be used in Command On Take Out, and it does accept any parameters.
Command Values and Parameters
Note: Parameters marked with (*) do not work for templates.
Note: It is not possible to enter a Parameter in the Control command Take Out section.
COMMAND |
Value |
Parameter |
Description |
ACCESSORIES |
TAKE_NEXT |
(*) |
|
AUDIO |
FADE_MANUAL |
|
Toggle fade manual. |
|
FADE_OUT_KEEPS |
Fader rate |
Faders that are set as "keep level" in the template On Air are faded out. Will also work when new templates have been taken in between the 'keep' action and the FADE_OUT_KEEPS. |
|
FADE_DOWN SECONDARY_AUDIO |
Fader rate |
Viz Mosart fades down relevant audio sources not connected to the video currently On Air. |
|
FADE_UP SECONDARY_AUDIO |
Fader rate |
Viz Mosart fades up relevant audio sources not connected to the video currently On Air, when cutting between sources. |
|
SET_LEVEL_2_ONAIR |
- |
The second level for faders in the template which are On Air are set. |
|
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. |
|
FREEZE_AUDIO |
- |
All sound faders are frozen, and do not respond to commands from templates. This command is a toggle function, and is thus NOT suited for use from a template. |
AUTOTAKE |
N/A |
(*) |
|
AUTOTRANS |
PP, ME1, ME2, ME3, ME4 |
MixEffect (MIX OR WIPE) + Transitionrate |
For example: MIX 33, WIPE 10. Note: The Effect cannot be used. |
|
AUX, Default |
(*) |
|
CROSSOVERCOMMAND |
N/A |
(*) |
|
DEVICE_PROPERTY |
CAMERA CONTROL |
See next column. |
Note: This is for camera robotics. When the DEVICE_PROPERTY control command is used with the value 'CAMERA CONTROL', only setting speed (Camerobot) and presenter (Camerobot/FxMotion) are controllable from a template. Details for Camerobot Presenter: ANCHOR=pos1:presenter1[,pos2:presenter2]… The position and presenter is given as a pair divided by ‘:’. Multiple position-presenter pairs are possible, separated by ‘,’. Note: The position is a string and does not have to be a number. Details for Camerobot Time: If Time =1 (>0), Viz Mosart sends MATRIX_MOVE_MPOS command to Camerobot, |
|
AUDIO |
demands <fields> structure as parameter with |
Note: This is for an audio mixer. |
DEVICE_STANDBY |
AUDIO_MIXER, GPI, LIGHTS, LOUDNESS, ROUTER, SOUND_PLAYER, SUBTITLING, VIDEO_SERVER, VIDEO_SWITCHER, VIDEO_WALL, VIRTUAL_SET, WEATHER |
ON OFF TOGGLE |
ON: The device chosen (in Value) is put in Standby. OFF: The device chosen (in Value) is taken out of Standby. TOGGLE: The Standby status (ON/OFF) of the device chosen (in Value) is toggled. (If there are several devices of the chosen kind (e.g. video servers), all of them are affected.) |
DEVICE_STANDBY |
GRAPHICS (full-screen) |
As above (ON/OFF/TOGGLE) OR engineno:[ON|OFF|TOGGLE] |
ON/OFF/TOGGLE: As above, applied to all graphics engines.
If an engine number is given, only the designated engine is affected. |
DEVICE_STANDBY |
ROBOTIC_CAMERA |
As above (ON/OFF/TOGGLE) OR controller:[ON|OFF|TOGGLE] OR controller:camera:[ON|OFF|TOGGLE] |
ON/OFF/TOGGLE: As above, applied to all cameras on all controllers.
If both a controller and a camera is given, only the designated camera is affected. |
DEVICE_STANDBY |
OVERLAY_GRAPHICS |
As above (ON/OFF/TOGGLE) OR Engine No:[ON|OFF|TOGGLE] |
ON/OFF/TOGGLE: Applied to all overlay graphics (all controllers and corresponding engines). If an engine number is given, only the designated engine is affected. Note: Only engine number is supported. |
DIRECTTAKE |
The Recall Nr (see Template Properties) of the direct take template to execute |
- |
Executes the direct take template given by Value. |
DVE |
FORWARD REVERSE |
Recall forward/reverse EMEM |
n/a |
ENABLE_GRAPHICS_ |
n/a |
(*) |
|
FULLSCREEN_GRAPHICS |
CONTINUE_FULLSCREEN |
AUTO |
Continue Command Only: The AUTO parameter will replace the continue command with the number of continue points in the graphics item. Examples: |
FULLSCREEN_GRAPHICS |
CONTINUE_FULLSCREEN |
Engine no |
The target output fullscreen engine number to execute the action on. (e.g. 1,2,3 ) |
|
MACRO |
Engine no : macro |
The target output fullscreen engine number to execute the action on. (e.g. 1,2,3 ) and Macro name. The engine number must be same as the number defined in AV Automation |
GRAPHICSPROFILE |
N/A |
- |
|
HOLD_AUDIO_ |
N/A |
- |
|
HOLD_VIDEO_ |
N/A |
- |
|
LIGHT |
N/A |
(*) |
|
MARKER |
N/A |
(*) |
|
NCS |
START_STATUS, STOP_STATUS |
RUNDOWN STORY ITEM |
Specific for Open Media |
NEXT_CUE_DELAY |
EXTEND |
A number of frames |
If there is a pending cue (when this control command is executed), this cue is postponed by the number of frames given. Otherwise (no pending cue), the next cue operation will be additionally delayed by the number of frames given. (I.e., the value will be added to the sum of the settings
|
OVERLAY_GRAPHICS |
CLEAR |
Destination or Render (Engine no.) |
Destination or Render (Engine no.) to clear the graphics from. Numerical value: Render (Engine no.) Non-numerical value: Destination. |
|
CONTINUE |
Engine no |
|
|
TAKE_MANUAL_OUT |
Destination or Empty |
Destination to take out the graphics from. Non-numerical value: Destination Empty or Numerical value: Takes out all the graphics |
|
MACRO |
Engine no : macro |
For example: 4:macrohere |
|
PRETAKE_NEXT_OVERLAY |
Render (engine no) |
|
|
TAKE_NEXT_OVERLAY, TAKE_NAMED_OVERLAY |
(*) |
|
OVERLAY_TO_MANUAL |
Parameter 1: ONAIR (default), PREVIEW. |
Parameter 2: Comma-separated list of handler names Parameter 3: AUTOMATIC (default) / MANUAL Parameter 2 and Parameter 3 must be separated by a semicolon. (E.g. WALL,DSK;MANUAL.) |
For more details, see Viz Mosart User Interface > Keyboard Shortcuts > Control Command Keys > OVERLAY_TO_MANUAL in the Viz Mosart User Guide). Note : If there is no semicolon after Parameter 2; nothing to the right of the semicolon; or Parameter 3 has any value other than 'MANUAL', then Parameter 3 gets the default value ‘AUTOMATIC’. |
PLAY_STORY |
N/A |
(*) |
|
RECORD |
PREPARE, START, STOP |
Split parameters using, - first: clipname, - second: recorder (optional), - third: port name (default Rec), - fourth: group name (default Rec) |
For example: clip33,recorder1,Rec,Rec |
RELEASE_BACKGROUND |
N/A |
(*) |
|
RUNDOWN_NCS_ |
N/A |
(*) |
|
SEQUENCE |
LOOP |
- |
Sets a running sequence to start looping |
|
STOP_LOOP |
- |
Stops running a looped sequence in loop |
|
STOP |
- |
Stops a running sequence |
|
START |
- |
Restarts a previously stopped sequence |
SET_AUX_CROSSPOINT |
N/A |
(*) |
|
SET_CROSSPOINT |
PP, ME1, ME2, ME3, ME4 AUX Default |
bus (A,B,C,D) : xpoint |
If layers are supported by the driver (e.g. vizrt-ips) it is possible to also specify the layer (A,B,C,D) in addition to the crosspoint. Two arguments are supported separated by semicolon. First parameter is crosspoint, the second is layer. If no semicolon is used the value is interpreted as crosspoint only and bus A is used.
Example: B:CAM2 |
SET_CURRENT_ME |
PP, ME1, ME2, ME3, ME4 AUX Default |
(*) |
|
|
|
|
|
SET_VIDEOSERVER_ |
Select a configured video server from the list |
- |
These same settings are available as keyboard shortcuts, as presented in the Viz Mosart User Guide, under section Viz Mosart User Interface. |
STUDIOSETTUP |
# |
- |
|
SWITCH_GRAPHICS_ |
TOGGLE, ACTIVATE, DE-ACTIVATE |
- |
For standard and Story Recorder (SR) shows. |
SWITCH_GENLOCK_MODE |
TOGGLE, ACTIVATE, DE-ACTIVATE |
|
Story Recorder (SR) specific: SR can only run in Genlock mode. |
SWITCH_REHEARSAL_MODE |
TOGGLE, ACTIVATE, DE-ACTIVATE |
|
Story Recorder (SR) specific: |
SWITCH_VIDEOSERVER_ |
N/A |
- |
For standard and Story Recorder (SR) shows. This command has no parameters, it simply acts as a toggle. |
TAKE_CONTINUE_POINT |
N/A |
(*) |
|
TAKE_SERVER_TO_ |
N/A |
transRate (integer) - parameter. (*) |
Takes a video server port to program on a selected ME. For example: a video clip is running on a video wall. |
TRANSITION_TYPE |
CUT, MIX |
Rate |
|
|
EFFECT |
Effect no |
|
|
TOGGLE |
(*) |
|
UNKNOWN |
N/A |
|
Default fallback. Does nothing. |
VIDEO_PORT |
N/A |
Must be a comma separated list in the format: command,port,parameter |
For example: PLAY_PAUSE,A,PLAY. For more details, see Viz Mosart User Interface > Keyboard Shortcuts > Video Port Control Commands > OVERLAY_TO_MANUAL in the Viz Mosart User Guide). |
VIDEO_SERVER_GOTO |
N/A |
(*) |
|
VIDEOWALLMODE |
N/A |
(*) |
|
WEATHER |
N/A |
(*) |
|
Parameters with Placeholders
Control command parameters can include placeholders which are then populated with values found among the fields of a currently On Air, Viz Mosart item. A placeholder is defined as a string of characters, within curly brackets {placeholder}.
For example, a placeholder can be useful for transmitting values from the NRCS, for use as control commands that will be executed when the template is taken On Air.
Example: Providing the clip name to be recorded from NRCS.
In the NRCS, a column can be created for giving the name of the clip to be recorded with Viz Mosart. Then, in Viz Mosart Newsroom settings, map the column in Story External Metadata as follows:
<mostag mostagname=
"NCScolumn"
mosart_action=
"item_variable"
action_value=
"NCS_filename"
format_type=
"String"
/>
In Manus file, the Mosart item will have the following fields (the value Clip1 is given from the NRCS):
<fields>
<field name=
"NCS_filename"
value=
"Clip1"
/>
</fields>
Then, in Template Editor, the control command for the respective template is configured as follows:
RECORD PREPARE {NCS_filename}_Test,Recorder,RecPort
When the template is executed, a clip with name Clip1_Test is prepared for recording.