VO Primitive

Defines and modifies programmable graphics primitives.

Syntax

VO <ScenarioPath> Primitive {Add | Modify | Delete | Import | Export} {PrimitiveID} [Type {PrimitiveType}] ({PrimitiveOption} <Value>)...

Related commands

• VO_R Primitive

Description

You must define each primitive by a unique ID number. This number can be negative, 0, or positive. No two primitives can share the same ID. Specify the {PrimitiveID} by one of the following methods:

When adding a primitive, use the VO_R Primitive command to request that STK generate, and return, a unique ID.

Valid values for {PrimitiveType} are as follows:

The Type {PrimitiveType} is required if the action is Add.

Options that define a primitive are required if the action is Add.

The following tables describe the {PrimitiveOption} <Value> pairs used to define or modify any type of primitive.

Import and Export

You can use these options to create a file containing the Primitives defined in the current scenario and then load those primitives into another scenario.

The format for these options is: VO <ScenarioPath> Primitive {Import | Export} "<FilePath>"

When Exporting, the specified directory must already exist. If the file exists, it will be overwritten; otherwise it will be created.

When importing, please be aware of the following issues:

• STK will not import primitives with duplicate IDs.
• If an imported primitive is attached to a BodyFrame and the body frame object does not exist in the scenario, then STK will not display the primitive.
• If an imported primitive includes time intervals and the time intervals are outside the scenario's analysis period, then STK will not display the primitive.

The following are examples using the Import and Export options.

VO * Primitive Export "C:\Users\Documents\STK 9\Prims6509.txt"

VO * Primitive Import "C:\Users\Documents\STK 9\Prims6509.txt"

Common Primitive Options

The following options are valid for all primitive types (except as noted).

Line Primitive Options

The Line primitive is defined using Points. Options available for Line {PrimitiveType} are described in the following table.

See also Common Primitive options above.

Examples

Draw a green arrow at the surface for Aircraft airArrow:

Arc Primitive Options

The Arc primitive is defined using Points. Options available for Arc {PrimitiveType} are described in the following table.

See also Common Primitive options above.

RhumbLine Primitive Options

The RhumbLine primitive is defined using Points. Options available for RhumbLine {PrimitiveType} are described in the following table.

See also Common Primitive options above.

Polygon Primitive Options

The Polygon primitive is defined using Points. Options available for Polygon {PrimitiveType} are described in the following table.

See also Common Primitive options above.

The Polygon primitive must have at least three points defined.

ArcPolygon Primitive Options

The ArcPolygon primitive is defined using Points. Options available for ArcPolygon {PrimitiveType} are described in the following table.

See also Common Primitive options above.

The ArcPolygon primitive must have at least three points defined.

Examples

Add an ArcPolygon primitive:

SurfacePolygon Primitive Options

The SurfacePolygon primitive is defined using Points, and conforms to terrain. Options available for SurfacePolygon {PrimitiveType} are described in the following table.

See also Common Primitive options above.

The BodyFrame option is not valid for the SurfacePolygon primitive type.

The SurfacePolygon primitive must have at least three points defined.

Examples

Add a SurfacePolygon primitive:

Model Primitive Options

The Model primitive is defined by a single Position and model Filename. Options available for Model {PrimitiveType} are described in the following table.

See also Common Primitive options above.

Examples

Show a 747 airplane model under Satellite1:

Ellipse Primitive Options

The Ellipse primitive is defined by a Center point, MajorAxis, MinorAxis, and Bearing. Options available for Ellipse {PrimitiveType} are described in the following table.

See also Common Primitive options above.

Examples

Define an Ellipse primitive:

SurfaceEllipse Primitive Options

The SurfaceEllipse primitive is defined by a Center point, MajorAxis, MinorAxis, and Bearing, and conforms to terrain. Options available for SurfaceEllipse {PrimitiveType} are described in the following table.

See also Common Primitive options above.

The BodyFrame option is not valid for the SurfaceEllipse primitive type.

Examples

Define a SurfaceEllipse primitive:

Circle Primitive Options

The Circle primitive is defined by a Center point and Radius. Options available for Circle {PrimitiveType} are described in the following table.

See also Common Primitive options above.

Examples

Define a Circle primitive:

SurfaceCircle Primitive Options

The SurfaceCircle primitive is defined by a Center point and Radius and conforms to terrain. Options available for SurfaceCircle {PrimitiveType} are described in the following table.

See also Common Primitive options above.

The BodyFrame option is not valid for the SurfaceCircle primitive type.

Examples

Define a SurfaceCircle primitive:

Rectangle Primitive Options

The Rectangle primitive is defined by a Center point, Length, Width, and Bearing. Options available for Rectangle {PrimitiveType} are described in the following table.

See also Common Primitive options above.

Examples

Define a Rectangle primitive:

SurfaceRectangle Primitive Options

The SurfaceRectangle primitive is defined by a Center point, Length, Width, and Bearing, and conforms to terrain. Options available for SurfaceRectangle {PrimitiveType} are described in the following table.

See also Common Primitive options above.

The BodyFrame option is not valid for the SurfaceRectangle primitive type.

Examples

Define a SurfaceRectangle primitive:

Sector Primitive Options

The Sector primitive is defined by a Center point, InnerRadius, OuterRadius, Bearing, and EndBearing. Options available for Sector {PrimitiveType} are described in the following table.

See also Common Primitive options above.

Examples

Define a Sector primitive:

SurfaceSector Primitive Options

The SurfaceSector primitive is defined by a Center point, InnerRadius, OuterRadius, Bearing, and EndBearing, and conforms to terrain. Options available for SurfaceSector {PrimitiveType} are described in the following table.

See also Common Primitive options above.

The BodyFrame option is not valid for the SurfaceSector primitive type.

Examples

Define a SurfaceSector primitive:

Corridor Primitive Options

The Corridor primitive is defined using Points and a Width. Options available for Corridor {PrimitiveType} are described in the following table.

See also Common Primitive options above.

Examples

Add a Corridor primitive to the scenario:

Wall Primitive Options

The Wall primitive is defined using an existing primitive (SrcPrimID). Options available for Wall {PrimitiveType} are described in the following table.

See also Common Primitive options above.

The BodyFrame option is not valid for the Wall primitive type.

Examples

Define a Circle primitive and define a Wall on that Circle, then delete the original Circle primitive:

Point Type Options

If the primitive is not attached to a BodyFrame the following {PointType} options are valid:

If the primitive is attached to a BodyFrame, the following {PointType} options are valid:

Identifying Primitives

The ID of a primitive can be determined using asynchronous 3D picking. When asynchronous 3D picking is enabled, double-clicking a primitive will return a string, via Connect, that includes the primitive ID. See Async3DPick for more information.

Examples

The following series of commands will create two line primitives, add intervals to both, and modify the intervals to change the line color and width over time:

Define the first primitive:

Define the second primitive:

Modify both primitives to draw using the great arc:

Add 3 intervals to both primitives:

Modify the primitives to be red, with a width of 1 during the first interval:

Modify the primitives to be white, with a width of 2 during the second interval:

Modify the primitives to be blue, with a width of 3 during the third interval:

Examples

Define a Circle primitive and define a Wall on that Circle, then delete the original Circle primitive:

Examples

Turn on the display of primitive 1 on 3D Window 1:

Turn off the display of primitives 34 and 35 on All 3D Windows:

Return message

Group membership

This command belongs to the following group(s):

VO

VO Window

Version

12.1