Struct LEAP_TRACKING_EVENT¶

struct LEAP_TRACKING_EVENT

A snapshot, or frame of data, containing the tracking data for a single moment in time.

The LEAP_FRAME struct is the container for all the tracking data.

Since

3.0.0

Public Members

LEAP_FRAME_HEADER info

A universal frame identification header.

Since

3.0.0

int64_t tracking_frame_id

An identifier for this tracking frame.

This identifier is meant to be monotonically increasing, but values may be skipped if the client application does not poll for messages fast enough. This number also generally increases at the same rate as info.frame_id, but if the server cannot process every image received from the device cameras, the info.frame_id identifier may increase faster.

Since

3.0.0

uint32_t nHands

The number of hands tracked in this frame, i.e.

the number of elements in the pHands array.

Since

3.0.0

LEAP_HAND *pHands

A pointer to the array of hands tracked in this frame.

Since

3.0.0

float framerate

Current tracking frame rate in hertz.

This frame rate is distinct from the image frame rate, which is the rate that images are being read from the device. Depending on host CPU limitations, the tracking frame rate may be substantially less than the device frame rate.

This number is generally equal to or less than the device frame rate, but there is one case where this number may be higher than the device frame rate: When the device rate drops. In this case, the device frame rate will fall sooner than the tracking frame rate.

This number is equal to zero if there are not enough frames to estimate frame rate.

This number cannot be negative.

Since

3.0.0