Viz Trio User Guide

Version 4.0 | Published September 25, 2023 ©

Command Line Parameters

Use the command line parameters below to customize startup.

Adding a Command Line Parameter

Right-click the program shortcut, and edit the program target path.

Example: C:\Program Files (x86)\vizrt\Viz Trio\trio.exe -mse localhost -control -force_gpu_count 2

Parameter

Value Syntax

Description

-attach_to_viz


Attaches to a running viz.exe without asking the user to terminate it.

If a Viz Engine process is already running locally, this command line option omits the notification "viz.exe is already running. Terminate?" The viz.exe process will always continue and attachment will happen without asking the user to confirm. If there is no Viz Engine process running, Trio will start up its own process as before, regardless of whether the command is present. This command is a flag only and has no parameter value.

-control


Lets you configure Viz Trio.

-folder

showpath

Causes the client to start in the specified show.

-force_gpu_count

integer

Lets the user force/override the available number of GPUs (those detected by Viz Engine) used for the preview and program channels. For example, -force_gpu_count 2 will simulate a Trio OneBox setup on a computer with only one GPU, and automatically start a program engine for output on port 6800.

-local_program_channel_port

integer

Overrides the configured port number set for the local program channel. This is useful if a different port than the default 6800 port needs to be set.

-logfile-path

directory

Folder where log files are stored.

-loglevel

integer

Controls how much is logged to the log file.

-macro-port

integer

Overrides the port of the macro command server. The default port is 6200.

-mse

hostname

Media Sequencer hostname.

-nle-mode


Start Viz Trio in NLE mode.

-no-nle-mode


Start an NLE-compiled Viz Trio in normal (non-NLE) mode.

-scriptloglevel

integer

Controls how much is logged when executing scripts.

-socket


Use socket (TreeTalk) for Media Sequencer communication.

-t

quoted string

Redefines the main window title of Trio. Example:

-t "Viz Trio version %v with current show being %s. The Graphic Hub host is %gh_host and the database is %gh_db"

In the quoted -t parameter, the following strings can be used:

  • %v - version

  • %h - Media Sequencer host

  • %s - current show

  • %gh_host - host name of the Graphic Hub (the nameserver)

  • %gh_db - the name of the Graphic hub database name (usually VizDb)

  • %gh_user - the current GH user

  • %gh_url - the GH REST URL

Default, if -t not specified: "Viz Trio %v - MSE: %h - Show: %s"

-usersetting

settingsname

Uses something other than the hostname as an identifier for user settings.

-viz-console-delay

<time in seconds>

Starts Viz Trio independently of the Viz Engine process, enabling use of Viz Trio before Viz Engine is running. Note that at startup the Viz Engine console is displayed in this mode, which can be used to debug Viz Engine start-up problems.

-vizdb

host:db:user:pw

Configures the Viz Engine 3 database login for the local preview engine.

-vizparams

quoted string

Extra parameters to pass on when starting the local viz engine.

-vizpreview

hostname: port<:protocol>

Connects to an external Viz Engine for preview.

-viz-startup-timeout

integer

Specifies the time-out to use during start-up of Viz Trio when communicating with Viz Engine. The default time-out value is set to 30 seconds. Time-outs during start-up will often leave Viz Trio unusable. After Viz Trio has successfully started up, the time-out setting in the Local Preview is used.