Viz Pilot User Guide
Version 8.7 | Published September 25, 2023 ©
Initialization and Configuration Files
The initialization files in the table below are used with the Viz Pilot system. Modified files are stored in %PROGRAMDATA%\Vizrt\Viz Pilot x.y\Config
File |
Description |
ContentPilot.ini |
Most Viz Pilot components use this .ini file. The default file is stored in the program folder during installation as ContentPilot.ini. See ContentPilot.ini |
objectstore.ini |
Object Store may use its own ini file for reading and connecting to the Viz Pilot database. See Object Store Initialization File. |
In most cases, you can use the Changing Settings to make changes to the INI files. If required, they can be opened with a regular text editor, however, this is strongly discouraged.
ContentPilot.ini
ContentPilot.ini contains many settings, organized into the following sections:
IMPORTANT! Do not modify any settings that are not described in this document. Do not modify any settings unless required.
Note: Deprecated settings are not described here.
Button Box
Viz Pilot button box settings:
-
enabled: Set Y or N to enable or disable button box.
Database
-
login: User ID for the database connection
-
pwd: Password for the database connection
-
utf8: Sets whether or not the program and database should use UTF8 font encoding. This value should not be modified.
-
nls_lang: Sets the language to use. If UTF-8 is used for the database, the NLS_LANG environment setting must be here. This value is required and should not be modified.
-
name: This entry must contain the connection string for the database in the form: “hostname/instance name”. If a database client (such as Oracle Client) is used, enter the TNS name.
General
-
diff_tool: The path to a text compare tool executable can be entered here. This will make it possible to compare script files when conflicts between local scripts and repository scripts appear.
-
imageheight: Sets the default thumbnail image height generated by TnG.
GPI
This section contains GPI triggering settings for Director.
-
enabled: Enable GPI triggering? Y or N.
-
poll: Number of milliseconds between each poll of the GPI port.
-
delay_interval: Number of milliseconds before repeating a GPI trigger.
-
use_lpt: Use the LPT port for GPI triggering? Y or N.
-
send_to_cockpit: Send the trigger to the cockpit? Y or N. If set, Viz Pilot will send a recall message to the Viz IO when a GPI is received.
-
allow_combination: When sending a trigger to the cockpit, the allow_combination specifies if, for instance, GPI 3, should be sent as GPI 1, and GPI 2.
Import Sequence
Settings for enabling import of playlists from file (advanced).
-
enabled: If set to Y, menu Playlists will be enabled.
-
default_file: Sets the default file to import.
Language
-
font: Sets the application’s template and data list font. By default this setting will be set using the operating system font; however, in many cases other fonts, such as Arial Unicode MS, are used for language localization purposes (for example Arabic, Hebrew or Cyrillic).
Note: The font setting does not affect Viz Pilot News, where font settings are configured in the registry.
Parameters
-
datapool_visible: Enable or disable the Datapool component in Template Wizard.
-
basic_properties: Comma delimited list of additional properties to show in the basic properties tab in Template Wizard.
-
plugin_folder: Folder where Template Wizard will look for VcpExp.bpl.
Path
This section specifies a set of file and folder paths required by the Viz Pilot system.
-
picture: Defines the picture archive path.
-
production: The directory where the images for today’s production are placed - excluding the date.
-
autosave: The directory where automatically saved template records are stored.
-
tmpbmp: The directory where temporary bitmaps are stored.
-
scene_node: Specify a node that is automatically selected when viewing the scene tree from Viz Engine in Viz Pilot.
-
image_node: Specify an image that is automatically selected when viewing images from Viz Engine in Viz Pilot.
-
object_node: Specify an object that is automatically selected when viewing objects from Viz Engine in Viz Pilot.
-
sounds: The directory where WAV files are initially looked for.
-
shared: The directory where the shared image disk is mounted on the Unix system. Used for specifying the Unix path to the shared image server. For instance, on windows the drive is often mapped as K:\ but on a Unix system it would be \shared\images.
-
fileopen: Sets the default folder when opening image files.
Pilot
These settings define the general behavior of the Viz Pilot system.
-
restrict_characters: Restrict characters when saving data.
-
legal_characters: The characters that will be permitted in the names of saved data if "restrict_characters=Y". If this value is empty, there is no restriction on the data name regardless of the "restrict_characters" setting.
-
liveupdate_timer: The interval in milliseconds between each time a template’s Live Update event-handler is called. (If the template has Live Update.)
-
dateformat: The date format for saved data.
-
unique_names: Whether or not it is permitted to save several data elements with the same name.
-
autostart_preview: When set to Y, the Viz Pilot system will automatically start Viz [preview engine] if it is installed.
-
plugins: The directory where the plugins for the Viz Pilot system are located. Normally, this value is empty, otherwise it should be the path to the directory.
-
UTF8: Set to Y for UTF8 support in the Viz Pilot system.
-
logcount: Number of rolling log files (default 0). Affects both the Viz Pilot system’s log and macro log files.
-
logsize: Maximum size of the log file in bytes (default 512000). Affects both the Viz Pilot system’s log and macro log files.
-
logfile: Override the Viz Pilot system log file name (default vcp_yyyymmddThhmmss.log).
-
logdir: Override the directory the Viz Pilot system log files are put in. Default locations are:
-
%PROGRAMDATA%\Vizrt\Logs\Viz Pilot x.y
-
-
macrologfile: Override the macro log file name.
-
macrologdir: Override the directory where macro log files are located.
Sequencer
-
hostname: Sets the hostname of the Media Sequencer when specified during installation. If no host is specified it is set to localhost.
-
locktoprofile: When set to a specific profile, users will not be allowed to select other profiles or open the profile configuration in Director.
SGI
This section can be used to add new Viz Engines that can be used by Template Wizard.
-
machine1: The host name of the Viz Engine to connect to. More machines can be added to the list: machine2, pwd2 etc.
-
pwd1: On air password for the Viz Engine. Note that this is not supported on Viz Engine 3.5 or later.
Template_Wizard
-
linelayout_visible: Enables the Prefix and Customize options in the Wizard tool that sets the number of prefixes to be used when generating a template with a table style layout.
-
datapool_visible: Enables or disables the use of the datapool component in Template Wizard.
-
basic_properties: Comma delimited list of additional properties to show in the basic properties tab.
-
use_database: If disabled, the Template Wizard will operate without a database connection. This can be useful when creating file-based templates with Template Wizard. For example, for on-the-road template work, and template user interface design for Viz Ticker 3D and Viz Trio. See Working Without a Database Connection.
-
diff_tool: The path to a text compare tool executable can be entered here. This will enable the possibility to compare script files when conflicts between local scripts and repository scripts appear.
Viz
The following settings define interaction between the Viz Pilot system and Viz Engine.
-
onairpwd: Sets the Register ON AIR password for Director users.
-
data_timeout: Sets the Viz Engine connection timeout in milliseconds for receiving data from Viz Engine. Default is 60000 milliseconds (60 seconds). This is useful if you are loading a scene that is very complex or loads a big amount of data that will take some time to render (for example a map scene).
Viz IO
Viz IO (input/output) specific settings.
-
enabled: Enables the Viz IO connection. Y or N.
-
host: The machine hostname (or IP) of the Viz IO machine.
-
port: The Viz IO communications port.
-
auto_reconnect: In case the connection to the Viz IO is cut, this flag indicates whether to automatically try and re-establish the connection. (It will attempt after 30 seconds, then after 1 minute, then after 2 minutes, then after 4 minutes.)
-
offset: Used to offset the incoming triggers by a fixed number.
Configuration Files
The following configuration files are installed with the Viz Pilot system.
-
The default files are stored in the program folder with names in the format xxx.default.xxx.
-
Any changes are stored to files in %PROGRAMDATA%\Vizrt\Viz Pilot x.y\Config.
File |
Use |
components.cfg |
Default Component Palette settings for Template Wizard |
custom_components.cfg |
Custom Component Palette settings for Template Wizard |
extra_components.cfg |
Custom Component Palette settings for Template Wizard |
keyboard.kbd |
Keyboard Configuration for Director |
vtw_keyboard.kbd |
Keyboard Configuration for Template Wizard |