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 http://avila.ai.sri.com/TileSets/Schema/schema.xml
|
-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 http://yuba.ai.sri.com/".
|
-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 trestle.ai.sri.com:3344.
|
-cave |
Run the CAVE version of TerraVisionTM. This option is only available if the
TerraVision binary was compiled with CAVE support. |