Description | Example | Return Message | Group

MapDetails

Control the type and resolution of details displayed in the 2D Graphics window

Syntax

MapDetails <ScenarioPath> {DetailOption} <Parameters>

Description

The MapDetails command allows you to select the type and resolution of details displayed in the 2D Graphics window. STK is shipped with the Relational World Data Bank II (RWDBII) maps. RWDBII maps, originally used by the CIA, are publicly available maps known for their accuracy.

{DetailOption} and <Parameters> can be:

{DetailOption} <Parameters> Description
Items <ItemName> {On | Off} [{Color}] [<WinNumber>] <ItemName> is the name of the map item to be set. Available items will depend on the map being displayed in the 2D Graphics window. For more information, refer to the STK help topic for 2D Graphics Details.

Warning: <ItemName> is case sensitive.

If <ItemName> is turned On, {Color} must be specified.
LatLon Lat {On | Off} [<SpacingValue> {Color} {Linestyle}] [<WinNumber>] Define the display of latitude lines in the 2D Graphics window. <SpacingValue> defines the distance between latitude lines using a number between 0.001 - 90.0 entered in degrees. For all valid {Color} and {Linestyle} options see Common Options.

If Lat is Off, no additional parameters should be set.

Lon {On | Off} [<SpacingValue>] [<WinNumber>] This option allows you to change the spacing between longitude lines on the 2d map.

If Off is entered then the spacing value is inherited from the specification for latitude lines.

If On is entered, then you must enter the <SpacingValue> parameter to change the longitudinal spacing. <SpacingValue> defines the distance between longitude lines using a number between 0.001 - 90.0 entered in degrees.

Note: The spacing value for Longitude lines can only be set if LatLon lines are turned On using the MapDetails LatLon Lat On command.

Background Image "<FilePath>" [<WinNumber>] Display the selected image as the background in the 2D Graphics window.
Image None [<WinNumber>] Display no background image.
Color {Color} [<WinNumber>] Select the background color in the 2D Graphics window.
Clouds On [<WinNumber>] Images of clouds are overlaid on the 2D Graphics window.
Off [<WinNumber>] No clouds display.
Toggle [<WinNumber>] If state is Off, it will be switched to On. If On, it will be switched Off.
File "<FilePath>" [<WinNumber>] Specify the path to the cloud image file using the "<FilePath>" parameter.
URI "<UriPath>" [<WinNumber>] Specify the uri file path to set a cloud file index.
Map {GeographicFeature} [State {On | Off}] [Color {Color}] [WindowID <WinNumber>] Display map details for 2d. Valid values for {GeographicFeature} are: RWDB2_Coastlines, RWDB2_International_Borders, RWDB2_Islands, RWDB2_Lakes, RWDB2_Provincial_Borders and RWDB2_Rivers. At least one or both of State or Color must be specified.

Note: For valid {Color} options see Common Options.

Example

To set a specific Longitude spacing first send the command to turn on the latitude lines:

MapDetails * LatLon Lat On

Then send the command:

MapDetails * LatLon Lon On 10

To display dashed latitude and longitude lines in red that are 50 degrees apart in 2D Graphics window 2:

MapDetails * LatLon Lat On 50 red dashed 2

To display a picture in the background:

MapDetails * Background Image "C:\stk\User\stkData\Pixmaps\owCrcl.xpm"

To display clouds from an external image file in the 2D Graphics window:

MapDetails * Clouds File "*/WhereverSTKDataIs/VO/Clouds/Nov30.clds"

To display the RWDB2_Coastlines details in window 1, in red:

MapDetails * Map RWDB2_Coastlines State ON Color red WindowID 1

To display clouds from an external image file:

MapDetails * Clouds URI "file:///C:/Documents and Settings/STK/Desktop/CloudsURIBak/cloudsTest.cld"

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

2D Graphics Window

Version

9.0

STK Programming Interface 11.0.1