tobii_research_eyetracker.h

Go to the documentation of this file.

 
#ifndef TOBII_RESEARCH_EYETRACKER_H_
#define TOBII_RESEARCH_EYETRACKER_H_
 
#include "tobii_research.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum {
    TOBII_RESEARCH_CAPABILITIES_NONE,
 
    TOBII_RESEARCH_CAPABILITIES_CAN_SET_DISPLAY_AREA = 1 << 0,
 
    TOBII_RESEARCH_CAPABILITIES_HAS_EXTERNAL_SIGNAL = 1 << 1,
 
    TOBII_RESEARCH_CAPABILITIES_HAS_EYE_IMAGES = 1 << 2,
 
    TOBII_RESEARCH_CAPABILITIES_HAS_GAZE_DATA  = 1 << 3,
 
    TOBII_RESEARCH_CAPABILITIES_HAS_HMD_GAZE_DATA = 1 << 4,
 
    TOBII_RESEARCH_CAPABILITIES_CAN_DO_SCREEN_BASED_CALIBRATION = 1 << 5,
 
    TOBII_RESEARCH_CAPABILITIES_CAN_DO_HMD_BASED_CALIBRATION = 1 << 6,
 
    TOBII_RESEARCH_CAPABILITIES_HAS_HMD_LENS_CONFIG = 1 << 7,
 
    TOBII_RESEARCH_CAPABILITIES_CAN_DO_MONOCULAR_CALIBRATION = 1 << 8,
 
    TOBII_RESEARCH_CAPABILITIES_HAS_EYE_OPENNESS_DATA = 1 << 9,
} TobiiResearchCapabilities;
 
typedef struct {
    TobiiResearchPoint3D back_lower_left;
 
    TobiiResearchPoint3D back_lower_right;
 
    TobiiResearchPoint3D back_upper_left;
 
    TobiiResearchPoint3D back_upper_right;
 
    TobiiResearchPoint3D front_lower_left;
 
    TobiiResearchPoint3D front_lower_right;
 
    TobiiResearchPoint3D front_upper_left;
 
    TobiiResearchPoint3D front_upper_right;
} TobiiResearchTrackBox;
 
typedef enum TobiiResearchLicenseValidationResult {
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_OK,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_TAMPERED,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_INVALID_APPLICATION_SIGNATURE,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_NONSIGNED_APPLICATION,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_EXPIRED,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_PREMATURE,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_INVALID_PROCESS_NAME,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_INVALID_SERIAL_NUMBER,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_INVALID_MODEL,
 
    TOBII_RESEARCH_LICENSE_VALIDATION_RESULT_UNKNOWN
} TobiiResearchLicenseValidationResult;
 
typedef struct {
    TobiiResearchPoint3D bottom_left;
 
    TobiiResearchPoint3D bottom_right;
 
    float height;
 
    TobiiResearchPoint3D top_left;
 
    TobiiResearchPoint3D top_right;
 
    float width;
} TobiiResearchDisplayArea;
 
typedef struct {
    void* data;
    size_t size;
} TobiiResearchCalibrationData;
 
typedef struct {
    float* frequencies;
    size_t frequency_count;
} TobiiResearchGazeOutputFrequencies;
 
typedef struct {
    char** modes;
    size_t mode_count;
} TobiiResearchEyeTrackingModes;
 
typedef struct {
    TobiiResearchPoint3D left;
    TobiiResearchPoint3D right;
} TobiiResearchHMDLensConfiguration;
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_address(
        TobiiResearchEyeTracker* eyetracker, char** address);
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_serial_number(
        TobiiResearchEyeTracker* eyetracker, char** serial_number);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_device_name(
        TobiiResearchEyeTracker* eyetracker, char** device_name);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_model(
        TobiiResearchEyeTracker* eyetracker, char** model);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_firmware_version(
        TobiiResearchEyeTracker* eyetracker, char** fw_version);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_runtime_version(
        TobiiResearchEyeTracker* eyetracker, char** runtime_version);
 
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_capabilities(
        TobiiResearchEyeTracker* eyetracker, TobiiResearchCapabilities* capabilities);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_retrieve_calibration_data(
        TobiiResearchEyeTracker* eyetracker,
        TobiiResearchCalibrationData** data);
 
TOBII_RESEARCH_API void TOBII_RESEARCH_CALL tobii_research_free_calibration_data(
        TobiiResearchCalibrationData* data);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_apply_calibration_data(
        TobiiResearchEyeTracker* eyetracker,
        const TobiiResearchCalibrationData* data);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_all_gaze_output_frequencies(
        TobiiResearchEyeTracker* eyetracker,
        TobiiResearchGazeOutputFrequencies** frequencies);
 
TOBII_RESEARCH_API void TOBII_RESEARCH_CALL tobii_research_free_gaze_output_frequencies(
        TobiiResearchGazeOutputFrequencies* frequencies);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_gaze_output_frequency(
        TobiiResearchEyeTracker* eyetracker,
        float* gaze_output_frequency);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_set_gaze_output_frequency(
        TobiiResearchEyeTracker* eyetracker,
        float gaze_output_frequency);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_all_eye_tracking_modes(
        TobiiResearchEyeTracker* eyetracker,
        TobiiResearchEyeTrackingModes** modes);
 
 
TOBII_RESEARCH_API void TOBII_RESEARCH_CALL tobii_research_free_eye_tracking_modes(
        TobiiResearchEyeTrackingModes* modes);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_eye_tracking_mode(
        TobiiResearchEyeTracker* eyetracker,
        char** eye_tracking_mode);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_set_eye_tracking_mode(
        TobiiResearchEyeTracker* eyetracker,
        const char* eye_tracking_mode);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_track_box(
        TobiiResearchEyeTracker* eyetracker,
        TobiiResearchTrackBox* track_box);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_apply_licenses(
        TobiiResearchEyeTracker* eyetracker,
        const void** license_key,
        size_t* license_keys_size,
        TobiiResearchLicenseValidationResult* validation_results,
        size_t number_of_licenses);
 
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_clear_applied_licenses(
        TobiiResearchEyeTracker* eyetracker);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_display_area(
        TobiiResearchEyeTracker* eyetracker,
        TobiiResearchDisplayArea* display_area);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_set_display_area(
        TobiiResearchEyeTracker* eyetracker,
        const TobiiResearchDisplayArea* display_area);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_set_device_name(
        TobiiResearchEyeTracker* eyetracker,
        const char* device_name);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_get_hmd_lens_configuration(
        TobiiResearchEyeTracker* eyetracker,
        TobiiResearchHMDLensConfiguration* lens_configuration);
 
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_set_hmd_lens_configuration(
        TobiiResearchEyeTracker* eyetracker,
        const TobiiResearchHMDLensConfiguration* lens_configuration);
 
#ifdef __cplusplus
}
#endif
#endif /* TOBII_RESEARCH_EYETRACKER_H_ */