Description | Example | Return Message | Group

Graphics ElevContours

Set elevation angle contour levels for a vehicle

Syntax

Graphics <ObjectPath> ElevContours {AddMethod} [<Parameters>]

Related Commands

Description

Use the Graphics ElevContours command to display elevation angle contours in the 2D Graphics window. Contour levels represent the various regions of the surface that can see a vehicle at the specified elevation angle.

The {AddMethod} controls the way that level values will be defined. The <Parameters> that you must provide depend on the {AddMethod} selected. Valid values for {AddMethod} are:

{AddMethod} <Parameters> Description
Show {On | Off} Display contour graphics.
Explicit <LevelValue> {Color} {LineStyle} <LineWidth> {ShowDistance} [{ShowText} ["<LabelText>" [<LabelAngle>]]] Add individual elevation contour levels by specifying the <LevelValue> and display attributes. For valid {Color} and {LineStyle} options see Common Options. For <LineWidth> enter a pixel width value between 1.0 and 10.0. Valid values for {ShowDistance} and {ShowText} are On and Off. <LabelAngle> is entered in degrees.
Contour <LevelValue> {Keyword} <Value> [{Keyword} <Value>...] Change the attributes of the <LevelValue> specified. {Keyword} <Value> pairs are described in the table below.
StartStop <Start> <Stop> <Step> Generate contours beginning with the Start value and incrementing by the Step value until the Stop value is exceeded. <Step> must be greater than 0.0.
Remove <LevelValue> Remove the contour representing the <LevelValue> specified.

Note: If the specified level is not found, the command will Ack, and do nothing.

RemoveAll N/A Remove all contours.
LabelAngle <Angle> Sets the LabelAngle for all existing contours. This defines where, along the contour, the text and/or distance is displayed. <Angle> can be 0 to 359 degrees, clockwise. The default is 180 degrees or the 6:00 o'clock position.

Note: Contours inserted after calling this command will still have the default LabelAngle of 180.

Fill {On | Off} [{FillStyle}] If On is entered then display the range contours as a filled polygon on the surface of the central body. The {FillStyle} can be one of: Solid, VerticalStripe, HorizontalStripe, DiagonalStripe1, DiagonalStripe2, Hatch, DiagonalHatch, Screen. The {FillStyle} value can only be entered if On is also entered.
FillTranslucency <Value> Set the percent translucency of the fill. <Value> can be between 0.0 and 100.0
DecimalPlaces <Value> Sets the number of decimal places for displaying the level values. <Value> can be 0 to 14. The default is 3.

<LevelValue> and <Start> <Stop> <Step> values are entered in degrees. Valid Elevation Contour levels have a value between 0.0 and 90.0 degrees. When entering levels via the StartStop option the command will not Nack if invalid levels are specified, but only valid levels will be drawn.

The following table describes the {Keyword} <Value> pairs for the Contour {AddMethod}

{Keyword} <Value> Description
Color {Color} Set the color of the contour. For valid {Color} options see Common Options.
LineStyle {LineStyle} Set the line style for the contour. {LineStyle} can be a name such as Solid, Dashed, Dotted, etc, or a number 0, 1, 2, etc. For all valid {LineStyle} options see Common Options.
LineWidth <Width> Indicate a pixel width value between 1.0 and 10.0.
ShowDistance {On | Off} Show or Hide the contour's distance.
ShowText {On | Off} Show or hide the contour's user defined text.
Text "<Text>" Set the contour's user defined text.
LabelAngle <Angle> Define where, along the contour, the text and/or distance is displayed. <Angle> can be 0 to 359 degrees, clockwise. The default is 180 degrees or the 6:00 o'clock position.

Example

To set the graphics properties of the ERS1 satellite so that contour graphics appear at 30 degree intervals between 0 and 90:

Graphics */Satellite/ERS1 ElevContours StartStop 0.0 90.0 30.0

To change the contour at 30.0 degrees to red, the line style to Solid, and add user defined text:

Graphics */Aircraft/ac1 ElevContours Contour 30.0 Color red LineStyle 0 Text "Red - Level On"

To set the contours for Satellite1 to be filled with a diagonal stripe pattern, and translucency of 90%:

Graphics */Satellite/Satellite1 ElevContours Fill On DiagonalStripe1

Graphics */Satellite/Satellite1 ElevContours FillTranslucency 90

To set the number of decimal places to 5:

Graphics */Satellite/Satellite1 ElevContours DecimalPlaces 5

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

2D Object Graphics

Vehicles

Version

10

STK Programming Interface 11.0.1