A Mosart control command can be triggered from a template, executed when the template is Taken, at Continue points or when the template is Taken out.

Working with Control Commands
Command Values and Parameters
- Parameters with Placeholders

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

Controlling Video Servers

This is done via the Control Command page within the Template properties.
images/download/attachments/81465441/controVS.png

The figure above shows a single 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 attribute 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 Command On Take, Continue Points and Command on Take Out.
Refer to the table Command Values and Parameters for command details.

images/download/attachments/81465441/templates_template-properties.png

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 setting a Newsroom tag as a parameter in the OnTake-commands, the user can set the parameter from the NCS. When the user is using the ActiveX to add a template to the rundown, a text box is visible, requesting this value.

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 control command continue-point is then automatically taken after that time.

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. The 'DEVICE_PROPERTY' control command with value 'CAMERA CONTROL' is only used as a way to set speed (Camerobot) and presenter (Camerobot/FxMotion) 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 ‘,’. Examples: ANCHOR=2:David which means position1: 2, presenter1: David ANCHOR=2:David,3:Mark which means position1: 2, presenter1: David, position2: 3, presenter2: Mark
	AUDIO	demands <fields> structure as parameter with parameter1=AUDIO, parmeter2=key, parameter3=value OR connectionstring style	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] (Example: 2: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] (Example: 1:ON) OR controller:camera:[ON\|OFF\|TOGGLE] (Example: 1:2:ON)	ON/OFF/TOGGLE: As above, applied to all cameras on all controllers. If a controller (but no camera) is given, only the cameras on the designated controller are affected. If both a controller and a camera is given, only the designated camera is affected.
DEVICE_STANDBY	OVERLAY_GRAPHICS		Has no effect
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

COMMAND	Value	Parameter	Description
ENABLE_GRAPHICS_ MIRRORING	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. The number of continue points is taken from the graphics_continuecount field. Examples: AUTO+1: The number of continue counts from the graphics + 1 AUTO-2: The number of continue counts from the graphics - 2
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_ TRANSITION	N/A	-
HOLD_VIDEO_ TRANSITION	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 Min. Cue delay in AV Automation Devices Vision Mixer Next cue delay in Audio and Video Setup, Vision Mixer Effects Configurations, Settings (if an effect is involved)).
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_ RESYNC	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_ SALVO	N/A	(*)	Not implemented for templates
STUDIOSETTUP	#	-
SWITCH_GRAPHICS_ MIRRORING	TOGGLE, ACTIVATE, DE-ACTIVATE	-
SWITCH_VIDEOSERVER_ MIRRORING	N/A	(*)	Not implemented for templates
TAKE_CONTINUE_POINT	N/A	(*)
TAKE_SERVER_TO_ PROGRAM	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. The shortcut can then be used to take the last used/active video server to program.
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 NCS, 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 NCS.

In NCS, 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:

Story External Metadata

<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 NCS):

Mosart Item

<fields>
     <field name="NCS_filename" value="Clip1" />
</fields>

Then, in Template Editor, the control command for the respective template is configured as follows:

Control Command

RECORD PREPARE {NCS_filename}_Test,Recorder,RecPort

When the template is executed, a clip with name Clip1_Test is prepared for recording.

Viz Mosart Administrator Guide

Control Commands in Templates