Functionality for implementing calibration. More...

Data Structures
struct	TobiiResearchCalibrationEyeData

struct	TobiiResearchCalibrationSample

struct	TobiiResearchCalibrationPoint

struct	TobiiResearchCalibrationResult

struct	TobiiResearchHMDCalibrationResult

Enumerations

Functions
TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_screen_based_calibration_enter_calibration_mode (TobiiResearchEyeTracker *eyetracker)
	Enters the screen based calibration mode and the eye tracker is made ready for collecting data and calculating new calibrations. More...

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_screen_based_calibration_leave_calibration_mode (TobiiResearchEyeTracker *eyetracker)
	Leaves the screen based calibration mode. More...

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_screen_based_calibration_collect_data (TobiiResearchEyeTracker *eyetracker, float x, float y)
	Starts collecting data for a calibration point. More...

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_screen_based_calibration_discard_data (TobiiResearchEyeTracker *eyetracker, float x, float y)
	Removes the collected data associated with a specific calibration point. More...

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_screen_based_calibration_compute_and_apply (TobiiResearchEyeTracker eyetracker, TobiiResearchCalibrationResult *result)
	Uses the collected data and tries to compute calibration parameters. More...

TOBII_RESEARCH_API void TOBII_RESEARCH_CALL	tobii_research_free_screen_based_calibration_result (TobiiResearchCalibrationResult *result)
	Free memory allocation for the calibration result received via tobii_research_screen_based_calibration_compute_and_apply. More...

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_hmd_based_calibration_enter_calibration_mode (TobiiResearchEyeTracker *eyetracker)
	Enters the hmd based calibration mode and the eye tracker is made ready for collecting data and calculating new calibrations. More...

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_hmd_based_calibration_leave_calibration_mode (TobiiResearchEyeTracker *eyetracker)
	Leaves the hmd based calibration mode. More...

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_hmd_based_calibration_collect_data (TobiiResearchEyeTracker *eyetracker, float x, float y, float z)
	Starts collecting data for a calibration point. More...

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL	tobii_research_hmd_based_calibration_compute_and_apply (TobiiResearchEyeTracker eyetracker, TobiiResearchHMDCalibrationResult result)
	Uses the collected data and tries to compute calibration parameters. More...

Detailed Description

Functionality for implementing calibration.

Copyright: COPYRIGHT 2017 - PROPERTY OF TOBII AB; 2017 TOBII AB - KARLSROVAGEN 2D, DANDERYD 182 53, SWEDEN - All Rights Reserved.; NOTICE: All information contained herein is, and remains, the property of Tobii AB and its suppliers, if any. The intellectual and technical concepts contained herein are proprietary to Tobii AB and its suppliers and may be covered by U.S.and Foreign Patents, patent applications, and are protected by trade secret or copyright law. Dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from Tobii AB.

Enumeration Type Documentation

enum TobiiResearchCalibrationEyeValidity

Defines the validity of calibration eye data.

Enumerator
TOBII_RESEARCH_CALIBRATION_EYE_VALIDITY_INVALID_AND_NOT_USED	The eye tracking failed or the calibration eye data is invalid.
TOBII_RESEARCH_CALIBRATION_EYE_VALIDITY_VALID_BUT_NOT_USED	Eye Tracking was successful, but the calibration eye data was not used in calibration e.g. gaze was too far away.
TOBII_RESEARCH_CALIBRATION_EYE_VALIDITY_VALID_AND_USED	The calibration eye data was valid and used in calibration.
TOBII_RESEARCH_CALIBRATION_EYE_VALIDITY_UNKNOWN	The calibration eye data has an unexpected validity.

enum TobiiResearchCalibrationStatus

"Defines the overall status of a calibration process.

Enumerator
TOBII_RESEARCH_CALIBRATION_FAILURE	Indicates that the calibration process failed.
TOBII_RESEARCH_CALIBRATION_SUCCESS	Indicates that the calibration process succeeded.

Function Documentation

TOBII_RESEARCH_API void TOBII_RESEARCH_CALL tobii_research_free_screen_based_calibration_result ( TobiiResearchCalibrationResult * result )

Free memory allocation for the calibration result received via tobii_research_screen_based_calibration_compute_and_apply.

Parameters

result Calibration result to free.

Examples:: calibration.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_hmd_based_calibration_collect_data	(	TobiiResearchEyeTracker *	eyetracker,
		float	x,
		float	y,
		float	z
	)

Starts collecting data for a calibration point.

The argument used is the point the calibration user is assumed to be looking at and is given in the HMD coordinate system.

You must call tobii_research_screen_based_calibration_enter_calibration_mode before calling this function. This function is blocking while collecting data and may take up to 10 seconds.

Parameters

eyetracker	Eye tracker object.
x	x coordinate in the HMD coordinate system where the user is looking.
y	y coordinate in the HMD coordinate system where the user is looking.
z	z coordinate in the HMD coordinate system where the user is looking.

Returns: A TobiiResearchStatus code.

Examples:: hmd_calibration.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_hmd_based_calibration_compute_and_apply	(	TobiiResearchEyeTracker *	eyetracker,
		TobiiResearchHMDCalibrationResult *	result
	)

Uses the collected data and tries to compute calibration parameters.

If the calculation is successful, the result is applied to the eye tracker. If there is insufficient data to compute a new calibration or if the collected data is not good enough then calibration is failed and will not be applied.

    /* Define the points we should calibrate at. */
    /* The coordinates are in HMD coordinates (x,y,z) */
    {
        #define NUM_OF_POINTS  3U
        TobiiResearchPoint3D points_to_calibrate[NUM_OF_POINTS] = \
                {{0.0f, 0.0f, 1000.0f}, {20.0f, 0.0f, 1000.0f}, {0.0f, 20.0f, 1000.0f}};
        size_t i = 0;
        for(; i < NUM_OF_POINTS; i++) {
            TobiiResearchPoint3D* point = &points_to_calibrate[i];
            printf("Show a point on screen at (%f,%f).\n", point->x, point->y);
            //  Wait a little for user to focus.
            sleep_ms(700);
            printf("Collecting data at (%f,%f,%f).\n", point->x, point->y, point->z);
            if (tobii_research_hmd_based_calibration_collect_data(eyetracker, point->x, point->y, point->z) != TOBII_RESEARCH_STATUS_OK) {
                /* Try again if it didn't go well the first time. */
                /* Not all eye tracker models will fail at this point, but instead fail on ComputeAndApply. */
                tobii_research_hmd_based_calibration_collect_data(eyetracker, point->x, point->y, point->z);
            }
        }
        printf("Computing and applying calibration.\n");
        TobiiResearchHMDCalibrationResult calibration_result;
        status = tobii_research_hmd_based_calibration_compute_and_apply(eyetracker, &calibration_result);
        if (status == TOBII_RESEARCH_STATUS_OK) {
            if (calibration_result.status == TOBII_RESEARCH_CALIBRATION_SUCCESS)
                printf("Calibration was successful!\n");
            else if (calibration_result.status == TOBII_RESEARCH_CALIBRATION_FAILURE)
                printf("Calibration failed!\n");
        }

Parameters

eyetracker	Eye tracker object.
result	Represents the result of the calculated HMD calibration.

Returns: A TobiiResearchStatus code.

Examples:: hmd_calibration.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_hmd_based_calibration_enter_calibration_mode ( TobiiResearchEyeTracker * eyetracker )

Enters the hmd based calibration mode and the eye tracker is made ready for collecting data and calculating new calibrations.

Parameters

eyetracker Eye tracker object.

Returns: A TobiiResearchStatus code.

Examples:: hmd_calibration.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_hmd_based_calibration_leave_calibration_mode ( TobiiResearchEyeTracker * eyetracker )

Leaves the hmd based calibration mode.

    /* The calibration is done. Leave calibration mode. */
    status = tobii_research_hmd_based_calibration_leave_calibration_mode(eyetracker);
    printf("Left calibration mode.\n");

Parameters

eyetracker Eye tracker object.

Returns: A TobiiResearchStatus code.

Examples:: hmd_calibration.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_screen_based_calibration_collect_data	(	TobiiResearchEyeTracker *	eyetracker,
		float	x,
		float	y
	)

Starts collecting data for a calibration point.

The argument used is the point the calibration user is assumed to be looking at and is given in the active display area coordinate system.

You must call tobii_research_calibration_enter_calibration_mode before calling this function. This function is blocking while collecting data and may take up to 10 seconds.

    /* Define the points on screen we should calibrate at. */
    /* The coordinates are normalized, i.e. (0.0, 0.0) is the upper left corner and (1.0, 1.0) is the lower right corner. */
    {
        #define NUM_OF_POINTS  5U
        TobiiResearchNormalizedPoint2D points_to_calibrate[NUM_OF_POINTS] = \
                {{0.5f, 0.5f}, {0.1f, 0.1f}, {0.1f, 0.9f}, {0.9f, 0.1f}, {0.9f, 0.9f}};
        size_t i = 0;
        for(; i < NUM_OF_POINTS; i++) {
            TobiiResearchNormalizedPoint2D* point = &points_to_calibrate[i];
            printf("Show a point on screen at (%f,%f).\n", point->x, point->y);
            //  Wait a little for user to focus.
            sleep_ms(700);
            printf("Collecting data at (%f,%f).\n", point->x, point->y);
            if (tobii_research_screen_based_calibration_collect_data(eyetracker, point->x, point->y) != TOBII_RESEARCH_STATUS_OK) {
                /* Try again if it didn't go well the first time. */
                /* Not all eye tracker models will fail at this point, but instead fail on ComputeAndApply. */
                tobii_research_screen_based_calibration_collect_data(eyetracker, point->x, point->y);
            }
        }
        printf("Computing and applying calibration.\n");
        TobiiResearchCalibrationResult* calibration_result = NULL;
        status = tobii_research_screen_based_calibration_compute_and_apply(eyetracker, &calibration_result);
        if (status == TOBII_RESEARCH_STATUS_OK && calibration_result->status == TOBII_RESEARCH_CALIBRATION_SUCCESS) {
            printf("Compute and apply returned %i and collected at %zu points.\n", status, calibration_result->calibration_point_count);
        } else {
            printf("Calibration failed!\n");
        }
        /* Free calibration result when done using it */
        tobii_research_free_screen_based_calibration_result(calibration_result);

Parameters

eyetracker	Eye tracker object.
x	Normalized x coordinate on active display area where the user is looking.
y	Normalized y coordinate on active display area where the user is looking.

Returns: A TobiiResearchStatus code.

Examples:: calibration.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_screen_based_calibration_compute_and_apply	(	TobiiResearchEyeTracker *	eyetracker,
		TobiiResearchCalibrationResult **	result
	)

Uses the collected data and tries to compute calibration parameters.

If the calculation is successful, the result is applied to the eye tracker. If there is insufficient data to compute a new calibration or if the collected data is not good enough then calibration is failed and will not be applied.

Parameters

eyetracker	Eye tracker object.
result	Represents the result of the calculated calibration.

Returns: A TobiiResearchStatus code.

Examples:: calibration.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_screen_based_calibration_discard_data	(	TobiiResearchEyeTracker *	eyetracker,
		float	x,
		float	y
	)

Removes the collected data associated with a specific calibration point.

Parameters

eyetracker	Eye tracker object.
x	Normalized x coordinate of point to discard.
y	Normalized y coordinate of point to discard.

Returns: A TobiiResearchStatus code.

Examples:: calibration.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_screen_based_calibration_enter_calibration_mode ( TobiiResearchEyeTracker * eyetracker )

Enters the screen based calibration mode and the eye tracker is made ready for collecting data and calculating new calibrations.

    /* Enter calibration mode. */
    TobiiResearchStatus status = tobii_research_screen_based_calibration_enter_calibration_mode(eyetracker);
    char* serial_number;
    tobii_research_get_serial_number(eyetracker, &serial_number);
    printf("Entered calibration mode for eye tracker with serial number %s \n.", serial_number);
    tobii_research_free_string(serial_number);

Parameters

eyetracker Eye tracker object.

Returns: A TobiiResearchStatus code.

Examples:: calibration.c, and notifications.c.

TOBII_RESEARCH_API TobiiResearchStatus TOBII_RESEARCH_CALL tobii_research_screen_based_calibration_leave_calibration_mode ( TobiiResearchEyeTracker * eyetracker )

Leaves the screen based calibration mode.

    /* The calibration is done. Leave calibration mode. */
    status = tobii_research_screen_based_calibration_leave_calibration_mode(eyetracker);
    printf("Left calibration mode.\n");

Parameters

eyetracker Eye tracker object.

Returns: A TobiiResearchStatus code.

Examples:: calibration.c, and notifications.c.

Data Structures

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

Function Documentation