Psychtoolbox>Eyelink.{mex*} subfunction

[sample, raw] = Eyelink(‘NewestFloatSampleRaw’ [, eye])

Same as Eyelink(‘NewestFloatSample’) but additionally returns raw sample data.
Specify the eye for which raw values are desired as LEFT_EYE or RIGHT_EYE as
returned by EyelinkInitDefaults. Omission of this argument is deprecated.
Normal samples do not contain the corneal reflection data, but some
(non-saccade-based) calibration methods require this information.
The Eyelink 1000 can be configured to send this information as part of ‘raw’
samples.
Sol Simpson at SR-Research emphasizes that this is not officially supported or
guaranteed.

1. You may need to install Eyelink.dll from the latest software developer kit at
   https://www.sr-support.com/forums/showthread.php?t=6 (windows) or
   https://www.sr-support.com/forums/showthread.php?t=15 (osx)
2. Issue the commands:
   Eyelink(‘command’,’link_sample_data =
   LEFT,RIGHT,GAZE,AREA,GAZERES,HREF,PUPIL,STATUS,INPUT,HMARKER’);
   Eyelink(‘command’,’inputword_is_window = ON’);
   More info:
   HMARKER (originally for Eyelink2’s infrared head tracking markers) and INPUT
   (originally for the TTL lines) are jury-rigged to hold the extra data.
   You can also set file_sample_data to collect raw samples in the .edf file.
   Raw structure fields:
   raw_pupil raw x, y sensor position of the pupil
   raw_cr raw x, y sensor position of the corneal reflection
   pupil_area raw pupil area
   cr_area raw cornela reflection area
   pupil_dimension width, height of raw pupil
   cr_dimension width, height of raw cr
   window_position x, y position of tracking window on sensor
   pupil_cr calculated pupil-cr from the raw_pupil and raw_cr fields
   cr_area2 raw area of 2nd corneal reflection candidate
   raw_cr2 raw x, y sensor position of 2nd corneal reflection
   candidate
   CAUTION: It may or may not work on your setup with your tracker.

###See also: