SR-ResearchDemos

>Psychtoolbox>PsychHardware>EyelinkToolbox>EyelinkDemos>SR-ResearchDemos

EyeLink systems allow for rich integration between a Display PC (the computer running Psychtoolbox) and the EyeLink Host PC via an ethernet connection using the EyeLink application programming interface (API). The API can be installed by downloading the EyeLink Developers Kit from our Support site:

https://https://www.sr-support.com/thread-13.html

You will also need to configure your Display PC network settings. See this link for more details:

https://https://www.sr-support.com/thread-58.html

Psychtoolbox interfaces with the EyeLink API via the 'Eyelink Toolbox' which can be found in the Psychtoolbox root folder > PsychHardware. You can add EyeLink integration code to your own Psychtoolbox script to interact with the Host PC so your experiment can:

• initialize an EyeLink connection
• open an EyeLink data file (edf) on the Host PC and name it
• set some EyeLink-specific parameters /change various default options
• put Host PC in 'Camera Setup' mode and allow for:
  • transfer of eye image to Display PC for ease of participant setup
  • presentation of targets on Display PC monitor for participant calibration / validation
• transfer text, image and/or other graphics to the Host PC at the beginning of each trial for experimenter feedback
• do a drift-check / correction
• start recording eye movement data at the beginning of each trial (or block)
• during a trial write messages in the edf file to mark time of events
• write messages in the edf file for rich integration with Data Viewer
• stop recording at the end of each trial (or block)
• towards the end of a session close the edf and transfer a copy to the Display PC

• close the EyeLink connection

  EyeLink integration also allows for online access of eye movement data for gaze-contingent experiments.

  In a typical task eye movements are recorded onto the EyeLink Host PC on a trial-by-trial basis: recording starts at the beginning of a trial and ends at the end of a trial. This allows for an optional drift-check/correction and for transferring of images to the Host PC between trials. However this trial-based recording might not be suitable for paradigms that require a fixed ITI. In such cases it is possible to record continuously throughout a block or session.

The following is a list of Psychtoolbox demos with EyeLink integration that are included with the EyeLink Toolbox:

SimplePicture > Eyelink_SimplePicture.m

A simple EyeLink integration demo that records eye movements while an image is presented on the screen. Each trial ends when the space bar or a button is pressed.