Graphics RangeContours
Define and display ground range contours in the 2D Graphics window
Syntax
Graphics <ObjectPath> RangeContours {AddMethod} [<Parameters>]
Related commands
Description
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.
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.
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. |
Examples
To display ground elevation contours for Facility1 in the 2D Graphics window:
To show a red contour at 200 km with linestyle 1 and LineWidth 3, without showing the distance label:
To change the color of the above contour, at 200000.0, to blue:
To add contours starting at 100 km to 700 km at a space of every 100 km:
To remove the contour at 200 km:
To display range contours for Satellite1:
To add contours for Satellite1 starting at 100 km to 700 km at a space of every 100 km:
To change contour at 600000.0m to red, the line style to Solid, and add user defined text:
To set the contours for Satellite1 to be filled with a diagonal hatch pattern:
To set the number of decimal places and label units:
Return message
Group membership
This command belongs to the following group(s):
Version
10