Use the RTG Configuration Utility to create, manipulate, and access data within configuration files.

The RTG Configuration Utility contains all the key-value pairs necessary to run RTG in any configuration. The utility can be run through the main RTG application user interface or independently as a separate application.

Note The RTG Configuration Utility only supports local RTG systems.
Figure 51. RTG Configuration Utility
Drop Down Menu
Page Selection Navigation
Configuration File Directory
Current File Path
Configuration File Values
Make Configuration File Default? Checkbox

The RTG Configuration Utility features the following sections:

  • Drop Down Menu—Provides file I/O.
    • File » Open (Ctrl+O)—Opens a file explorer window to allow selection of a valid configuration file.
    • File » Save (Ctrl+S)—Opens a file explorer window to save the current configuration file being edited.
    • File » Close (Ctrl+Q)—Closes the Configuration File Utility.
    • View » Initial State (Ctrl+I)—Opens a window to view the selected configuration file within the Configuration File Directory prior to editing.
    • View » Preview Mode (Ctrl+P)—Opens a window to view changes made in real-time. Save to retain all changes.
  • Page Selection Navigation—Enables switching between pages based on values being edited.
    • General—Edit values for connectivity and API use.
    • RTG—Edit values associated with configuring the VST(s) within your RTG system. Right-click to add or remove configurations.
    • Coprocessor—Edit values associated with configuring a coprocessor(s) within your RTG system. Right-click to add or remove configurations.
  • Configuration File Directory—Populates all configuration (.ini) files within a selected directory. Users can also manage the deletion of files and navigate to either the working directory or the default RTG Configuration Support INI directory.
  • Current File Path—Displays the file path of the current file being viewed and edited.

    • The basic workflow is as follows:

    1. When launched, the RTG Configuration Utility automatically opens and reads the default RTG Configuration Support INI file.

      If the user specifies a custom configuration file with the INIPath key and a valid path within the default file, the utility opens and reads that file instead.

      Note Users can also open any file through the File » Open from the Drop Down menu. The utility populates all INI files in the same directory as the opened file.
    2. Once the file is read, the utility populates the values present in that file.
    3. Users can edit the values populated by the INI file within the utility.
      • Users can view the unedited source by selecting View » Initial State from the Drop Down menu
      • Users can view their changes in real-time by selecting View » Preview Mode.
      Note Editing the values on the front panel of the utility does not directly edit the source file; it replicates it in a separate temp file that mirrors the source.

      Selecting File » Save from the Drop Down menu saves the changes to disk.

    4. If users want to add or remove an RTG device or coprocessor, they can right-click General, and select Add Device, Remove Device, Add Coprocessor, or Remove Coprocessor.
      Figure 52. Adding or Updating an RTG Device in the RTG Configuration Utility
      Figure 53. Adding or Updating a Coprocessor in the RTG Configuration Utility
    5. If users create a new configuration file and want RTG to automatically use their custom file at runtime, users can edit the Make Configuration File Default? value to add the file path to the new file.

      The Make Configuration File Default? value is equivalent to the INIPath key.

      Note Only one file can be specified at a time. When switching between multiple configuration files, the path value remains static unless updated.
      Note If users create a new configuration file based on the RTG default configuration file or a user-defined default file, a pop-up window opens to allow you to make the new file default. Due to this, the Make Configuration File Default? value is disabled if you are editing the RTG default configuration file as to avoid pointing to itself.