Define the display of markers representing objects in the 3D window
VO <ObjectPath> Marker ({MarkerOption} <value>)...
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.
|
| 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. |
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
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
9.0
STK Programming Interface 11.0.1