Define and display ground range contours in the 2D Graphics window
Graphics <ObjectPath> RangeContours {AddMethod} [<Parameters>]
Use the Graphics RangeContours command to add and remove ground range contours to the 2D Graphics window. When adding contour levels, you can also define how contour levels will display in the 2D Graphics window.
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 range contour graphics. |
| Explicit | <LevelValue> {Color} {LineStyle} <LineWidth> {ShowDistance} [{ShowText} ["<LabelText>" [<LabelAngle>]]] | Add individual range 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, 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. |
| 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. |
| LabelUnits | {UnitType} | Indicate the units to use for
displaying the level values. Valid values for {UnitType} are:
|
<LevelValue> and <Start> <Stop> <Step> values are entered in Connect distance units. Valid Range Contour levels have a value that is greater than 0.001. When entering levels via the StartStop option the command will not Nack if invalid levels are specified, but will only draw valid levels.
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. |
To display ground elevation contours for Facility1 in the 2D Graphics window:
Graphics */Facility/Facility1 RangeContours Show On
To show a red contour at 200 km with linestyle 1 and LineWidth 3, without showing the distance label:
Graphics */Facility/Facility1 RangeContours Explicit 200000.0 Red 1 3 Off
To change the color of the above contour, at 200000.0, to blue:
Graphics */Facility/Facility1 RangeContours Contour 200000.0 Color Blue
To add contours starting at 100 km to 700 km at a space of every 100 km:
Graphics */Facility/Facility1 RangeContours StartStop 100000.0 700000.0 100000.0
To remove the contour at 200 km:
Graphics */Facility/Facility1 RangeContours Remove 200000.0
To display range contours for Satellite1:
Graphics */Satellite/Satellite1 RangeContours Show On
To add contours for Satellite1 starting at 100 km to 700 km at a space of every 100 km:
Graphics */Satellite/Satellite1 RangeContours StartStop 100000.0 700000.0 100000.0
To change contour at 600000.0m to red, the line style to Solid, and add user defined text:
Graphics */Facility/facility_contours RangeContours Contour 600000.0 Color red LineStyle 0 Text "Red - Level On"
To set the contours for Satellite1 to be filled with a diagonal hatch pattern:
Graphics */Satellite/Satellite1 RangeContours Fill On DiagonalHatch
To set the number of decimal places and label units:
Graphics */Satellite/Satellite1 RangeContours DecimalPlaces 0
Graphics */Satellite/Satellite1 RangeContours LabelUnits Kilofeet
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1