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 enables you to set various terrain and imagery parameters, including: adding and removing terrain and imagery from the globe, defining which terrain and imagery sets are shown, and setting related cache sizes.

The following are valid values for {Options}: Data, Set, Add, Modify, and 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 that 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 Graphics windows. At times, this may cause one or more 3D Graphics 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 enable you to add Image Sets to be used when displaying the globe in the 3D Graphics 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>"}Removes an Image Set from the globe. Specify All to remove all Image Sets.
WindowID <WinNumber>Specify the VO window. If you do not enter this option, STK will use the first VO window.
Use {On | Off | Toggle}Specify whether or not to display Image Sets on the globe.

This option is deprecated as of 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 affect only PDTT, PDTTX, and 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>" is the path to a file on your local drive.

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 you do not enter this option, STK will use the first VO Window.

This table describes the Add and Modify options.

Add/Modify OptionsDescription
ShowOn {Bottom | Top}Sets the ordering of the image or terrain. If you enter Top, the image appears on top of all other images. If you enter Bottom, 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 the JP2 file type only.
UseTransparentRGB {Yes | No}Specify Yes to have STK use the value set for TransparentRGB.
MinLat <Value> MinLon <Value> MaxLat <Value> MaxLon <Value>Specify the extents of the image. You must enter each <Value> in degrees. This option applies to the JP2 file type only. However, this option is optional if STK can obtain the extents 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 PDTTX 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 you do not enter this option, STK will use the first VO window.

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. This applies to Add and Modify only.
WindowID <WinNumber>Specify the VO Window. If you do not enter this option, STK will use the first VO Window.

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 and PDTTX files.

Remove OptionsDescription
File "<FilePath>"Specify the file to remove.
SetName "<SetName>"Specify the Image Set name to remove a file from. If you do not specify a set name, 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 you do not enter this option, STK will use the first VO window.
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.10