SightLine Applications Command, Control, and Script API  v3.6
List of all members
SLADrawObject_t Struct Reference

Description

Deprecated, use SLADrawOverlay_t

typedef struct {
u8 objId;
u8 action;
u8 propertyFlags;
u8 type;
u16 a;
u16 b;
u16 c;
u16 d;
u8 backgroundColor;

Deprecated, use SLADrawOverlay_t

Object Types

Value Description
0 Circle
1 Rectangle
2 Line
3 Reserved
4 Filled Circle
5 Filled Rectangle
6 Text Extended
7 Reserved
8 KLV Field
9 to 254 Reserved
255 Error or Object Not Found

Object Type Specific Parameters

Object Type a b c d
Circle Center X Center Y Radius
Filled Circle Center X Center Y Radius
Rectangle Upper left corner X Upper left corner Y Width Height
Filled rectangle Upper left corner X Upper left corner Y Width Height
Line End point 1 X End point 1 Y End point 2 X End point 2 Y
Text Extended Upper left X Upper left Y H Scaling | V Scaling Font ID | Spacing
KLV Field Upper left X Upper left Y Scaling, Font ID Field, Format

H Scaling

Horizontal scale shifted left 5 (e.g. 32 means no scaling. 0 is also interpreted as no scaling). Not used for font ID 5 and higher.

V Scaling

Vertical scale shifted left 5. Not used for font ID 5 and higher.

Spacing

Pixels between a font to the next font. If 0, then uses the font's default spacing. Not used for font ID 5 and higher.

Text Extended Object Type

Parameter Bits Description
c 0-7 Horizontal scaling is value of (Bits 0-7)/32, 0 = no scaling
c 8-15 Vertical scaling is value of (Bits 8-15)/32, 0 = no scaling
d 0-4 Font ID 0 = Courier, 1 = Courier bold, 5 = Arial, 6 = Arial Bold, 7 = Verdana, 8 = Verdana Bold, 9 = Calibri, 10 = Calibri Bold
d 5 Enable fixed width – applicable to fonts with ID 5..10
d 6 Enable outline effect – applicable when background color set to transparent
d 7 Enable shadow effect – applicable when background color set to transparent
d 8-15 Pixels between a font to the next font; 0 = font default spacing

KLV Field Object Type

Parameter Bits Description
c 0-7 Horizontal and Vertical scaling is value of (Bits 0-7)/32, 0 = no scaling
c 8-12 Font ID 0 = Courier, 1 = Courier bold, 5 = Arial, 6 = Arial Bold, 7 = Verdana, 8 = Verdana Bold, 9 = Calibri, 10 = Calibri Bold
c 13 Enable fixed width – applicable to fonts with ID 5..10
c 14 Enable outline effect – applicable when background color set to transparent
c 15 Enable shadow effect – applicable when background color set to transparent
d 0-7 KLV Field
d 8-15 KLV Format

KLV Field Options

Value Field Name KLV Format
0 UTC Time Time
1 Mission ID N/A (Send 0)
2 Platform Heading Angle
3 Platform Pitch Angle
4 Platform Roll Angle
7 Sensor Latitude Position
8 Sensor Longitude Position
9 Sensor Altitude Distance
10 Sensor HFOV Angle
11 Sensor VFOV Angle
12 Sensor Relative Azimuth Angle Angle
13 Sensor Relative Elevation Angle Angle
14 Sensor Relative Roll Angle Angle
15 Frame Center Latitude Position
16 Frame Center Longitude Position
17 Frame Center Elevation Distance
19 Slant Range Distance
20 Target Location ElevationDistance
21 Target Location Latitude Position
22 Target Location Longitude Position

KLV Format Types

Type Values
Time 0 = YYYY-MM-DD hh:mm:ss, 1 = DDMonthYYYY, 2 = HH:MM:SS, 3 = Month DD YYYY, 4 = MM/DD/YY, 5 = MM/DD/YYYY, 6 = DD HHMMZ MON YY (DTG), 7 = DDHHMMZMONYY (DTG - No Spaces)
Angle 0 = Degrees, 1 = Radians, 2 = Milliradians
Distance 0 = Meters, 1 = Feet
Position 0 = MGRS-10 (1 Meter), 1 = Decimal Degrees, 2 = Degrees Minutes Seconds, 3 = MGRS-8 (10 Meter)

Color To Number Mapping

Value Color Value Color
0 White 8 Light Green
1 Black 9 Green
2 Light Gray 10 Dark Green
3 Gray 11 Red
4 Dark Gray 12 Orange
5 Light Blue 13 Yellow
6 Blue 14 Transparent
7 Dark Blue 15 Automatic

Message ID 0x3B

Byte Offset Name Description
4objIdUnique object ID
ID Description - Maximum number of unique objects is 128
0 Used for destroying all objects when Action==Destroy
1 - 199 Unique ID for each object created
200 - 255 Reserved
5actionAction to perform
0 = Destroy specified object ID
1 = Create new object with specified object ID
6propertyFlags
BitsDescription
0 - 31Coordinates are specified in source coordinate space and object is drawn at the specified location in the source image
2Coordinates are specified in display coordinate space and object is moved along with scene motion – equivalent to scene mode tracking with a custom overlay
4Static overlays that do not move (such as text), coordinates are specified in display coordinate space (default)
otherReserved
4 - 5Reserved
60 – don't save this object, 1 – save this object to parameter file (only valid if action is set to create). New 2.24
70 – coordinate origin (0,0) is at the center of the image, 1 – coordinate origin is at the upper left corner of the image
7typeObject Types
8-9aObject Type Specific Parameters
10-11bObject Type Specific Parameters
12-13cObject Type Specific Parameters
14-15dObject Type Specific Parameters
16backgroundColorObject Color
BitsDescription
0-3Background color: for vertical and horizontal lines, the background color is drawn as a shadow; use transparent (14) to disable drawing of shadow
4-7Foreground color: for filled objects "Automatic" will result in object being filled with a partially transparent middle gray value which can be used as a background for drawing text to ensure the text is always visible. For non filled objects it will be either white or black depending on the scene content.
Note: See action byte for setting transparency level for filled objects.
Note: Transparent is not supported for text foreground
Note: Using the same foreground and background color for text including automatic will result in unreadable text.
17textText and KLV objects only: text string (64 characters max)
For KLV objects use "%s" for time, mission ID, latitude, and longitudes and "%f" for all others.
Example "Time: %s"
Example "Slant Range: %05.0f (ft)"
Example "HFOV: %2.1f (deg)"
Example "Sensor Position: %s"