Description | Example | Return message | Group

VO TerrainAndImagery

Manipulate VO terrain and imagery.

Syntax

VO <ScenarioPath> TerrainAndImagery {Options} <Parameters>

Related commands

Description

The VO TerrainAndImagery command allows you to set various terrain and imagery parameters, including adding and removing terrain and imagery from the globe, define which terrain and imagery sets are shown, set related cache sizes.

The following are valid values for {Options}: Data, Set, Add, Modify, Remove. The following tables describe each option and its parameters.

VO TerrainAndImagery Data command

Data OptionsDescription
ChunkImageCacheSize <Value>Specify the size of the texture cache which temporarily stores chunk imagery for the globe. <Value> is an integer greater than 0, entered in megabytes.
ChunkTerrainCacheSize <Value>Specify the size of the terrain cache which temporarily stores pdtt file data for the globe. <Value> is an integer greater than 0, entered in megabytes.
MSBingMapsServer <ServerName>Specify a default server to be used if one isn't specified in the Add commands.

The chunk imagery and terrain caches allow for an even distribution of memory among 3D windows, which at times may cause multiple 3D windows to recalculate to mouse zooms/redraws in one window.

Examples

To set the image cache size to 128 megabytes:

VO * TerrainAndImagery Data ChunkImageCacheSize 128

To set the default Microsoft Bing™ Maps server to virtualearth.net:

VO * TerrainAndImagery Data MSBingMapsServer virtualearth.net

To set the current visual terrain server:

VO * TerrainAndImagery Data VisualTerrainServer "assets.agi.com/stk-terrain"

VO TerrainAndImagery Set command

The TerrainAndImagery Set options allow you to add Image Sets to be used when displaying the globe in the 3D window. This command defines which Image Sets are associated with a view. Only Image Sets that have been defined for the current globe file will be displayed.

To define an Image Set see the VO ImageSetDef command.

To add files to an Image Set for a globe file see the VO TerrainAndImagery Add and Modify commands below.

Set OptionsDescription
Add "<ImageSetName>"Specify the Image Set to be displayed.
Remove {All | "<ImageSetName>"}Remove an Image Set from the globe. Specify All to remove all Image Sets.
WindowID <WinNumber>Specify the VO Window, if this option is not entered the first VO Window will be used.
Use {On | Off | Toggle}Specify whether or not to display Image Sets on the globe.

This option is deprecated in STK 9, use the Add option to turn on a set and the Remove option to turn off a set.

Examples

To add sets to be shown in the VO window if UseSet is on:

VO * TerrainAndImagery Set Add "MySet" Add "AnotherSet"

VO TerrainAndImagery Add and Modify commands

Use this command to Add or Modify files in a Globe File or an Image Set.

See below for options to Add or Modify Microsoft Bing Maps.

See below for options to Add or Modify Visual Terrain Tile Sets.

To define an Image Set see the VO ImageSetDef command.

These TerrainAndImagery Add and Modify options effect only pdtt, pdttx, jp2 files.

This table describes the options used for the File being added or modified

Name OptionsDescription
File "<FilePath>"Specify the file to add or modify. This option is required.

"<FilePath>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information.

SetName "<SetName>"Specify an Image Set to add a file to, or the set name of an image being modified. Use the VO ImageSetDef command to create an Image Set.
WindowID <WinNumber>Specify the VO Window, if this option is not entered the first VO Window will be used.

This table describes the add and modify options.

Add/Modify OptionsDescription
ShowOn {Bottom | Top}Sets the ordering of the image or terrain. If Top is entered the image appears on top of all other images. If Bottom is entered then the image appears beneath all other images.
Transparency <Value>Transparency value can be between 0.0 and 1.0, where 1.0 is completely transparent. This option applies to pdttx files.
TextureRole {Base | Night | Specular}Specify the Texture to use.
TransparentRGB <Red> <Green> <Blue>Specify transparent RGB color values. Valid values for <Red> <Green> and <Blue> are 0-255. This option applies to jp2 file type only.
UseTransparentRGB {Yes | No}Specify Yes if the value set for TransparentRGB is to be used.
MinLat <Value> MinLon <Value> MaxLat <Value> MaxLon <Value>Specify the extents of the image. Each <Value> must be entered in degrees. This option applies to jp2 file type only, however this option is optional if the extents can be obtained directly from the file or from a .pos file.
Visible {Yes | No}Specify whether the image should be displayed.
AltitudeScale <Value>AltitudeScale value can be between 0.000001 and 1000.0. This option applies to pdtt files.
AltitudeOffset <Value>AltitudeOffset value can be between -1000000.0 and 1000000.0. This option applies to pdtt files.

Examples

Add a pdttx file:

VO * TerrainAndImagery Add File "I:\afghanistan\n4230Terrain.pdttx"

Add a web pddtx file to window 1 and an image set:

VO * TerrainAndImagery Add File "Breckenridge.pdttx" SetName "one" WindowID 1

Add a pdtt file to several image sets:

VO * TerrainAndImagery Add File "I:\afghanistan\n4230Terrain.pdttx" SetName "one" SetName "two"

Show a pdttx on top of all other images and change its transparency to 30%:

VO * TerrainAndImagery Modify File "G:\scenarios\6.x\setOrder\data\blue.pdttx" ShowOn Top Transparency 0.3

Set the altitude scale and altitude offset for the pdtt file:

VO * TerrainAndImagery Modify File "G:\scenarios\Images\White_Mountain.pdtt" AltitudeScale 20 AltitudeOffset 25.0

Add a night jp2 file; the current one being used if any, is removed:

VO * TerrainAndImagery Add File "H:\Imagery\Earth_PE_Night.jp2" TextureRole Night

VO TerrainAndImagery Add and Modify commands for Microsoft Bing Maps

Use the following options to Add or Modify Microsoft Bing Maps.

Add/Modify OptionsDescription
MSBingMaps {Hybrid | Aerial | Road | Road Dark | Road Gray}Specify the type of map to use. This option is required.
TextureRole BaseSpecify the Texture to use.
Visible {Yes | No}Specify whether the map should be displayed.
WindowID <WinNumber>Specify the VO Window, if this option is not entered the first VO Window will be used.

Examples

Add the Microsoft Bing Maps Hybrid map:

VO * TerrainAndImagery Add MSBingMaps Hybrid TextureRole Base

Modify the Microsoft Bing Maps Aerial map for window 2:

VO * TerrainAndImagery Modify MSBingMaps Aerial Visible Off WindowID 2

VO TerrainAndImagery Add, Modify, and Remove commands for Visual Terrain Tile Sets

Use these commands to Add, Modify or Remove the visual terrain tile set on the globe.

Add/Modify/Remove OptionsDescription
VisualTerrainTileSetThis option is required.
Visible {Yes | No}Specify whether the tile set should be displayed. The default value is Yes. For Add or Modify only.
WindowID <WinNumber>Specify the VO Window, if this option is not entered the first VO Window will be used.

Examples

Add the VisualTerrain Tile Set:

VO * TerrainAndImagery Add VisualTerrainTileset Visible Yes WindowID 1

Turn off the display of the VisualTerrain Tile Set for window 1:

VO * TerrainAndImagery Modify VisualTerrainTileset Visible No WindowID 1

Remove the VisualTerrain Tile Set:

VO * TerrainAndImagery Remove VisualTerrainTileset WindowID 1

VO TerrainAndImagery Remove command

The TerrainAndImagery Remove option removes pdtt, pdttx files.

Remove OptionsDescription
File "<FilePath>"Specify the file to remove.
SetName "<SetName>"Specify the Image Set name to remove a file from. If a set name is not specified, the file is deleted from all sets if it is in any sets, or just plain deleted.
TextureRole {Base | Night | Specular}Specify the texture to remove.
WindowID <WinNumber>Specify the VO Window, if this option is not entered the first VO Window will be used.
MSBingMaps {Hybrid | Aerial | Road | Road Dark | Road Gray}Specify the type of map to remove.

Examples

Remove a pdttx file completely including any image sets:

VO * TerrainAndImagery Remove File "I:\afghanistan\n4230Terrain.pdttx"

Remove the Microsoft Bing Maps Hybrid map:

VO * TerrainAndImagery Remove MSBingMaps Hybrid

Return message

Group membership

This command belongs to the following group(s):

VO

VO Window

Version

12