Including Other Configuration Files

VR Juggler includes the idea of an "Include File" chunk, which has one property: the pathname of a VR Juggler config file. When a VR Juggler application loads a file with an "Include File" chunk, it will also load the file named in that chunk. This means that it is possible to make a config file that's just a list of other config files to be loaded.

Similarly, there are "Include Description File" chunks which will cause VR Juggler to automatically load a ChunkDesc file. This is particularly useful for config files which contain application-specific kinds of ConfigChunks. If a config file with includes is loaded into VjControl, the included files are automatically loaded, though each file is viewed separately.

To include a file, simply add an "Include File" (or "Include Descriptions File") chunk to the config file. The name of the "Include File" chunk is the path name of the file to load. You can use the strings "$HOME" and "$VJ_BASE_DIR" at the start of the name to refer to your home directory and the VR Juggler install directory, respectively.

Relative path names in includes (e.g. paths that don't start with "/" or C:) are relative to the location of the file containing the "Include File" chunk. For example, if the config file /home/vr/vjconfig/c2.config includes the file C2/displays.config, VR Juggler will try to load a file named /home/vr/vjconfig/C2/displays.config.