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

Description

NOTE: Newer functionality in SLAStartTracking_t.

typedef struct {
u16 col;
u16 row;
u8 flags;
u8 width;
u8 height;
u8 cameraIndex;

Command the system to modify tracking: start a track, stop a track, designate a track as primary, nudge a track, etc.

Column and Row coordinates correspond to the pixel coordinate within a frame of video in display(stabilized) coordinates. The origin is in the upper left corner of the image with values increasing down and to the right. Up to 5 tracks may be simultaneously engaged. See the Target Tracking Guide for more details about tracking multiple targets. To control specifying tracks 'near' existing tracks, see SLASetTrackingParameters_t.nearVal. See SLACurrentImageSize_t for more information about capture image size. See also SLACommandCamera_t.

Modify Mode
ValueDescription
0Show Cursor only. If in this mode Display Coordinate and Source Coordinate bits are ignored.
1Kill any existing targets and then designate a new primary target at the cursor.
2Designate a primary target at the cursor.
3If there is a track near the coordinates, move track to coordinates and make secondary.
4If there is a track near the coordinates, move track to coordinates and make secondary. Otherwise, add a new secondary track at coordinate location.
5Designate track near coordinates as primary target. Also supports starting primary tracks from detections.
6Designate track near coordinates as primary target if there is one. If not, add new track at coordinates and make primary. Also supports starting primary tracks from detections.
7If there is a track near coordinates, move track to location of coordinates and designate as primary. Otherwise, add a new track at coordinates and make primary.
8If there is a track near coordinates, move track to location of coordinates and designate as primary. Otherwise, kill all existing tracks and add a new primary track at location of coordinates.
9Kill track near coordinates.
10Kill all tracks, but the primary track. (Coordinates are ignored).
11Reserved
12Designate track near coordinates as secondary target. Also supports starting secondary tracks from detections.
13Designate track near coordinates as secondary target if there is one. If not, add new track at coordinates and make secondary. Also supports starting secondary tracks from detections.

Message ID 0x05

Byte Offset Name Description
4-5colTrack column coordinate
6-7rowTrack row coordinate
8flags

Coordinate space flag and modification mode. Coordinate space bits – OR these with any modify mode.
NOTE: Do not set both Display and Source coordinates.

BitsDescription
7Display Coordinates – Rotate Zoom Modifier. OR this flag (set bit 7 to 1) with any of the modify modes to indicate coordinates are rotated and zoomed with the display. By default, set this flag (bit 7 = 1) for coordinates in the display image space.
6Source Coordinates – OR this flag (set bit 6 to 1) with any of the modify modes to indicate that the coordinates specified are in the source image. By default, don't set this flag (bit 6 = 0) for coordinates in the display image space.
0-5Modify Mode

9widthwidth of object in pixels to track. (for user designated tracking). New 2.24
If width is not included or zero the sizes specified in SLASetTrackingParameters_t will be used.
If width is not included or zero the height parameter will be ignored and values specified in SLASetTrackingParameters_t will be used.
NOTE: In static track mode, if width or height is 255, use full screen for track box pixel stats.
10heightheight of object in pixels to track. (for user designated tracking). New 2.24
If height is not included or zero and width is non zero the width will be used resulting in a square track box.
If height and width are not included or both zero the sizes specified in SLASetTrackingParameters_t will be used.
11cameraIndexCamera Index