Description | Example | Return Message | Group

VO BearingEllipse

Define an ellipse, relative to a bearing from the North, around an object.

Syntax

VO <ObjectPath> BearingEllipse {Keyword} <Value> [{Keyword} <Value>...]

Related Commands

Description

Create and set attributes for a bearing ellipse to appear around a vehicle, facility or place. The ellipse is defined relative to a bearing from the North.

Note: The BorderWall keyword must come last in the command syntax or the command will NACK.

{Keyword} <Value> Description
Show {On | Off} Show or hide the bearing ellipse.
Color {Color} Set the color of the ellipse. For valid {Color} options see Common Options.
LineStyle {LineStyle} Set the line style of the ellipse. For valid {LineStyle} options see Common Options.
LineWidth <LineWidth> Indicate a pixel width value between 1.0 and 10.0.
Bearing <Value> The bearing value, relative to North. Entered in degrees.
MajorAxisLength <Value> Define the length of the major axis for the ellipse. <Value> must be greater than 0 and is entered in Connect distance units. Default is 60,000 m for Vehicles and 24,000 m for Facility and Place.>
MinorAxisLength <Value> Define the minor axis length for the ellipse. <Value> must be greater than 0 and is entered in Connect distance units. Default is 50,000 m for Vehicles and 16,000 m for Facility and Place.
OffsetMajorAxis <Value> The distance to offset the ellipse (forward or backward) along the bearing. A positive OffsetMajorAxis <Value> moves the ellipse forward. Entered in Connect distance units.
OffsetMinorAxis <Value> The distance to offset the ellipse (left or right) along the bearing. A positive OffsetMinorAxis <Value> moves the ellipse to the right. Entered in Connect distance units.
Granularity <Value> Indicate the number of points used to draw the ellipse. Entered in degrees, the default value is 3 degrees. Lower numbers create a better ellipse and higher numbers make the ellipse draw faster.
ShowLabels {On | Off} Show or hide the major and minor axes labels.
ShowText {On | Off} Show or hide the user defined text.
Text "<Text>" Set user defined text.
BorderWall {Options} Instead of drawing the ellipse as a line, it can be drawn as a border wall. For the options available see VO BorderWall.

Note: The BorderWall keyword must come last in the command syntax or the command will NACK.

Note: The bearing ellipse will render much faster as a line than a Borderwall, especially if the border wall is drawn relative to terrain.

Note: The following keywords have been deprecated in STK10.1.

The deprecated keywords will be maintained for backward compatibility only. They have been replaced by keywords that allow <Value> to be entered in Connect distance units, rather than being restricted to meters.

Deprecated Keyword Use this instead:
SemiMajorAxis MajorAxisLength
SemiMinorAxis MinorAxisLength
MajorAxisOffset OffsetMajorAxis
MinorAxisOffset OffsetMinorAxis

Example

Show a BearingEllipse around FacTest1, with a bearing 60 degrees off North:

VO */Facility/FacTest1 BearingEllipse Show On Bearing 60 MajorAxisLength 12000 color yellow LineStyle dotted LineWidth 2

Show a BearingEllipse around airBearingEllipse3, with a bearing 10 degrees off North:

VO */Aircraft/airBearingEllipse3 BearingEllipse Show On Color yellow Bearing 10

Modify the BearingEllipse around airBearingEllipse3, by adding a Borderwall, 5 kilometers high:

VO */Aircraft/airBearingEllipse3 BearingEllipse Borderwall Show On BottomAltRef Terrain TopAltRef Terrain TopAltRefValue 5000

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Facilities, Places & Targets

Vehicles

VO

VO Objects

Version

10.1

STK Programming Interface 11.0.1