Skip to main content
Version: 20 Mar 2024

MLGazeRecognitionState

Module: Gaze Recognition

Information about the state of the Gaze Recognition system. This structure must be initialized by calling MLGazeRecognitionStateInit() before use. More...

#include <ml_gaze_recognition.h>

Public Attributes

TypeName
uint32_tversion
MLTimetimestamp
MLGazeRecognitionErrorerror
MLGazeRecognitionBehaviorbehavior
MLVec2feye_left
MLVec2feye_right
floatonset_s
floatduration_s
floatvelocity_degps
floatamplitude_deg
floatdirection_radial

Detailed Description

struct MLGazeRecognitionState;

Information about the state of the Gaze Recognition system. This structure must be initialized by calling MLGazeRecognitionStateInit() before use.

API Level:

  • 20

Public Attributes Documentation

version

uint32_t version;

Version of this structure.


timestamp

MLTime timestamp;

The timestamp accociated with all data fields in this struct.


error

MLGazeRecognitionError error;
TypeDescription
MLGazeRecognitionErrorA set of possible error codes that the Gaze Recognition system can report.

Represents what gaze Recognition error (if any) is present.


behavior

MLGazeRecognitionBehavior behavior;
TypeDescription
MLGazeRecognitionBehaviorA set of mutually-exclusive behaviors that the Gaze Recognition system can report.

Represents what known gaze Recognition behavior is present.


eye_left

MLVec2f eye_left;

A vector for eye-in-skull position of left eye, even if right eye is closed.


eye_right

MLVec2f eye_right;

A vector for eye-in-skull position of right eye, even if left eye is closed.


onset_s

float onset_s;

Metadata field for onset of the current behavior, in seconds. Onset applies to all behaviors and marks the time when the current behavior began.


duration_s

float duration_s;

Metadata field for duration of the current behavior, in seconds. Duration applies to all gaze types.


velocity_degps

float velocity_degps;

Metadata field for velocity of the current movement, in degrees per second. Velocity field applies to saccades and pursuit, otherwise NaN.


amplitude_deg

float amplitude_deg;

Metadata field for amplitude of the current movement, which is eye-position displacement in degrees of visual angle. Amplitude applies to saccades and pursuit, otherwise NaN.


direction_radial

float direction_radial;

Metadata field for direction of the current movement, in radial degrees (0-360). Direction field applies to saccades and pursuit, otherwise NaN.