Getting Started
Cmd Line Opts
Tcl/Tk Version
X/Motif Version
NS Plugin Version
ActiveX Version
Creating Data
OAA Interface
Go to FAQ

Digital Earth > TerravisionTM > User Guide > Getting Started

Command Line Options

TerraVisionTM supports a number of command line options. These are standard options that are used by all versions of TerraVision (except the ActiveX component). They can be found by typing the command, TerraVision -help, at the command prompt and are described fully below.

Windows Shortcut with Proxy Option

Under Windows machines, you can employ these command line options by locating the TerraVision executable file and running this from the MS-DOS Prompt. Alternatively, from the desktop, you can create a shortcut to the executable program and then under the Target property you can specify the desired command line options (see above image).

Option Description
-help or -h Displays information about the command line arguments supported by that version of TerraVisionTM.
-version or -v Displays the version information for the TerraVisionTM module, as well as the submodules tvutils and tsmApi.
-debug [MASKS:]LEVEL Set debugging level for TerraVisionTM, and optionally the debugging masks. The debugging options cause TerraVision to output various diagnostic messages to the shell window that it was run from. The level value can be any value in the range 1-4, the mask string can be made up of any of the following characters: 'A' (All), 'T' (Tiles), 't' (Texturing), 'i' (Init), '2' (2-D Viewer), '3' (3-D viewer), 'c' (Cache), 'G' (.geo), 'm' (Map Viewer), 'o' (OpenGL), 'O' (OAA), or 'v' (Visiblity). If you do not specify a set of debugging masks, then all masks will be enabled. For example, -debug 2 or -debug Tt3:1
-debug FILENAME Specifies a filename where all debug information will be sent to. If you do not specify this option, then all debug information will be sent to stderr by default. This option lets you capture the debug output for a session for review at a later point, or for sending to the developers when reporting a bug.
-schema URL Specifies a URL to a .geo schema file. This schema file describes the makeup of the particular .geo infrastructure being used and the root server name. If you specify this option, then whenever you open a viewer, TerraVision will automatically begin querying the .geo index and streaming available data to the display.
-dotgeo Synonymous with -schema
-hierarchy URL This option can be used to supply an XML file that contains the entire database for the .geo infrastructure that you wish to browse. This overrides the settings in the schema file. It can be used to create small demonstration versions of .geo where the available datasets are self-contained and known.
-license Displays the TerraVisionTM license agreement. You will always be presented with this requester whenever you first use a new version of TerraVisionTM. However, you can use this option if you would like to see the agreement again. You will have to accept the license before you can use the TerraVisionTM system.
-oi URL Specifies a default OI (imagery) URL. If you also specify a default DEM URL with the -dem option, then TerraVisionTM will automatically load this dataset when it first starts up.
-dem URL Specifies a default DEM (elevation) URL. If you also specify a default OI URL with the -oi option, then TerraVisionTM will automatically load this dataset when it first starts up.
-view 2D|3D If you specify -view 2D, then after the first dataset has been loaded, the Overhead Viewer will be displayed. Similarly, if you specify -view 3D, then the Out The Window Viewer will be displayed after the first dataset has loaded. You can combine this option with the -dem and -oi options in order to make TerraVisionTM automatically load a particular dataset and display it on startup.
-visualid ID Under Windows, this option can be used to select the pixel format ID number to use for the OpenGL context. This value is a number greater than or equal to 1, as used in the Win32 API DescribePixelFormat() call. If the visual that TerraVision selects is not the one you wish to use, then you can provide this option to override TerraVision's automatic selection. The visual ID number is stored in the config.xml file so that, once set, it is persistent for all future sessions. You may use "-visualid -1" in order to tell TerraVision to try and find the best visual again.
-tcldir DIRECTORY This option only applies to the the Tcl/Tk version of TerraVision. It can be used to explicity specify the location of the TerraVision Tcl scripts (.tcl files). These files implement the user interface and are required in order for the program to run. By default, TerraVision will look under the tcl subdirectory where you installed TerraVision. TerraVision will look for the file name "TerraVision.tcl" in that directory.
-cmd COMMAND The -cmd option lets you specify an OAA-style command that will be executed on startup (when a viewer window is opened). You can specify multiple -cmd options on the command line in order to setup your default settings. You can find the OAA command list from OAA Interface documentation. For example, -cmd "set('SHOW_WIREFRAME',1)"
-proxy URL Specifies the full URL of your http proxy server. You will probably need to specify this if you are running TerraVisionTM from behind a firewall and want to access datasets on external servers. For example, "-proxy".
-debug_dpss If this version of TerraVisionTM has been compiled with DPSS support, then setting this command line option will switch on the DPSS internal debugging mode.
-verbose_dpss If this version of TerraVisionTM has been compiled with DPSS support, then setting this command line option will switch on the DPSS internal verbose mode.
-config FILENAME This option lets you specify an alternative TerraVision config file. This is the file that is used to store all of your personal configuration settings for TerraVisionTM. By default, TerraVision will use the $HOME/tv/config.xml file.
-noconfig Instructs TerraVision to not load any TerraVision configuration file.
-log This option will tell TerraVisionTM to start logging immediately upon start up. Then, whenever you open a dataset, logging will be turned on for that dataset. Note that you can customise the logging output by putting resources into your $HOME/.TerraVision file. For example, "*netloggerDirectory: /tmp" will send all NetLogger output to the directory /tmp.
-path This option specifies the filename of a path to be loaded and played when the 3-D viewer first opens. You do not need to specify the .path extension (it will be added if not present). The user's default path directory will be prepended to the file you specify, i.e. you should specify a filename relative to the $HOME/.TerraVisionPaths/ directory. If the file does not exist, then TerraVisionTM will act as if you did you specify this option.
-viewpoints URL Specifies the full URL of your viewpoint bookmarks file. By default, this file is $HOME/tv/viewpoints.xml. Use this option to define another viewpoints file. This may be an http URL (although note that you cannot add viewpoints to a file that is located on an http server).
-droptowireframe HZ TerraVisionTM will automatically drop into wireframe mode whenever you are navigating and the frame rate drops below a certain threshold. This is done to improve the frame rate and visual feedback during periods of navigation. The display returns to its previous mode when stopped. The default setting for this option is 3.0 Hz. Setting this value to 0.0 will disable the option, i.e. never drop to wireframe based on the frame rate.
-oaa HOST:PORT Lets you connect to an OAA facilitator. OAA stands for Open Agent Architecture, a framework for integrating a community of heterogeneous software agents in a distributed environment. TerraVisionTM is OAA-enabled in that it can act as an "agent", advertising its capabilities as a 3-D terrain visualization system with a central facilitator.

You connect to a facilitator by supplying its host name and port number, e.g. -oaa

-cave Run the CAVE version of TerraVisionTM. This option is only available if the TerraVision binary was compiled with CAVE support.



Copyright ©2000 SRI International. All rights reserved.

For more information, please contact:
Last updated: Friday, 09-Mar-2001 16:58:45 PST.