Digital Earth: TerraVision: User Guide


Topics
•	Getting Started
•	Cmd Line Opts
•	Tcl/Tk Version
•	X/Motif Version
•	NS Plugin Version
•	ActiveX Version
•	Configuration
•	Creating Data
•	OAA Interface

•	Go to FAQ

Digital Earth > Terravision^TM > User Guide > Configuration

7. Configuration

Under Unix, TerraVision stores all of a user's configuration information in their $HOME/.tv directory. This directory will be created for you if you do not have one. If you used a previous version of TerraVision to 5.0, then those configuration settings will be created inside your new $HOME/.tv directory automatically. Under Windows, $HOME is treated as the config subdirectory of the location where you installed TerraVision. This location is stored in your Windows registry.

$TVHOME

Under Unix, The $TVHOME directory is the directory that you installed the TerraVision^TM distribution into. This is used to help TerraVision^TM find various support files such as images, help files, master config files, etc. If you do not set a $TVHOME environment variable, then TerraVision^TM will use the current directory where you ran TerraVision^TM from.

config.xml

The config.xml file is used to store any user-specific configuration options for TerraVision^TM. The most common use for this file is to store the filename of the Dataset Database that you were last using for the File/Open TV dialog. However, you can include any number of settings here that you wish to override the default settings. These settings are generally based on the command line arguments that TerraVision accepts. Below is an example config.xml with some sample settings.
  <?xml version="1.0"?>
  <TerraVision version="5.1" created="Fri Sep  7 01:46:34 2000">
    <option name="SHOW_WIREFRAME" value="TRUE"/>
    <proxy url="http://proxy.ai.sri.com/"/>
    <oaa hostname="lomond.ai.sri.com:3344"/>
    <database url="/home/lomond1/reddy/test.db"/>
  </TerraVision>
This configuration file is stored in your $HOME/.tv directory under Unix, or under the config subdirectory of your TerraVision installation under Windows. In older Unix versions, this file used to be accessed as $HOME/.TerraVision.

database.xml

This is the default and recommended file to use for storing your local copy of the Dataset Database. This records all of the datasets that TerraVision^TM is able to access. It is this file that TerraVision^TM uses when you select the File/Open TV option (although you can tell TerraVision^TM to use a different file if you wish).
This file is stored in your $HOME/.tv directory under Unix, or under the config subdirectory of your TerraVision installation under Windows. In older Unix versions, this file used to be accessed as $HOME/.TerraVisionDB.

viewpoints.xml

The viewpoints.xml file in the user's home directory is used to store all of the viewpoints that the user has bookmarked in the 3-D viewer. That is, via the Viewpoints / Viewpoint Bookmarks menu of the Out The Window viewer. This information is kept separate from the config.xml file to promote interchange of Viewpoint Bookmark files. Also, these data are stored in a tagged, XML notation to allow for future expansion.
This configuration file is stored in your $HOME/.tv directory under Unix, or under the config subdirectory of your TerraVision installation under Windows. In older Unix versions, this file used to be accessed as $HOME/.TerraVisionViewpoints.

paths

The paths directory in the user's home directory is used to store all of their flight path files. Inside this directory, TerraVision^TM will look for a sub-directory with the name of a particular dataset (e.g. "Ft Irwin (2scene)"). This directory will contain all of the path files for that dataset.
This directory is stored in your $HOME/.tv directory under Unix, or under the config subdirectory of your TerraVision installation under Windows. In older Unix versions, this directory used to be accessed as $HOME/.TerraVisionPaths/.