Commands
The commands are grouped as follows:
channelcontrol
Command name and Arguments |
Description |
add_channel (restString channelName) |
Adds a new channel to the active profile. The named channel must not exist. |
get_active_profile |
Returns the name of the active profile. |
get_preview_channel |
Gets the name of the currently configured Viz preview channel. Returns an empty string if no Viz preview channel is defined. |
get_program_channel |
Gets the name of the currently configured Viz program channel. Returns an empty string if no Viz program channel is defined. |
get_video_preview_channel |
Gets the name of the currently configured video preview channel. Returns an empty string if no video preview channel is defined. |
get_video_program_channel(restString channelName) |
Gets the name of the currently configured video program channel. Returns an empty string if no video program channel is defined. |
list_profiles |
Returns a list of existing profiles, separated by line breaks. |
list_video_channels |
Returns all video channels of the current profile as comma separated list. |
list_viz_channels |
Returns all Viz channels of the current profile as comma separated list. |
remove_channel (restString channelName) |
Removes the channel with the given name from the active profile. The channel name must be valid. |
set_active_profile (restString profileName) |
Change the active channel profile. |
set_channel_hosts (string channelname, restString hostlist) |
Changes the list of Viz hosts for a channel. The referenced channel must exist. The list of hosts can be space/comma/semi-colon separated. |
set_preview_channel (restString channelName) |
Changes the Viz preview channel. The channel name must be valid. If empty the Viz preview channel will be undefined. |
set_program_channel (restString channelName) |
Changes the Viz program channel. The channel name must be valid. If empty the Viz program channel will be undefined. |
set_video_channel_hosts(string channelname, restString hostlist) |
Changes the list of video hosts for a channel. The referenced channel must exist. The list of hosts can be space/comma/semi-colon separated. |
set_video_preview_channel(restString channelName) |
Changes the video preview channel. The channel name must be valid. If empty the video preview channel will be undefined. |
set_video_program_channel(restString channelName) |
Changes the video program channel. The channel name must be valid. If empty the video program channel will be undefined. |
wait_vizcmd_to_channel (string channel, restString cmd) |
Sends a Viz Engine command to a named channel and waits for the returned answer. |
commandserver
Command name and Arguments |
Description |
enable_error_messages true or false |
Enables error messages when Viz Trio is controlled over a socket connection. See Working with Macro Commands over a Socket Connection. |
config_settings
Command name and Arguments |
Description |
set_channel_mode (string channel, restString mode) |
Set channel mode. |
single_machine_mode (boolean doSetSingleMachineMode) |
Make trio go to single machine mode. |
dblink
Command name and Arguments |
Description |
link_database (string property key, string connection name, string table name) |
Links a property of a page to a table of a database connection. Example 1: Example 2: 1 refers to the Control List, Chart or Text’s Field Identifier that in Viz Trio can be identified as the template’s tab field 1.
|
map_database_column (string table key, string property column key, string database field name) |
Maps a column of a table property to a database field. Example:
|
select_value (string property key, string value column, string key column, string key value) |
Selects a single value (scalar linking) of a database and links it to the property. The value is selected from the <value column> where the <key column> matches the <key value>. Example:
|
store_to_database (string property key) |
Stores a linked property of a page to its value in the database. Example:
|
update_from_database (string property key) |
Updates a linked property of a page with its value in the database. Example:
|
use_custom_sql (string property key, restString custom SQL) |
Uses a custom SQL clause to select the database value. An empty SQL clause disables the usage of custom SQL. Example:
|
gui
Command name and Arguments |
Description |
add_view (title min max elementTypeList) |
Creates a new view. If called without any parameters, the PageView dialog will be shown.
Example 1: gui:add_view "The Title" 2000 3500 pages stills. This will show pages and stills in the range between 2000 and 3500. Videos will not be shown and empty groups will be hidden. Example 2: gui:add_view title2 videos. This will show all videos, nothing else. |
artist_mode |
Enter design mode (Viz Artist). |
browse_image |
Browse local file system for images. |
change_path |
Shows the directory selector. |
clear_page_field |
Clears the content of the page edit’s text field. |
copy_selected_pages_to_number (restString destnumber) |
Copy the selected pages to number or show a dialog if no number is supplied. |
copy_selected_pages_with_offset (restString destnumber) |
Copy the selected pages with an offset or show a dialog if no number is supplied. |
create_new_show |
Create a new show in the currently selected directory. A unique name is generated and the new show path is returned. |
design_mode |
Enter Trio design mode. |
edit_begin_time |
Shows the in place editor for the selected page. |
edit_end_time |
Shows the in place editor for the selected page. |
edit_group_name |
Shows the in place editor for the selected page. |
edit_page_description |
Shows the in place editor for the selected page. |
edit_page_program_channel |
Shows the in place editor for the selected page. |
edit_scroll |
Show the scroll editor. |
edit_template (restString templateName) |
Edit the specified template in a dialog. This only works for templates in concept-enabled shows. |
error_message (restString message) |
Display an error message in the status bar. The message will also be logged. |
find |
Shows the find dialog. |
focus_active_view |
|
focus_next_view |
|
focus_prev_focused_view |
Focus the previous focused view. |
focus_prev_view |
|
get_callup_code |
Gets the value of the callup code window. |
get_selected_pages |
Retrieves the currently selected pages as a space separated list. |
goto_config |
Opens Viz Trio’s Configuration Interface. |
hide_timecode_monitor |
Hides the TimeCode monitor. See also gui . |
hit_test (x:integer, y:integer) |
Test if a tab field exists on the X,Y coordinate. |
load_image_from_db |
Show the image database browser for the current tab field. |
load_image_from_viz |
Show the viz image browser for the current tab field. |
log_message (restString message) |
Add a message to the logfile. |
move_selected_pages_to_number (restString destnumber) |
Move the selected pages to number or show a dialog if no number is supplied. |
move_selected_pages_with_offset (restString destnumber) |
Move the selected pages with an offset or show a dialog if no number is supplied. |
open_effect_dialog |
This command opens the effect dialog. Will not open if current page is not set. |
playout_mode |
Enter playout mode. |
post_render |
Opens the post render editor. |
prepare_snapshot |
Open the prepare snapshot editor. |
print_selected_pages |
Print the selected pages in the active view. |
read_page_following_last_taken |
Read the page succeeding the page that was last taken. |
reimport_selected_pages |
Reimport the selected pages in the active view. |
select_last_taken_page |
Select the page that was last taken. |
select_nextpage |
Select the next page in the active view. |
select_prevpage |
Select the previous page in the active view. |
select_variant |
Select the variant for the focused element in the page view. |
set_autopreview (boolean autopreview) |
Sets the auto-preview state (single-click read) for page views. |
set_bounding_box (visible:boolean) |
Toggles the bounding boxes for the elements in the preview (same as the BB button). |
set_column_visible (string columnname, boolean active) |
Sets the visiblity of the column. Applies to all pageviews. |
set_focus_to_editor |
Sets focus to the currently active tab field editor. |
set_interactive_mode (boolean active) |
Sets interactive mode which controls whether to show dialogs to the user or not. |
set_run_script_button_enabled (boolean IsEnabled) |
Sets the run script button to enabled/disabled. |
set_safearea (visible:boolean) |
Toggle safe area. |
set_silent_mode (boolean active) |
Sets silent mode which controls whether to show dialogs to the user or not. |
set_statusbar_color (int R, int G, int B) |
Sets the color of the statusbar based on the RBG values given. |
set_titlearea (visible:boolean) |
Toggles the title area in the preview window. |
show_custom_prop_column (boolean value) |
Shows or hides custom property column in tab field list. |
show_export_dialog |
Show the export show dialog. |
show_external_cursor (boolean value) |
Show or hide the external cursor in the page view. |
show_import_dialog |
Show the import show dialog. |
show_pageeditor |
Shows the page editor. |
show_pages_in_rundown (boolean doShow) |
Shows or hides pages in the rundown for the current show. |
show_pageview |
Show the page view. |
show_playlist (string refPath, boolean requestMos, restString description) |
Shows the playlist with the specified path or name. Can choose to request a MOS playlist. Description is optional and defaults to the playlist name. |
show_scripteditor |
Shows the script editor. |
show_scroll_template_creator |
Shows the scroll template creator view. |
show_settings |
Open the show settings view. |
show_shortcut_list |
Show the view of local shortcuts and macros. |
show_showscript_editor |
Shows the show script editor. |
show_status_icons (boolean value) |
Shows or hides status cells in the callup grid. |
show_templates_in_rundown (boolean doShow) |
Shows or hides templates in the rundown for the current show. |
show_timecode_monitor |
Shows the TimeCode Monitor. See also gui . |
show_triocommands |
Toggles the Trio Commands window. |
status_message (restString message) |
Display a text message in the status bar. The message will also be logged. |
take_callup |
Take the current callup number directly, without a read. |
take_snapshot (string path, string handlerName) |
Takes snapshot from the specified handler in RGB format. |
take_snapshot_rgba (string path, string handlerName) |
Takes snapshot from the specified handler in RGBA format. |
toggle_design_mode |
Toggle between Trio design and playout mode. |
toggle_error_message_window |
Toggle the visibility of the error message window. |
toggle_hide_empty_locked_groups (visible:boolean) |
Toggle hide/show empty and locked groups. |
toggle_hide_nameless_groups (visible:boolean) |
Toggle hide/show groups with no name. |
macro
Command name and Arguments |
Description |
export_macros_to_xml (string filename) |
Exports the macro commands to a XML file. |
main
Command name and Arguments |
Description |
apropos (search:string) |
Search command names and descriptions for a string. |
call_macro (restString name) |
Call (invoke) a named macro. |
define_local_macro (string name, restString commands) |
Define a named, local macro. |
define_local_script (string name, restString commands) |
Define a named, local script. |
define_macro (string name, restString commands) |
Define a named, global macro. |
define_script (string name, restString commands) |
Define a named, global script. |
delete_global_macro (name:string) |
Delete a global macro. |
delete_local_macro (name:string) |
Delete a local macro. |
get_global_macros |
List the names of global macros (separated by new lines). |
get_local_macros |
List the names of local macros (separated by new lines). |
get_shows |
Get the names of all the shows in the client |
get_version |
Get a version string. |
help (command:string) |
Shows help for the specified command, or lists commands. |
macro |
page
Command name and Arguments |
Description |
arm (pageName:string, channelName: string) |
Arms the specified page on the specified channel. If channelName is empty, the default channel is used. |
arm_current (channelName:string) |
Arms the currently read page on its specified program channel. If channelName is empty, the default channel is used. |
cancel_refresh_linked_data (page name (optional)) |
Cancel refreshing of linked data, started with the \qpage:refresh_linked_data_async\q command. |
change_channel ("string FromChannel, string ToChannel, boolean All) |
Switch from "FromChannel" to "ToChannel". "All" will change all elements using "FromChannel". |
change_description (string pageNr, restString desc) |
Sets the page description. |
change_template (string templateName) |
Changes the template of the selected pages. Empty parameter("") will take the number in the callup field and use that as the template ID. |
change_template_for_pages (string templateName, restString pages) |
Changes the template of the given pages. |
change_variable (string variable, restString value) |
Change the variant for the currently edited page. |
continue (restString pageNr) |
Continues the page specified as parameter or the selected if the parameter is empty. |
cue (restString pageNr) |
Cues the page specified as parameter or the selected if the parameter is empty. |
cue_append (pageNr:string) |
Only applicaple to videos. Cues the video after the currently playing video. Specify a page as parameter or no parameter for the currently read video. |
cut (pageNr:integer) |
Cuts the current template or page or the page specified. |
delete_page |
Delete selected page(s) in active view. |
delete_pagerange (int start, int end) |
Deletes the page inside from the begin range to (including) the end range parameter. |
direct_continue |
Continue selected page in active view. |
direct_cut |
Cut selected page in active view. |
direct_take |
Take selected page in active view. |
direct_takeout |
Take out selected page in active view. |
export_property (string key, string filename) |
Export a property value to file (UTF-8 encoded). |
fire (channelName:string, action:string, clearAfterFire:boolean) |
Fire a channel with the given action (take, continue, out, and so on). If clearAfterFire is true, the armed element on the channel is un-armed after fire. |
fire_all (action:string, clearAfterFire:boolean) |
Fire all armed channels with the given action (take, continue, out, and so on). If clearAfterFire is true, the armed elements on the channels are un-armed after fire. |
get_current_propertykey |
Get the current property-key. |
get_current_tabfield_name |
Get the name of the current tab field. |
get_layers (string page) |
Will get the layer name(s) the combination or transition logic page is based on, hence, this command is not valid for pages based on standalone scenes (returns an empty string). |
get_program_pagechannel (restString pageid) |
Gets the program channel for the page. |
get_property (string name) |
|
get_tabfield_count |
Gets the number of tab field on the current page. |
get_template_description (string page) |
Gets the template description for the page specified. |
get_viz_layer (restString page) |
Gets the viz layer for a page. If no page name is supplied, current page is used. Only valid for scene-based pages. |
getpagedescription |
Get the description of the current page. |
getpagename |
Get the name of the current page. |
getpagetemplate |
Get the template of the current page. |
import_property (string key, string filename) |
Import a property value from file (UTF-8 encoded). |
load_page_data (filename:string (optional)) |
Load page data from XML. |
pause (pageNr:string) |
Only applicable to videos. Pauses the video. Specify a page as parameter or no parameter for the currently read video. |
prepare (pageNr:string) |
Prepares the page specified as parameter or the currently read if the parameter is empty. |
|
Print the current page. Use settings printer/left_margin, printer/right_margin, printer/top_margin, printer/bottom_margin to control the size, where the value is the percent of the page width/height. |
read (pageNr:integer) |
Reads the specified page number. |
read_parentpage |
|
read_rootpage |
|
read_subpage (string string) |
|
read_template (string templateid) |
Reads a template if concepts and variants are enabled. If not, read a normal template. |
read_template_with_context (string template, string contextPairs) |
Reads a template with context variables that can override the show settings. The context is given a whitespace-separated list of keys and values. |
readnext |
Read next element in active view. |
readprevious |
Read previous element in active view. |
redo |
Redo edit in current page history. |
refresh_linked_data (page name (optional)) |
Refresh linked data if the page has any tabfields that are linked to data from an external source. |
refresh_linked_data_async (page name (optional)) |
Start refreshing linked data if the page has any tabfields that are linked to data from an external source. The refresh can be cancelled with the \qpage:cancel_refresh_linked_data\q command. |
run_command_with_variables_on_channel (string command, string channel, restString variables) |
Run a command (for example a take) on a page with variables to a specific channel. |
save |
Saves current page. |
save_page_data (filename:string (optional), version:string (optional, defaults to 2.6)) |
Save page data as XML in specified version (2.5 or 2.6). |
save_scene |
Save current page as a new Viz scene. |
saveas ([pageNr:integer]) |
Triggers the save as action for a template or page, saving it with the page number as parameter. If no parameter is given, the callup code will be set to the next page number available; however, the page will not be saved. |
set_default_effect (string effect) |
Sets the default transition effect to be used between (scene-based) pages. Empty string specifies hard cuts (default). |
set_effect (restString effect) |
Sets the transition effect to be used between (scene-based) pages. Empty string specifies hard cuts (default). |
set_effect_on_selected (string effect) |
Sets the transition effect to be used between (scene-based) pages on the currently selected one. Empty string specifies hard cuts (default). |
set_expert_mode_enabled (boolean enabled) |
Enable or disable "expert mode" for the current page. This enables all tab field properties to be accessed instead of a filtered subset. |
set_pagestatus (status: string) |
Set the status of the selected pages. Valid arguments: FINISHED/UNFINISHED/NONE. |
set_pagestatus_one (pagenr: integer, status: string) |
Set the status of page. Valid status arguments: FINISHED/UNFINISHED/NONE. |
set_pagetime (string pageid, string type, string value) |
Sets the begin/end time for the page specified. |
set_program_pagechannel (string pageid, restString channelname) |
Sets the program channel for the page. |
set_property (string name, restString value) |
Set the value of a named tab field property. |
setpagetemplate (string templateName) |
Change the template of the current page. |
store |
Save the page with the name given in the read page edit field (the left one). |
tab |
Tab to the next tab field. |
tab_backwards |
Tab to the previous tab field. |
tabto (tabfieldnr:integer) |
Go to a specific tab-field number. |
tabtotabfield (tabfieldname:string) |
Go to a specific tab-field number. |
take (pageNr:integer) |
Does a take on the current template or page or on page specified. |
take_exchange |
Take current page and read the last page that was taken. |
take_with_variables (restString variables) |
Take a page with variables. |
take_with_variables_on_channel |
Take current page and read next page in active view. |
takenext |
Take current page and read next page in active view. |
takeout (pageNr:integer) |
Take out current template or page or template or page specified. |
unarm (channelName:string) |
Unarms the specified channel. |
unarm_current |
Unarms the currently read page on the channel it is armed. |
unarm_all |
Un-arms all armed pages. |
undo |
Undo edit in current page history. |
update |
Update the program renderer (do a take without animating it in). |
update_preview |
Update the external preview renderer with the contents of the local preview. |
playlist
Command name and Arguments |
Description |
add_page (string pagename, restString duration) |
Add a page to the end of the playlist. The duration argument is optional. If not given, the page duration will be used. |
create_playlist (string name) |
Adds a new empty global playlist and returns the path to the new playlist. The name of the playlist is optional. If not specified, a dialog will pop up to ask for it. The new playlist will show up in the "playlists" in the "Change Show" dialog. |
direct_take_out_selected |
|
direct_take_selected |
|
go_to_next_story |
Select the next story (group) in the active playlist. |
go_to_previous_story |
Select the previous story (group) in the active playlist. |
goto_manual_graphics_mode (restString enable) |
Enable/disable manual playout of graphic elements. Use "true" or "" for manual and "false" for automatic mode. |
initialize_playlist |
Initialize the playlist (load graphics) on the external output channels. |
jump_to_ncs_cursor |
Jump to the element that the NCS-cursor (newsroom control system) is pointing to. |
pause_carousel |
Pause the carousel. |
read_next_item |
Read the next playlist item. |
read_prev_item |
Read the previous playlist item. |
read_selected |
Read the currently selected playlist element. |
run_selected_with_custom_action (string Action) |
This macro command is generic and can append any Media Sequencer command as a parameter for playing out selected graphics and/or video clip elements in any playlist. Example:
Note that if you have a version of the Media Sequencer that is newer than the version released with your version of Viz Trio, you can still use new commands supported by the Media Sequencer by using this macro command. |
select_first |
Select the first element in the playlist. |
select_next |
Select the next element in the active playlist. |
select_next_by_description (restString phrase) |
Selects the next element in the active playlist which has the given phrase in its description. |
select_previous |
Select the previous element in the active playlist. |
set_attribute_on_selected (string attribute, restString value) |
Sets an attribute on all the selected items in a playlist. |
set_concept (string value) |
Set the concept for a show. |
set_looping (restString looping TRUE or FALSE) |
Set to true if the carousel shall be looping. |
start_carousel (playlist name or id (optional, defaults to active playlist)) |
Run the elements in the playlist as a carousel. |
stop_carousel (playlist name or id (optional, defaults to active playlist)) |
Stop a playlist running as a carousel. |
proxy
Command name and Arguments |
Description |
enable_viz_proxy (boolean enable) |
Enables/disables Trio acting as a Viz Proxy on the port configured. |
set_proxy_port (int port) |
Set the port that Trio should listen on. |
set_viz_host (string host) |
Set the host where the proxy can locate Viz. |
set_viz_port (int port) |
Set the port the proxy should use to access Viz. |
rundown
Command name and Arguments |
Description |
go_to_next_story |
Sets focus on the next story/group in the active rundown. |
go_to_previous_story |
Sets focus on the previous story/group in the active rundown. |
reload_template_images (restString templates) |
Comma separated list of template IDs. |
script
Command name and Arguments |
Description |
eval (restString scriptExpression) |
Evaluate the VBScript expression given as a parameter, and return the value converted to a string. |
execute_script |
Execute the script of the current page. |
get_showscript_name |
Gets the name of the current show\qs script. |
import_script (string scriptName, restString scriptFilename) |
Imports the script into the current show. |
run_macro_script (restString scriptCode) |
Run the VBScript script code given as a parameter. The snippet can contain multiple lines of code. The macro will return either an empty string or an error message. |
run_script (string scriptFunction, restString argumentList) |
Run the specified script function. The argument list is a list of strings separated by commas or white space. Arguments that can contain commas or white space must be enclosed by double quotes. |
run_showscript (string scriptFunction, restString argumentList) |
Run the script associated with the current show. The argument list is a list of strings separated by commas or white space. Arguments that can contain commas or white space must be enclosed by double quotes. |
scroll
Command name and Arguments |
Description |
scroll_add_range (index:integer, ranges:string) |
Insert one or more ranges of elements into scroll at index. Use index -1 to insert at end. |
scroll_clear |
Clear all scroll data, including scroll elements. |
scroll_element_parameter (index:integer,name:string,value(s):variant) |
Set a parameter on the scroll element at index. Supported parameters are: [page (string): set the page name, will refresh element] [space_before (float): extra space before this element, accumulates with padding] [space_after (float): extra space after this element, accumulates with padding] [scaling (two floats): set scaling in X and Y direction] [position (two floats): position adjustment in X and Y direction]. |
scroll_insert_elements (index:integer, pages:string) |
Insert elements into scroll at index. Use index -1 to insert at end. |
scroll_move_element (from_index,to_index:integer) |
Move scroll element from from_index to to_index. |
scroll_refresh_all |
Refresh all scroll elements. Also refreshes end page and background page. |
scroll_refresh_element (index:integer) |
Refresh scroll element at index. This will refresh both the viz object and the data. |
scroll_remove_all |
Remove all scroll elements. This will not clear other scroll parameters. |
scroll_remove_element (index:integer) |
Remove scroll element at index. |
scroll_select_element (index:integer) |
Select a scroll element. Use index -1 to clear the selection. |
scroll_set_endpage (page:string,offset:float(optional)) |
Set the scroll end page, and (optionally) the end page offset. |
scroll_set_endpage_offset (offset:float) |
Set the end page offset, in seconds from end of scroll animation. |
set_scroll_parameter (name:string,value(s):variant) |
Set a scroll parameter. The supported parameters are: [direction (up/down/left/right): the scroll direction] [padding (float): padding between elements] [alignment (none/left/right/bottom/top): left/right or bottom/top alignment, depending on direction] [alignment_offset (float): alignment offset in percentage of screen size] [background_page (string): name of background page] [use_pixel_speed (boolean): if true, scroll will use pixel speed] [pixel_speed (float): number of pixels per frame (takes effect if use_pixel_speed is true)] [duration (float): duration of scroll animation (takes effect if use_pixel_speed is false)] [start_offset (float): start offset of scroll in percentage of screen size] [pause_at_start (boolean): pause scroll animation at start] [viz_layer (front/main/back): viz layer for scroll scene]. |
scroll2
Command name and Arguments |
Description |
add_easepoint (string pagename) |
|
clear_elements |
Clear scroll elements (remove all). |
copy_element (int sourceIndex, int targetIndex) |
Add a copy of scroll element at sourceIndex to targetIndex. |
create_scroll_template (string sceneName, string templateDescription, float width, float height, boolean showBounds) |
Create a new scroll template with the given paramters. |
edit_easepoint (string subpage, string easepoint) |
Edit an easepoint in the current scroll. |
insert_objects (int index, restString objects) |
Insert SCENE or GEOM objects from viz into the current scroll. |
insert_pages (int index, restString pages) |
Insert pages from current show into current scroll at index. |
insert_range (int index, string range) |
Insert an inclusive numerical range of pages (e.g 1000-2000) from the current show, or a single page. |
move_element (int sourceIndex, int targetIndex) |
Move scroll element from sourceIndex to targetIndex. |
next_easepoint |
Go to next ease point editor. |
next_element_data |
Go to next element data (extra spacing) editor. |
preview_continue |
Continue the current scroll in preview. |
preview_start |
Start the current scroll in preview. |
preview_stop |
Stop the current scroll in preview. |
previous_easepoint |
Go to previous ease point editor. |
previous_element_data |
Go to previous element data (extra spacing) editor. |
program_continue |
Continue the current scroll on the program channel (must be taken on-air first). |
program_start |
Start the current scroll on the program channel (must be taken on-air first). |
program_stop |
Stop the current scroll on the program channel (must be taken on-air first). |
reload_all_page_data |
Reload all scroll page data by copying from original pages. |
reload_page_data (int index) |
Reload scroll page data at index by copying from original page. |
reload_template_graphics |
Reload all scroll elements (reload geometry objects created during import of templates). |
reload_templates |
Reload all scroll elements by merging with the current show templates. |
remove_easepoint (string subpage, string easepoint) |
Remove a named easepoint in the current scroll. |
remove_element (int index) |
Remove scroll element at index. |
rename_easepoint (string subpage, string oldName, string newName) |
Rename an easepoint in the current scroll. |
set_focus (int index) |
Focus on scroll element. |
settings
Command name and Arguments |
Description |
get_setting (string path) |
Gets a Viz setting. |
set_global_setting |
Sets a global Viz setting (e.g. |
set_setting (string path, restString value) |
Sets a Viz setting. |
show
Command name and Arguments |
Description |
append_pages_from_xml (boolean showDialogs, string filename) |
Loads pages from XML and replaces any pages that will be overwritten. |
copy_pages (page list) |
Copies the given page(s) to the clipboard |
copy_pages_to_number (int destination, restString CommaSeperatedList) |
Copy the pages to a destination number. |
copy_pages_with_offset (int offset, int CommaSeperatedList) |
Copy the pages to a destination number. |
create_combo_page (string pagelist) |
Create a combo page. |
create_dir (restString path) |
Creates the specified show directory. |
create_group (string groupname) |
Create a page group in the current show, before the focused node. |
create_playlist (restString name) |
Adds a new playlist to the show and returns the path to the new playlist. If name is omitted, a dialog will pop up asking for a name. |
create_show (string path, restString EnableContext) |
Create a new show. If EnableContext is not "false" then a context-enabled show is created. |
cut_pages (page list) |
Cuts the given page(s) to the clipboard. |
delete_all_pages |
Deletes all the pages in the page view. |
delete_templates (restString templateList) |
Delete the given templates from the current show. Does nothing if the show does not have concepts and variants enabled. |
enable_context |
Enable concept/variant for the current show. |
export_setting (string name, restString value) |
Configure an export setting, use this before export_show. |
export_show (filename:string) |
Export a show (trio archive). |
get_all_timing_handlers |
Returns a comma separated list of all timing handlers. |
get_associated_files |
Get the list of associated files for the show |
get_background_scenes |
Get a space-separated list of background scenes in the show. |
get_concept |
Get the show-concept. |
get_context_variable (string variable) |
Get the show-context-variable. |
get_custom_colors |
Get the custom colors for the current show. |
get_default_viz_path |
Get the default viz scene path for the current show. |
get_group_pages |
Returns a list of pages in the specified group. |
get_groups |
Returns a list of groups in the current show. |
get_library_path |
Get the default viz scene path for the current show. |
get_page_xml(restString page_path) |
Get the xml for the specified page. The path is given as showpath/<page-id> (e.g. |
get_pages |
Returns a list of pages in the current show. |
get_preview_background_image |
Get the Preview background image for the current show. |
get_scenes_for_pages (restString pagelist) |
Get the list of scenes for the given pages. |
get_setting (string path) |
Get a show setting. |
get_settings |
Get all settings. |
get_show_description |
Get the description of the current show. |
get_show_name |
Get the name of the current show. |
get_timing_handler |
Returns the timing handler for the current show. |
get_variable (string propname) |
Get the value of a show variable. |
get_variant |
Get the show-variant. |
goto_viz_dir (path:string) |
Change to a show with the same name as a viz directory, creating it if necessary. |
import (scenes:string) |
Shows the Import Scenes pane or imports specified scene(s). |
import_and_initialize (scenes:string) |
Import scenes to templates, then reload on external renderers. |
import_no_gui (restString sceneNames) |
Imports the scenes given as parameter without showing/closing the import GUI. |
import_pages_from_xml (string filename, int offset, boolean interactive, boolean pageNames) |
Import the named pages from an XML file. An offset different from zero will cause pages with numerical names to be offset by this number, unless they are templates. Pages are overwritten automatically if interactive is false. |
import_recursively (string path) |
Import all the scenes recursively from this folder. |
import_setting (string name, restString value) |
Configure an import setting, use this before import_show. |
import_show (filename:string) |
Import a show (Viz Trio archive). |
load_locally |
Loads all scenes referenced by pages in the current show on the local viz preview. |
load_show |
Load show (scenes, textures, fonts) on external output channels. Replaces the old initialize command. |
load_show_on_renderers (string ProgramChannelName, restString PreviewChannelName) |
Load current show on the specified channels. First argument is treated as a program channel, second as preview. |
move_pages_to_group (string group, restString pages) |
Move pages into the specified group. If the group name is empty, move to top level. |
move_pages_to_number (int destination, restString CommaSeperatedList) |
Copy the pages to a destination number. |
move_pages_with_offset (int destination, int CommaSeperatedList) |
Move the pages with an offset. |
paste_pages |
Pastes the given page(s) from the clipboard to the current show. |
page_exists (restString page) |
Checks if a page with the specified name exists in the current show. Returns "true" or "false". |
reload_on_renderers (restString pages) |
Reload (re-initialize) graphics for the specified pages on program and preview channels. |
rename_page (string old_name, restString new_name) |
Sets a new name for the page. If a new name is not defined, a dialog appears asking for the new name. |
run_show (boolean b) |
Runs/stops the show. |
save_pages (string FileName, restString CommaSeperatedList) |
Saves the pages given as parameter to XML. |
save_pages_to_xml (string filename) |
Saves pages to XML. |
save_selected_pages (restString fileName) |
Saves the selected pages to XML. |
set_associated_files (restString filelist) |
Set the associated files for the show. ("file1" "file2" "file3"). |
set_concept (restString concept) |
Set the show-concept to a new value. |
set_context_variable (string variable, restString value) |
Set the show-variant to a new value. |
set_custom_colors (restString colors) |
Set the custom colors for the current show. |
set_default_viz_path (path:string) |
Set the default viz scene path for the current show. |
set_dir (restString path) |
Changes the show directory to the path specified. |
set_external_cursor (restString pagename) |
Set the external cursor to page with page name or to current page if page name is empty. |
set_library_path (restString path) |
Set the design-library path. |
set_preview_background_image (path:string) |
Set the preview background image for the current show. |
set_setting (string path, restString value) |
Set a show setting. |
set_show_description (description:string) |
Set the description of the current show. |
set_show_name (name:string) |
Set the name of the current show. |
set_timing_handler (string handlerName) |
Set the timing handler for the current show. |
set_variable (string propname, restString value) |
Set the value of a show variable. The value is stored on the Media Sequencer. |
set_variant (restString variant) |
Set the show-variant to a new value. |
show_export_dialog_for_path (restString showpath) |
Exports the show. |
sock
Command name and Arguments |
Description |
connect_socket |
Explicitly connect (open) the socket, if not already connected. |
disconnect_socket |
Disconnect (close) the socket, if connected. |
send_socket_data (restString text) |
Send UTF-8 encoded text over the socket. If it is a server socket, send to all clients. |
set_com_baud (int comBaudRate) |
Set baud rate to use for the serial port. |
set_com_number (int comPortNumber) |
Set COM port number to use for the serial port. |
set_socket_autoconnect (boolean autoconnect) |
If auto-connect is true, a client socket will be connected the first time data is sent, or a server socket will be opened automatically. |
set_socket_data_separator (string separator) |
Set the separator for the OnSocketDataReceived callback. |
set_socket_encoding (string encoding) |
Set text encoding for socket to either UTF-8 or ISO-8859-1. |
set_socket_host (string hostname) |
Set the socket hostname. Does nothing if the socket type is server. |
set_socket_port (int port) |
Set the socket port number. |
set_socket_type (string type) |
Set the socket type to client or server. |
socket_is_connected |
Returns true if the socket is connected, false otherwise. |
tabfield
Command name and Arguments |
Description |
active (active:string) |
Toggle active flag of current tab field or set its value (0 or 1). |
browse_file |
|
clock |
Change to clock editor of current tab field or set its value (string). |
downcase_tabfield |
Convert current tab field to lower case, if it contains text. |
edit_property (string propertyName) |
Changes editor to the specified property i.e 1.image. |
geom (vizPath:string) |
Change to geometry editor of current tab field or set its value (GEOM*path). |
get_custom_property (string tabfieldName) |
Gets the custom property of the tab field. "" will get it for the current tab field. |
get_tabfield_property (tabfieldnr:integer,property:string) |
Gets a property value for a given tab field. |
image (vizPath:string) |
Change to image editor of current tab field or set its value (IMAGE*path or filename). |
image_position |
Change to image position editor of current tab field or set its value (two floats). |
image_scaling |
Change to image scaling editor of current tab field or set its value (two floats). |
import_value_from_file (restString filename) |
Load a tab field value from a text file (UTF-8 encoded). |
kerning (value:float) |
Change to kerning editor of current tab field or set its value (float). |
material (vizPath:string) |
Change to material editor of current tab field or set its value (MATERIAL*path). |
next_property |
Select the next property of the current tab field, or the first if the last one is currently selected. |
position (value:float) |
Change to position editor of current tab field or set its value (floats). |
previous_property |
Select the previous property of the current tab field, or the last if the first one is currently selected. |
rotation (value:float) |
Change to rotation editor of current tab field or set its value (floats). |
scaling (value:float) |
Change to scaling editor of current tab field or set its value (float). |
set_custom_property (string tabfieldName, string value) |
Sets the custom property of the tab field. "" as tab-field name will use the current tab field. |
set_tabfield_property (prop:string, value:string) |
Set a property value. |
set_value (value:string) |
Sets the value of the current tab-field property. |
text (value:string) |
Change to text editor of current tab field or set its value (unicode string). |
toggle_current_custom_property (string value1, string value2) |
Toggle the custom property of the current tab field between the two given values. |
upcase_tabfield |
Convert current tab field to upper case, if it contains text. |
value |
Change to default editor. |
table
Command name and Arguments |
Description |
clear_sorting (string table key) |
Clear the sorted state of a table property. |
delete_rows (string table key, string row index list) |
Delete a number of rows from a table property. |
get_cell_value (string table key, string column key, int row num) |
Get a cell value of a table property. |
insert_rows (string table key, int row index, int number of rows to insert) |
Insert a number of rows into a table property. |
move_current_row_down |
Move the selected row in the current table editor one step downwards. |
move_current_row_up |
Move the selected row in the current table editor one step upwards. |
move_row (string table key, int row index to move, int target row index) |
Move a row downwards behind the target row or upwards before the target row. |
set_cell_value (string table key, string column key, int row num, restString new value) |
Set a cell value of a table property. |
sort_column (<table key> <column key> [ascending or descending] (optional, default: ascending)) |
Sort a table ascending or descending after a column. |
text
Command name and Arguments |
Description |
incr_alpha (string key, string selectionStart, string selectionEnd, float alpha) |
Increment or decrement the transparency of selected text. |
incr_kerning (string key, string selectionStart, string selectionEnd, float kerning) |
Increment or decrement the kerning of selected text. |
incr_position (string key, string selectionStart, string selectionEnd, float posX, float posY, float posZ) |
Increment or decrement the position of selected text. |
incr_rotation (string key, string selectionStart, string selectionEnd, float rotX, float rotY, float rotZ) |
Increment or decrement the rotation of selected text. |
incr_scale (string key, string selectionStart, string selectionEnd, float scaleX, float scaleY, float scaleZ) |
Increment or decrement the scaling of selected text. |
revert (string key) |
Revert current text to saved value. |
set_alpha_mode |
Set text manipulation mode to Alpha. |
set_color (string key, string selectionStart, string selectionEnd, string color) |
Change the color of selected text. |
set_color_mode |
Set text manipulation mode to Color. |
set_justification (string key, string justification) |
Set the text justification (LEFT, CENTER, RIGHT). |
set_kerning_mode |
Set text manipulation mode to Kerning. |
set_position_mode |
Set text manipulation mode to Kerning. |
set_rotate_xy_mode |
Set text manipulation mode to Rotate x and y. |
set_rotate_z_mode |
Set text manipulation mode to Rotate z. |
set_scale_mode |
Set text manipulation mode to Scale. |
show_replace_list |
Shows the pre-configured character palette for the character to the left of the cursor. |
trio
Command name and Arguments |
Description |
assign_script (string page, boolean fileScript, restString scriptunit) |
Assign or change the script for the specified page. |
cleanup_all_channels |
Cleans up all channels in the current profile by clearing Viz layers and freeing memory. Does not clear the channel for transition logic pages. |
cleanup_channel (restString channelname) |
Cleans up the specified channel by clearing Viz layers and freeing memory.
Note: The |
cleanup_renderers |
Cleans up Viz program and preview channels by clearing Viz layers and freeing memory. |
clear_preview |
Cleans up Viz preview channel by clearing Viz layers and freeing memory. |
clear_program |
Cleans up Viz program channel by clearing Viz layers and freeing memory. |
continue_last_taken_page |
Continue the page that was last taken. |
create_snapshot_page |
Takes a snapshot and creates a page with that snapshot. |
display_imported_archives |
Display a list of the imported trio-archives. |
exchange |
Exchange the content of the program and external preview. |
exit |
Close the Trio. |
freeze_program_clock (string string) |
Freeze a clock on the program machine. |
get_global_variable (string propname) |
Get the value of a global variable. |
get_next_savenumber |
Get the number that will be proposed on the next save as or with a create_snapshot_page. |
help |
Opens the Viz Trio user’s guide. The help file is also opened by clicking the Help button in the user interface (next to Config), or by pressing the F1 key unless it has been assigned to another action (e.g. macro). See also General settings. |
initialize_show_or_playlist |
Initialize current show or playlist on external renderers. |
invoke_with_current_page (string commandName) |
Invoke the given command with the name of the current page as a parameter (useful for macro shortcuts). |
invoke_with_current_scene (string commandName) |
Invoke the given command with the name of the current scene as a parameter (useful for macro shortcuts). |
offair |
Set client in off-air mode. |
onair |
Set client in on-air mode. |
open_printsettings_dialog (restString pages) |
Open the printer-settings dialog. |
print_and_save_snapshots (restString pages) |
Print the pages. Use settings printer/left_margin, printer/right_margin, printer/top_margin, printer/bottom_margin to control the size, where the value is the percent of the page width/height. |
print_snapshots (restString pages) |
Print the pages. Use settings printer/left_margin, printer/right_margin, printer/top_margin, printer/bottom_margin to control the size, where the value is the percent of the page width/height. With no argument, the content of the preview is printed. |
process_ii_string (restString value) |
Sends a string to the intelligent interface handler on the Media Sequencer and lets it process it. |
restart_local_viz |
Restarts the local Viz preview channel. |
restart_local_viz_program |
Restarts the local Viz program channel. Only available when local program channel has been started. |
save_snapshots (restString pages) |
Print the pages. Use settings printer/left_margin, printer/right_margin, printer/top_margin, printer/bottom_margin to control the size, where the value is the percent of the page width/height. |
send_local_vizcmd (command:string) |
Send a Viz command to the local viz preview. |
send_preview_vizcmd (command:string) |
Send a Viz command to the preview renderer. |
send_preview_vizcmd_noerror (restString command) |
Send a Viz command to the preview renderer if possible, otherwise do nothing (no error message). |
send_vizcmd (command:string) |
Send a Viz command to the program renderer. |
send_vizcmd_to_channel (string channelName, restString command) |
Send a Viz command to a specified channel. |
set_global_variable (string propname, restString value) |
Set the value of a global property. The value is stored on the Media Sequencer. |
set_mcu_folder (string string) |
Sets the folder of the MCU/AVS plug-in. |
set_vizconnection_timeout (int timeout) |
Set the Viz connection timeout. |
show_trio_settings_dialog |
Show dialog containing a tree view of Trio settings. |
sleep (int millisec) |
Sleeps a page a certain amount of milliseconds. For example:
|
swap_channels |
Swap the program and preview channels. |
synchronize_clocks |
Synchronize the clocks to the clocks on the program renderer. |
takeout_last_taken_page |
Continue the page that was last taken. |
unfreeze_program_clock (string string) |
Freeze a clock on the program machine. |
util
Command name and Arguments |
Description |
get_node_text (string string) |
Gets the node text of a Media Sequencer node. |
list_archive_files (filename:string) |
Returns a list of files in a trio archive (will also work for other tar files). |
list_archive_pages (filename:string) |
Returns a list of pages in a trio archive (creates a list of all_pages.xml within the Viz Trio archive). |
list_archive_parameters (restString filename) |
Returns a list of parameters of a trio archive. |
list_xml_pages (restString filename) |
Returns a list of pages in an XML file. |
run_mse_entry (string path) |
Runs the node at the specified path. No context is given. |
set_node_text (string path, restString value) |
Sets the node text of a Media Sequencer node. |
viz
Command name and Arguments |
Description |
continue |
Continue the animation in viz preview (if stopped). |
import_image_from_file (string filename, restString pool folder) |
Import the given image file into the given viz image pool folder. |
play |
Start (play) the animation in viz preview. |
reload_data_locally (boolean paths) |
Reload viz resources locally. The space-separated list of paths must include the pool prefix and full path, e.g. SCENE*folder/name. |
set_bounding_box (boolean visible) |
Toggle bounding box visibility. |
set_key_alpha |
Viz Artist setting. |
set_key_preview |
Viz Artist setting. |
set_rgb |
Viz Artist setting. |
set_safearea (boolean visible) |
Toggle safe area visibility. |
set_stage_pos (restString pos) |
Set the current stage position. |
set_titlearea (boolean visible) |
Toggle title area visibility. |
stop |
Stop the animation in viz preview. |
vtwtemplate
Command name and Arguments |
Description |
get_template |
Gets the VTW template for the current show. |
import_template (string ScriptName, restString FileName) |
Imports a template from file to the current show. Overwrites any template with the same name. |
reimport_active_template |
Reimports the active VTW template for the current show. |
run_vtw_function (string functionName, restString argumentList) |
Runs a script function in the active VTW template. The argument list is a list of strings separated by commas or white space. Arguments that can contain commas or white space must be enclosed by double quotes. |
run_vtw_script (string FunctionName, restString Data) |
Runs a script function in the active VTW template. Only a single parameter is supported by the Data parameter, so use vtwtemplate:run_vtw_function instead if possible. |
set_template (restString templateName) |
Sets the VTW template for the current show. |