Manipulate VO terrain and imagery.
VO <ScenarioPath> TerrainAndImagery {Options} <Parameters>
The VO TerrainAndImagery command allows the user 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 it's parameters.
| Data Options | Description |
|---|---|
| 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. |
Note: 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.
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"
The TerrainAndImagery Set options allow the user 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 Options | Description |
|---|---|
| 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.
Note: 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. |
To add sets to be shown in the VO window if UseSet is on:
VO * TerrainAndImagery Set Add "MySet" Add "AnotherSet"
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.
Note: 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 Options | Description |
|---|---|
| File "<FilePath>" | Specify the file to add or modify. This option is required. |
| WebName {Yes | No} | Set to Yes if the file is on globe server. This option is required if the file is on globe server. |
| 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 Options | Description |
|---|---|
| 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. |
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" WebName Yes 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 it's transparency to 30%:
VO * TerrainAndImagery Modify File "G:\scenarios\6.x\setOrder\data\blue.pdttx" ShowOn Top Transparency 0.3
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
Use the following options to Add or Modify Microsoft Bing Maps.
| Add/Modify Options | Description |
|---|---|
| MSBingMaps {Hybrid | Aerial | Road | HillShade} | Specify the type of map to use. This option is required. |
| TextureRole Base | Specify 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. |
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
Use these commands to Add, Modify or Remove the visual terrain tile set on the globe.
| Add/Modify/Remove Options | Description |
|---|---|
| VisualTerrainTileSet | This 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. |
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
The TerrainAndImagery Remove option removes pdtt, pdttx files.
| Remove Options | Description |
|---|---|
| File "<FilePath>" | Specify the file to remove. |
| WebName {Yes | No} | Set to Yes if the filename is on globe server. |
| 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 | HillShade} | Specify the type of map to remove. |
To remove a web pdttx file from an image set:
VO * TerrainAndImagery Remove File "Breckenridge.pdttx" WebName Yes SetName "one"
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
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
11
STK Programming Interface 11.0.1