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 > TerravisionTM > 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 TerraVisionTM distribution into. This is used to help TerraVisionTM find various support files such as images, help files, master config files, etc. If you do not set a $TVHOME environment variable, then TerraVisionTM will use the current directory where you ran TerraVisionTM from.

config.xml

The config.xml file is used to store any user-specific configuration options for TerraVisionTM. 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 TerraVisionTM is able to access. It is this file that TerraVisionTM uses when you select the File/Open TV option (although you can tell TerraVisionTM 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, TerraVisionTM 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/.

 

 

Copyright ©2000 SRI International. All rights reserved.

For more information, please contact: digital-earth@ai.sri.com.
Last updated: Monday, 10-Sep-2001 11:02:05 PDT.