Description | Example | Return Message | Group

VO Marker

Define the display of markers representing objects in the 3D window

Syntax

VO <ObjectPath> Marker ({MarkerOption} <value>)...

Related Commands

Description

The VO Marker command enables you to customize the display of the markers representing facilities, places, targets, and vehicles (any type) in the 3D window. You can use predefined markers or import .ppm files for use as custom markers.

{MarkerOption} <value> Description
Show {On | Off} Hides or shows a marker representing the object specified in the <ObjectPath> when appropriate based on the LOD.
MarkerType {TypeName} {TypeOptions} Specifies the marker, along with its characteristics, that will mark the current position of the object in the 3d Graphics window. Descriptions of the MarkerType syntax is provided in the following table.
Transparent {On | Off | Soft} If on, the lower left corner pixel color of the .ppm file is used as the transparent color. Soft transparency shows smoother edges for images with a transparency channel.

When an image already has an alpha channel and you turn the transparency off, STK will still display the inherent transparency of the image. If it is turned on or too soft when the image already has transparency, STK will still alpha out the first pixel.

Rotate {On | Off} Indicates if marker can be rotated.
Angle <AngleValue> Indicates the rotation angle in degrees (counterclockwise).
RotateForVelocity {On | Off} If turned On the marker will rotate to follow the direction of the velocity vector. If a rotation Angle has been entered, the marker will be rotated by that angle before the rotation for the velocity vector is applied.
RotateFromNorth {On | Off} If turned On the marker will be rotated, relative to North, the number of degrees entered with the Angle option.
VertOrigin {Top | Center | Bottom} Sets the origin point from which the marker will be drawn. Default is Center.
HorizOrigin {Left | Center | Right}
Size <PixelValue> Sets the pixel size of the marker using the <PixelValue>.

Note: Markers do not resize as the window size is changed.

Filled {On | Off} Turn on or off the fill for a symbol id. This option is ignored unless a Symbol ID is being used.
SymbolImageSize <Value> Set the size for the image using a symbol id. The <Value> is an integer greater than zero. This option is ignored unless SymbolID "<SymbolID>" is being used.

Note: To set the size of a symbol ID marker in the 3D window use the Size <PixelValue> option

Valid values for MarkerType {TypeName} {TypeOptions} are:

{TypeName} {TypeOptions} Description
MultiImage KeyName "<name>" Uses a textured marker created from multiple images. The KeyName specifies the name of the marker created using the VO CreateMarker command.
MultiFont KeyName "<name>" Uses a marker created from multiple fonts. The KeyName specifies the name of the marker created using the VO CreateMarker command.
Line Shape {Point | Square | Circle | Triangle | Plus | X | Star} Changes the marker to a line marker and the shape specified.
Font FontName <value> SymbolIndex <IndexValue> [FontSize <value>] When MarkerType is Font, the FontName and SymbolIndex parameters are required to identify the font and particular symbol in the font.
  • FontName is the name of an installed font.
  • SymbolIndex is the index of a symbol (character) in the font.
  • If the FontSize is not specified, the smallest size is loaded. This may make some true type fonts appear blocky. Specify a larger FontSize to sharpen the font. If the particular font size is not available, Windows selects the next closest one. If the desired font does not show up, you may have selected an unsupported font size.
Imagefile [SymbolID "<SymbolID>"] Imagefile "<FilePath>" Displays the image specified using the "<FilePath>" parameter.

In order to specify a marker that is a MIL-STD 2525b symbol (military standard), also include the optional SymbolID "<SymbolID> keyword/value pair. The image associated with the SymbolID "<SymbolID>" will be generated and displayed, and then that image will be saved to the path specified in the "<FilePath>". The saved file will be a bitmap file, so the file should have a .bmp extension.

Note: To use the 2525B Symbology Marker, you must download and install the 2525B Symbol Server.

Example

To use a line marker in the shape of a triangle at 6 pixels to represent Facility 1:

VO */Facility/Facility1 Marker MarkerType Line Shape Triangle Size 6

To use the sjgpewrh--mtusg MIL-STD 2525b symbol to represent the ERS1's current positon in the 3D Graphics window:

VO */Satellite/ERS1 Marker MarkerType ImageFile SymbolId "shgpewrh--mtusg" Imagefile "C:\test.bmp" Show On

To use the sjgpewrh--mtusg MIL-STD 2525b symbol to represent the ERS1's current positon in the 3D Graphics window, and to show the symbol filled and transparent:

VO */Satellite/ERS1 marker show on markertype imagefile imagefile "c:/blahh0.bmp" SymbolID "sjgpewrh--mtusg" filled on transparent on

To set the Satellite's marker to be rotated 45 degrees from North:

VO */Satellite/Satellite1 Marker Rotate On Angle 45 RotateFromNorth On

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

9.0

STK Programming Interface 11.0.1